Pochta Russia MCP server

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

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

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

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

Claude Desktop / Cursor / Windsurf (stdio)

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

Claude Code

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

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}

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

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

Авторизация

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

• Authorization: AccessToken — access-токен приложения;
• X-User-Authorization: Basic — учётные данные кабинета.

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

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

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

для X-User-Authorization).

• Было: POCHTATOKEN + POCHTAKEY. Этот набор больше не работает сам по себе.
• Стало: POCHTATOKEN + POCHTALOGIN + POCHTA_PASSWORD.
• POCHTA_KEY сохранён только как опциональный back-compat (готовый base64(login:password)

Надёжность

Shortened. The full README is on GitHub.