pochta-russia-mcp

MCP-сервер для API Почты России — отслеживание, расчёт тарифов, сроки доставки, поиск отделений, индексы, нормализация адресов.

| Инструмент | Описание | |---|---| | track | Отслеживание отправления по трек-номеру | | calculate | Расчёт стоимости и сроков доставки | | delivery_time | Расчёт сроков доставки между индексами | | get_offices | Поиск почтовых отделений | | zip_lookup | Информация по почтовому индексу | | normalize_address | Нормализация адреса через API |

{
  "mcpServers": {
    "pochta": {
      "command": "npx",
      "args": ["-y", "@theyahia/pochta-russia-mcp"],
      "env": {
        "POCHTA_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "POCHTA_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

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

MCP endpoint: http://localhost:3000/mcp Health check: http://localhost:3000/health

| Переменная | Обязательная | Описание | |---|---|---| | POCHTA_TOKEN | Да | Access-токен для X-User-Authorization | | POCHTA_KEY | Да | API-ключ (Authorization header) |

Также поддерживаются legacy-переменные:

| Переменная | Описание | |---|---| | POCHTA_LOGIN | Логин от API (формирует Basic auth) | | POCHTA_PASSWORD | Пароль от API | | POCHTA_TOKEN | Access-токен |

Получите ключи: Кабинет отправителя -> Настройки -> API.

Сервер использует двойную авторизацию Почты России:

• Authorization: API-ключ (POCHTA_KEY) или Basic auth (из POCHTA_LOGIN/PASSWORD)
• X-User-Authorization: accessToken <POCHTA_TOKEN>

Отслеживание использует SOAP API трекинга Почты России (login/password).

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