Yango Tech Retail MCP

Yango Tech Retail MCP

English | Русский

A1 Yango Tech Retail MCP connects an AI app to a retailer account in Yango Tech Retail. Use ordinary language to check stores, orders, products, prices and stock, or to create orders and update account data when needed.

The server works with the retailer-facing B2B API for grocery retail and darkstores. It is not a marketplace seller portal, a taxi service or Yango Delivery.

• 16 tools. Nine read-only tools, five write tools and two potentially destructive tools cover stores, catalog, pricing, stock, orders and receipts.
• A safe read-only start. Check connected data before changing anything in the account.
• Clear write boundaries. Order creation and cancellation, product upserts, price changes, discount creation and stock updates are separated from reads.
• Additional API coverage. Technical users can reach methods without a dedicated tool through raw_request.

Start with:

List our stores and show the stock of product [product ID] in each.

Connect the server · Explore use cases · Open technical documentation

---

See it work in a minute

You: List our stores and show the stock of product [product ID] in each.

Assistant: I will return the stores, their ids and the current stock of this product in each one.

You: Show the price of this product in every price list.

Assistant: I will return the price lists and the current product price in each one. No account data will be changed.

You: Change the price to 99.90 in price list [price-list ID].

Assistant: This will change a real customer-facing price. I will show the product, price list, current value and new value before asking for confirmation.

You: Confirm.

Assistant: The price has been updated. I will read the price list again and return the current value.

Stores, products, prices, stock and order states always come from the connected retailer account and the current API response.

Contents

• Quick start
• What you can ask it to do
• How retail data is connected
• What changes in the account
• Getting access
• Configuration
• Data and telemetry
• Limits and background work
• Technical documentation
• Support

Quick start

You need Node.js 20+, a Yango Tech Retail account and a retailer Bearer token.

1. Get a token from your Yango Tech integration manager.
2. Add the server to your AI app using one of the instructions below.
3. Start with a read-only request:

List our stores and show the stock of product [product ID] in each.

Codex

In the app:

1. Open Settings → MCP servers.
2. Select Add server.
3. Choose STDIO, then enter the launch command npx -y mcp-yango-retail@latest and the YANGO_RETAIL_TOKEN environment variable with your token.

1. Select Save, then Restart.

From the command line:

codex mcp add yango-retail \

--env YANGO_RETAIL_TOKEN=your_token \ -- npx -y mcp-yango-retail@latest

Check the connection:

codex mcp list

Codex MCP documentation

Claude Code

claude mcp add \

--env YANGO_RETAIL_TOKEN=your_token \ --transport stdio \ --scope user \ yango-retail \ -- npx -y mcp-yango-retail@latest

Check the connection:

claude mcp list

Claude Code MCP documentation

Claude Desktop

The current official path is Settings → Extensions. For a custom desktop extension, open Advanced settings → Extension Developer → Install Extension…, select a .mcpb file and follow the prompts.

This repository currently publishes an npm stdio package and does not contain a .mcpb bundle. For Claude Desktop builds that still support local configuration, use the following JSON stdio configuration as a fallback:

{

"mcpServers": { "yango-retail": { "command": "npx", "args": ["-y", "mcp-yango-retail@latest"], "env": { "YANGO_RETAIL_TOKEN": "your_token" } } } }

In those builds, save it to ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows.

Claude Desktop MCP documentation

Cursor

Add a user-level server to ~/.cursor/mcp.json on macOS/Linux or %USERPROFILE%\.cursor\mcp.json on Windows:

{

"mcpServers": { "yango-retail": { "type": "stdio", "command": "npx", "args": ["-y", "mcp-yango-retail@latest"], "env": { "YANGO_RETAIL_TOKEN": "your_token" } } } }

Cursor MCP documentation

VS Code

Run MCP: Open User Configuration from the Command Palette and add:

{

"servers": { "yango-retail": { "type": "stdio", "command": "npx", "args": ["-y", "mcp-yango-retail@latest"], "env": { "YANGO_RETAIL_TOKEN": "${input:yango_retail_token}" } } }, "inputs": [ { "type": "promptString", "id": "yango_retail_token", "description": "Yango Tech Retail Bearer token", "password": true } ] }

Check the server with MCP: List Servers.

VS Code MCP documentation

What you can ask it to do

Check stores and the product catalog

• List stores with their ids, status, location, address and name when available.
• Browse products by cursor and inspect their status, category, localized names, barcodes and custom attributes.
• Create or update up to 100 products in one request. Product records are upserted rather than added as duplicates.

Check and update prices

• List price lists and read product prices from one or more lists.
• Compare the same product across price lists.
• Set up to 100 prices in one request using decimal strings such as "150.00".
• Create up to 100 store-specific discounts after confirming the expected field structure with Yango Tech.

Check and update stock

• Read stock across stores, including the product, quantity and shelf type.
• Update up to 1,000 stock lines for one store.
• Use initialize for the first stock load and modify for regular updates.

Work with orders and receipts

• Create an order after collecting its store, products, quantities, prices, delivery details and payment type.
• Read order details and check the current states of several orders at once.
• Follow the order event feed for new orders, state changes and issued receipts.
• Read a fiscal receipt by order id or receipt id.
• Cancel an order after checking its current state and the cancellation reason.

Use additional API methods

raw_request covers /b2b/v1/* methods without a dedicated tool, including order updates, VAT data, price-list links, picking, logistics and 3PL delivery operations. It can change real account data and is intended for technical users who understand the upstream API.

Complete schemas, response fields and API gaps are available in the tool reference.

How retail data is connected

Feeds use cursor pagination. A page with fewer items than the requested limit means the current product, price-list or stock feed is exhausted. The order event feed is continuous: keep its last cursor and request the next page later.

What changes in the account

The server exposes MCP annotations for read-only, write and destructive actions. The AI client decides when and how to ask for confirmation.

Before a write, ask the assistant to show the target store, product ids, price list, quantities, current values and proposed values. Write responses are not fully documented upstream, so after a successful price or stock update the server can read the corresponding data again and show the current value.

Getting access

Yango Tech issues a Bearer token for a retailer account through an integration manager. This repository does not describe a self-service token portal.

1. Contact your Yango Tech integration manager and request a retailer Bearer token.
2. Add it to the AI client as YANGO_RETAIL_TOKEN.
3. Keep it out of Git and share it only through the AI client's secret or environment-variable configuration.

The production API host is https://api.retailtech.yango.com. Every API call is a POST with a JSON body under /b2b/v1/*, including read operations.

The token is stored in the AI client's local configuration. Treat it like a password and never commit a configuration containing a real token.

Configuration

Data and telemetry

Requests to Yango Tech Retail

The server runs on your machine and sends retailer data directly to th