pochta-russia-mcp
MCP-сервер для Почты России — отслеживание посылок и расчёт доставки через ИИ
Если вы искали, как отследить отправление Почты России по трек-номеру из чата, посчитать тариф и срок доставки или найти индекс и ближайшее отделение — это оно. 6 инструментов: трекинг, расчёт стоимости и сроков, поиск отделений, индексы, нормализация адресов. Спрашиваете «где посылка 12345678901234» — получаете статус, а не страницу с капчей.
Возможности (6 инструментов)
Инструмент | Описание | Что требуется |
| Отслеживание отправления по трек-номеру |
|
| Расчёт стоимости и сроков доставки |
|
| Расчёт сроков доставки между индексами |
|
| Поиск почтовых отделений |
|
| Информация по почтовому индексу |
|
| Нормализация адреса через API |
|
Related MCP server: PostEx MCP Server
Быстрый старт
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-mcpStreamable HTTP
npx @theyahia/pochta-russia-mcp --http --port=3000MCP endpoint: http://localhost:3000/mcp
Health check: http://localhost:3000/health → {"status":"ok","version":"…","tools":6}
Переменные окружения
Переменная | Обязательная | Описание |
| Да | Access-токен приложения → заголовок |
| Да | Логин кабинета → часть |
| Да | Пароль кабинета → часть |
| Нет | Back-compat: готовый |
| Нет | Таймаут запроса в мс (по умолчанию 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)
Команда | Описание |
| Отследить посылку Почты России |
| Расчёт стоимости отправления |
| Полный расчёт с ближайшим отделением |
Тесты
npm install
npm run typecheck
npm testЛицензия
MIT
Telegram: @vhodvai
Available Tools
6 toolscalculateC
Расчёт стоимости и сроков доставки Почтой России.
Inputs: weight (required), to_index (required), from_index (required), mail_type, +3 more.
delivery_timeB
Расчёт сроков доставки между двумя индексами.
Inputs: to_index (required), from_index (required), mail_type, mail_category.
get_officesB
Поиск почтовых отделений по индексу или населённому пункту.
Inputs: top, region, settlement, postal_code.
normalize_addressB
Нормализация адреса через API Почты России.
Inputs: raw_address (required).
trackA
Отслеживание почтового отправления Почты России по трек-номеру.
Inputs: barcode (required).
zip_lookupA
Информация по почтовому индексу: регион, город, график работы.
Inputs: postal_code (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have clear, distinct purposes: tracking, zip info, cost/delivery calculation, office search, delivery time, and address normalization. The only minor overlap is between 'calculate' (cost + delivery time) and 'delivery_time' (time only), but their descriptions clarify the difference.
All tool names follow a consistent lowercase_with_underscores pattern. While some are verbs (track, calculate, get) and others are noun-based (zip_lookup, delivery_time, normalize_address), the style is uniform and predictable, making it easy to guess functionality.
With 6 tools, the server is well-scoped for the Russian Post domain. Each tool addresses a distinct need—tracking, zip lookup, cost calculation, office search, delivery time, and address normalization—without excess or shortage.
The tool set covers the primary operations for Russian Post services, including tracking, address validation, cost/time estimation, and office lookup. Minor gaps exist, such as batch operations or detailed shipment history, but the core workflows are fully supported.
Maintenance
Related MCP Connectors
Track shipments and search shipping products (DPD, InPost, DHL, FedEx, UPS, GLS) via GlobKurier API.
MCP server for EasyPost — rate shipments, buy & refund labels, track packages, verify addresses.
Brazil's Correios for AI agents: shipping quotes (frete), tracking (rastreio) and labels (etiqueta).
Russian APIs for AI agents: YooKassa, CDEK, Bitrix24 and more. Ready scenarios with code. No key.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides tools for web, image, generative search, and Wordstat keyword statistics via Yandex Search API.717 npm1MIT
- AlicenseNot gradedqualityDmaintenanceProvides tools to interact with the PostEx Merchant API for order creation, tracking, and management.2ISC
- AlicenseBqualityDmaintenanceIntegrates with CDEK delivery API to manage orders, track shipments, find pickup points, and handle delivery labels and barcodes through natural language.49MIT
- AlicenseAqualityFmaintenanceEnables integration with Boxberry delivery services, allowing users to search cities and pickup points, calculate delivery costs and times, track shipments, check postal indexes, and list services.652 npmMIT