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 mcp add yango-retail \
  --env YANGO_RETAIL_TOKEN=your_token \
  -- npx -y mcp-yango-retail@latest

codex mcp list

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

claude mcp list

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

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

{
  "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
    }
  ]
}

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.