About io.github.theYahia/pochta-russia-mcp
io.github.theYahia/pochta-russia-mcp is an MCP server in the Search category: mCP server for Russian Post (Почта России) API — tracking, tariff calculation, post office search.
Install
claude mcp add io-github-theyahia-pochta-russia-mcp -- npx -y @theyahia/pochta-russia-mcpnpx -y @theyahia/pochta-russia-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about io.github.theYahia/pochta-russia-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
pochta-russia-mcp
MCP-сервер для API Почты России — отслеживание, расчёт тарифов, сроки доставки, поиск отделений, индексы, нормализация адресов.
Возможности (6 инструментов)
| Инструмент | Описание |
|---|---|
track |
Отслеживание отправления по трек-номеру |
calculate |
Расчёт стоимости и сроков доставки |
delivery_time |
Расчёт сроков доставки между индексами |
get_offices |
Поиск почтовых отделений |
zip_lookup |
Информация по почтовому индексу |
normalize_address |
Нормализация адреса через API |
Быстрый старт
Stdio (по умолчанию)
{
"mcpServers": {
"pochta": {
"command": "npx",
"args": ["-y", "@theyahia/pochta-russia-mcp"],
"env": {
"POCHTA_TOKEN": "<YOUR_ACCESS_TOKEN>",
"POCHTA_KEY": "<YOUR_API_KEY>"
}
}
}
}
Streamable HTTP
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).
Skills (Claude Code)
| Команда | Описание |
|---|---|
/track <номер> |
Отследить посылку Почты России |
/calculate <от> <до> <вес> |
Расчёт стоимости отправления |
/parcel <от> <до> <вес> |
Полный расчёт с ближайшим отделением |
Тесты
npm test
Лицензия
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.