SkillFoxx

Russian Post MCP server

pochta-russia-mcp

An MCP server for Russian Post: parcel tracking by number, shipping cost and time calculation, post office search and address normalization

  • 1 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Needs the Russian Post sender account login and password plus a token
  • Tracking and address normalization handle recipient data
  • Does not create or change shipments
All reasons and checks
Russian stack

theyahia/pochta-russia-mcpAuthor:theYahia

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/pochta-russia-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Needs the Russian Post sender account login and password plus a token
  • Tracking and address normalization handle recipient data
  • Does not create or change shipments

This is third-party code. Review the repository files before installing.

What it does

A TypeScript server exposes 6 tools on top of the Russian Post API: track for parcel tracking via the SOAP tracking API, calculate and delivery_time for shipping cost and time estimates, get_offices for post office search, zip_lookup for postal code lookups, and normalize_address for address normalization. It is published to npm as @theyahia/pochta-russia-mcp and runs via npx over stdio or as a Streamable HTTP server on its own port. otpravka-api REST methods need both an application access token and the account login and password together; tracking works with login and password only, through a separate SOAP API.

Who it is for. For online stores and senders who calculate Russian Post shipping and track parcels from a chat with an agent.

Good fit when

  • You need parcel status by tracking number without a CAPTCHA-gated website
  • You need to calculate cost and time between two postal codes
  • You need to find the nearest post office or normalize a recipient's address

Not a fit when

  • You need to create and register shipments, not just calculate and track them: the server has no such tools
  • You have no access to a sender account at otpravka.pochta.ru: without it there is no token or password to use

Example request

Where is parcel 12345678901234 right now and how much longer will it take to reach Novosibirsk

MCP

Transport
stdio, http
Authentication
API key

Environment variables

POCHTA_TOKEN required, secret
Application access token for otpravka-api REST methods
POCHTA_LOGIN required, secret
Sender account login
POCHTA_PASSWORD required, secret
Sender account password

Limitations

It needs three parameters at once: POCHTA_TOKEN, POCHTA_LOGIN and POCHTA_PASSWORD, obtainable only through a sender account at otpravka.pochta.ru. Version 2.0.0 changes the auth contract, so the old POCHTA_TOKEN plus POCHTA_KEY pair no longer works alone. The same functionality also exists inside the author's wwmcp monorepo alongside dozens of other Russian services; this is a separate single-package build of the same codebase.

How to disable. Remove the pochta server from your MCP client settings, for example claude mcp remove pochta.

FAQ

Is login and password alone enough, without a token?

For tracking (the SOAP API) yes; cost calculation, office search and address normalization also need POCHTA_TOKEN.

What changed in version 2.0.0?

Earlier versions built the auth headers incorrectly, so REST methods failed authorization. Now it uses POCHTA_TOKEN plus POCHTA_LOGIN and POCHTA_PASSWORD, and the old POCHTA_KEY remains optional for backward compatibility.

Discussion

No questions or reviews yet.

MCP servers
Russian stack

A remote MCP with pay-per-call USDC pricing: INN company checks, Runet search, Russian Post tracking, CBR and MOEX rates

MCP serverBroad access1
Russian stack

A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data

MCP serverBroad access38
Russian stack

An MCP server for the SMS.RU sending service: sending SMS, delivery checks, balance and cost estimates

MCP serverExtended access
Russian stack

Local MCP server for product search, cart and delivery with Pyaterochka

MCP serverBroad access4

MCP for Yandex Delivery

A1 Яндекс Доставка MCP

Russian stack

MCP server for Yandex Delivery B2B API: cost calculation, order placement, and tracking for same-day and next-day deliveries across Russia

MCP serverBroad access
Official

The official Postmark MCP server: 24 tools to send email, manage templates, search messages and diagnose delivery.

MCP serverBroad access64

README in short

The README lists the 6 tools in a table with the variables each needs, explains the difference between otpravka-api REST auth via two headers and the separate SOAP tracking API, describes the 2.0.0 breaking change, shows configs for Claude Desktop, Cursor, Windsurf and Claude Code, the Streamable HTTP mode with a health check, and three ready Claude Code skills: /track, /calculate, /parcel.

README badge

Report a problem