A1-x-Tech/mcp-yango-retail

**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.
4. Select **Save**, then **Restart**.
**From the command line:**
Check the connection:
Codex MCP documentation
Claude Code
Check the connection:
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:
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:
Cursor MCP documentation
VS Code
Run **MCP: Open User Configuration** from the Command Palette and add:
Check the server with **MCP: List Servers**.
VS Code MCP documentation
What you can ask it to do