MCP server for Russian Post (Почта России) API — tracking, tariff calculation, post office search.
MCPpedia last refreshed this data
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"pochta": {
"env": {
"POCHTA_KEY": "<YOUR_API_KEY>",
"POCHTA_TOKEN": "<YOUR_ACCESS_TOKEN>"
},
"args": [
"-y",
"@theyahia/pochta-russia-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
MCP-сервер для API Почты России — отслеживание, расчёт тарифов, сроки доставки, поиск отделений, индексы, нормализация адресов.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@theyahia/pochta-russia-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked @theyahia/pochta-russia-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in other
Pi Coding Agent extension (CLI-first) — routes bash/read/grep/find/ls through lean-ctx CLI for strong token savings. Optional MCP bridge can register advanced tools.
Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 60-95% fewer tokens, same answers. Library, proxy, MCP server.
97% token reduction for AI coding sessions — zero deps, 21 languages, MCP server
App framework, testing framework, and inspector for MCP Apps.
MCP Security Weekly
Get CVE alerts and security updates for io.github.theYahia/pochta-russia-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
MCP-сервер для API Почты России — отслеживание, расчёт тарифов, сроки доставки, поиск отделений, индексы, нормализация адресов.
| Инструмент | Описание | Что требуется |
|---|---|---|
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 |
{
"mcpServers": {
"pochta": {
"command": "npx",
"args": ["-y", "@theyahia/pochta-russia-mcp"],
"env": {
"POCHTA_TOKEN": "<ACCESS_TOKEN>",
"POCHTA_LOGIN": "<LOGIN>",
"POCHTA_PASSWORD": "<PASSWORD>"
}
}
}
}
claude mcp add pochta \
-e POCHTA_TOKEN=<ACCESS_TOKEN> \
-e POCHTA_LOGIN=<LOGIN> \
-e POCHTA_PASSWORD=<PASSWORD> \
-- npx -y @theyahia/pochta-russia-mcp
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-токен там не применяется).
В версиях ≤ 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).429 и 5xx.POCHTA_TIMEOUT_MS).stderr (канал stdout занят MCP).| Команда | Описание |
|---|---|
| `/tra |