Pochta Russia MCP
MCP server for Russian Post (Почта России) API — tracking, tariff calculation, post office search.
Install Pochta Russia MCP
Pick your client, then add it in one click or paste the config.
~/Library/Application Support/Claude/claude_desktop_config.json{
"mcpServers": {
"pochta-russia-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/pochta-russia-mcp"
]
}
}
}
Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.
Automated check passed— started and listed 6 tools correctly (13d ago).
Overview
Tools6
What Pochta Russia MCP lets your agent do. Expand a tool for its parameters.
Security & health
What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.
Recent health check succeeded.
What it can do
From the 6 tools this server returned when we ran it.
Observed 2026-10-22 in an isolated sandbox. A description of reach, not a security audit.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Scanned 3d ago via OSV.dev · @theyahia/pochta-russia-mcp (npm)
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
From the project README
MCP-сервер для Почты России — отслеживание посылок и расчёт доставки через ИИ
Если вы искали, как отследить отправление Почты России по трек-номеру из чата, посчитать тариф и срок доставки или найти индекс и ближайшее отделение — это оно. 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 | Нормализация адреса через API | POCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD |
Быстрый старт
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}
Переменные окружения
| Переменная | Обязательная | Описание |
|---|---|---|
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 <от> <до> <вес> | Полный расчёт с ближайшим отделением |
Тесты
npm install
npm run typecheck
npm test
Лицензия
MIT
Telegram: @vhodvai
Reviews
No reviews yet — be the first to share how it worked for you.
Frequently Asked Questions about Pochta Russia MCP
Related MCP servers
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/pochta-russia-mcp)<a href="https://allmcps.com/mcp/pochta-russia-mcp"><img src="https://allmcps.com/api/badge/pochta-russia-mcp?style=directory" alt="Pochta Russia MCP on AllMCPs" /></a>