A1-x-Tech/mcp-yango-delivery

**English** | Русский
**A1 Yango Delivery MCP** connects an AI app to a corporate Yango Delivery account. Estimate an express delivery, order a courier, track the route and share a tracking link with the recipient using ordinary language.
This server works with the international Express Claims API. It does not support next-day delivery, pickup points or parcel lockers.
- **13 tools.** Seven for the delivery lifecycle, five for tracking and courier contact, plus one direct API request tool.
- **Estimate before ordering.** Check the current price, route distance and ETA without creating a delivery claim.
- **Create and order separately.** A claim can be prepared and reviewed before courier search starts.
- **Follow an active delivery.** Get its status, courier position, point ETAs, temporary phone number, confirmation code and recipient tracking link.
Start with:
> Estimate delivery of a 2 kg parcel from [pickup address] to [delivery address].
Connect the server · Explore use cases · Open technical documentation
---
See it work in a minute
> **You:** Estimate delivery of a 2 kg parcel from our warehouse to the customer's address.
>
> **Assistant:** I returned the current price, route distance and ETA. No delivery claim was created.
>
> **You:** Create the claim and stop before ordering the courier.
>
> **Assistant:** The claim has been created. I will show its id, price, status and version before acceptance.
>
> **You:** Accept the offer.
>
> **Assistant:** The claim has been accepted and courier search has started.
>
> **You:** Send me the recipient's tracking link.
>
> **Assistant:** I returned the public tracking link for the destination.
> Price, availability, status and cancellation terms always come from the connected delivery account and the current API response.
Contents
- Quick start
- What you can ask it to do
- How a delivery becomes real
- 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 Delivery corporate account and an integration token.
1. Get an integration token.
2. Add the server to your AI app using one of the instructions below.
3. Start with a price estimate:
> Estimate delivery of a 2 kg parcel from [pickup address] to [delivery address].
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-delivery@latest and the YANGO_DELIVERY_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
Estimate an express delivery
- Calculate the current price, route distance and ETA without creating a claim.