Yango Delivery MCP

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

codex mcp list

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

claude mcp list

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

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

{
  "servers": {
    "yango-delivery": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yango-delivery@latest"],
      "env": {
        "YANGO_DELIVERY_TOKEN": "${input:yango_delivery_token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "yango_delivery_token",
      "description": "Yango Delivery integration token",
      "password": true
    }
  ]
}

What you can ask it to do

Estimate an express delivery

• Calculate the current price, route distance and ETA without creating a claim.
• Estimate courier, express or cargo service for the supplied addresses, weight and dimensions.
• Check whether the API can build the route and satisfy the requested vehicle or delivery requirements.

Prepare and order a courier

• Create a claim with sender and recipient contacts, route points, items and delivery requirements.
• Review the returned price, status and claim version before ordering.
• Accept a claim after successful estimation and start courier search.
• Find a claim by id, phone number, status, date or external order id.

Track the delivery and contact the courier

• Get the current courier position and ETA for each route point.
• Generate a public tracking link for the recipient.
• Get a temporary forwarded phone number for the courier.
• Get a pickup or delivery confirmation code when the current claim supports one.

Check and cancel a delivery

• Check whether cancellation is free, paid or no longer available.
• Cancel a claim using its current version and the cancellation mode returned by the API.

Use additional API methods

raw_request covers methods without a dedicated tool, including tariffs, delivery methods, proof of delivery, claim editing and return operations. It can create or change real data, so it is intended for technical users who understand the upstream API.

Complete schemas, response fields and status details are available in the tool reference.

How a delivery becomes real

1. Estimate. A price check returns the current offer, distance and ETA without creating anything.
2. Create. A claim is added to the account and moves through estimation. By default, no courier is ordered yet.
3. Review. Read the latest claim status, price and version. A successful claim becomes ready for approval.
4. Accept. Acceptance starts courier search. From this point, the delivery is ordered and can lead to a real charge.
5. Track. Once a courier is assigned, the server can return the position, ETA, contact details and recipient link.

The priced offer usually expires about ten minutes after estimation. If auto_accept: true is passed when creating a claim, the separate review and acceptance step is skipped and the courier can be ordered automatically.

What changes in the account

The server exposes MCP annotations for reading, writing and destructive actions. The AI client decides when and how to ask for confirmation.

Claim creation uses a unique request_id, so repeating it with the same id returns the same claim. Acceptance and cancellation are not automatically repeated after a network error or a 5xx response because the operation may already have succeeded. Read the current claim before trying again.

Getting access