Pochta Russia Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.1Updated Oct 24, 2026

MCP server for Russian Post (Почта России) API — tracking, tariff calculation, post office search.

VerifiedSTDIODesktop onlyLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

MCP server for Russian Post: track parcels, calculate delivery cost and time, find post offices and look up postal codes from chat.

What you can do
  • Track shipments by tracking number and get status updates
  • Calculate delivery cost and time between postal codes
  • Find post offices and look up information for a postal code
  • Normalize addresses through the Russian Post API
When to use it
Useful when you work with Russian Post shipments and want to check where a parcel is, estimate shipping cost and delivery time, or find the nearest post office and postal code without filling in web forms.
Requirements
Runs locally via npx (Node.js) over stdio, or as a local HTTP endpoint with a port flag. Needs Russian Post sender-account API access and the environment variables POCHTA_TOKEN, POCHTA_LOGIN and POCHTA_PASSWORD; POCHTA_KEY and POCHTA_TIMEOUT_MS are optional. Network access to Russian Post services is required.
Before you install
Requires your Russian Post account credentials: the access token, login and password are passed as environment variables, and the login and password are combined into a Basic authorization header. Tracking uses a separate SOAP service with the same login and password. Requests and address data go to Russian Post servers. Version 2.0.0 changed the credential scheme, so older token-plus-key setups no longer work.

Installation

In SourceWeft

  1. Open Pochta Russia Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

MCP-сервер для Почты России — отслеживание посылок и расчёт доставки через ИИ

[npm] [CI] [License: MIT]

Если вы искали, как отследить отправление Почты России по трек-номеру из чата, посчитать тариф и срок доставки или найти индекс и ближайшее отделение — это оно. 6 инструментов: трекинг, расчёт стоимости и сроков, поиск отделений, индексы, нормализация адресов. Спрашиваете «где посылка 12345678901234» — получаете статус, а не страницу с капчей.

Возможности (6 инструментов)

ИнструментОписаниеЧто требуется
trackОтслеживание отправления по трек-номеруPOCHTA_LOGIN + POCHTA_PASSWORD (SOAP-трекинг)
calculateРасчёт стоимости и сроков доставкиPOCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD
delivery_timeРасчёт сроков доставки между индексамиPOCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD
get_officesПоиск почтовых отделенийPOCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD
zip_lookupИнформация по почтовому индексуPOCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD
normalize_addressНормализация адреса через APIPOCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD

Быстрый старт

Claude Desktop / Cursor / Windsurf (stdio)

json
{  "mcpServers": {    "pochta": {      "command": "npx",      "args": ["-y", "@theyahia/pochta-russia-mcp"],      "env": {        "POCHTA_TOKEN": "<ACCESS_TOKEN>",        "POCHTA_LOGIN": "<LOGIN>",        "POCHTA_PASSWORD": "<PASSWORD>"      }    }  }}

Claude Code

bash
claude mcp add pochta \  -e POCHTA_TOKEN=<ACCESS_TOKEN> \  -e POCHTA_LOGIN=<LOGIN> \  -e POCHTA_PASSWORD=<PASSWORD> \  -- npx -y @theyahia/pochta-russia-mcp

Streamable HTTP

bash
npx @theyahia/pochta-russia-mcp --http --port=3000

MCP endpoint: http://localhost:3000/mcp Health check: http://localhost:3000/health → {"status":"ok","version":"…","tools":6}

Переменные окружения

ПеременнаяОбязательнаяОписание
POCHTA_TOKENДаAccess-токен приложения → заголовок Authorization: AccessToken …
POCHTA_LOGINДаЛогин кабинета → часть X-User-Authorization: Basic …
POCHTA_PASSWORDДаПароль кабинета → часть X-User-Authorization: Basic …
POCHTA_KEYНетBack-compat: готовый base64(login:password) для X-User-Authorization (вместо LOGIN/PASSWORD)
POCHTA_TIMEOUT_MSНетТаймаут запроса в мс (по умолчанию 15000)

Получите доступ к API: Кабинет отправителя → Настройки → API. Спецификация: https://otpravka.pochta.ru/specification.

Авторизация

REST-методы otpravka-api используют два заголовка (согласно официальной спецификации):

  • Authorization: AccessToken <POCHTA_TOKEN> — access-токен приложения;
  • X-User-Authorization: Basic <base64(POCHTA_LOGIN:POCHTA_PASSWORD)> — учётные данные кабинета.

Отслеживание (track) использует SOAP-API трекинга (tracking.russianpost.ru) и требует POCHTA_LOGIN + POCHTA_PASSWORD (access-токен там не применяется).

⚠️ Миграция на 2.0.0 (breaking change)

В версиях ≤ 1.x заголовки авторизации формировались неверно (access-токен и ключ были перепутаны местами), из-за чего REST-методы не проходили авторизацию. В 2.0.0 контракт исправлен:

  • Было: POCHTA_TOKEN + POCHTA_KEY. Этот набор больше не работает сам по себе.
  • Стало: POCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD.
  • POCHTA_KEY сохранён только как опциональный back-compat (готовый base64(login:password) для X-User-Authorization).

Надёжность

  • Повторные попытки (до 3) с экспоненциальной задержкой на сетевые ошибки, 429 и 5xx.
  • Таймаут запроса (по умолчанию 15 с, настраивается через POCHTA_TIMEOUT_MS).
  • Диагностические логи ретраев/ошибок пишутся в stderr (канал stdout занят MCP).

Skills (Claude Code)

КомандаОписание
/track <номер>Отследить посылку Почты России
/calculate <от> <до> <вес>Расчёт стоимости отправления
/parcel <от> <до> <вес>Полный расчёт с ближайшим отделением

Тесты

bash
npm installnpm run typechecknpm test

Лицензия

MIT

Telegram: @vhodvai

Source: README.md at commit 26cae85

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts