About boxberry-mcp
boxberry-mcp is an MCP server for applications using the Boxberry delivery API. It provides lookup, delivery calculation, and tracking tools; the repository is archived and development has moved to theYahia/WWmcp.
Key features
- 01Search Boxberry cities
- 02Find pickup points by city
- 03Calculate delivery cost and time
- 04Track shipments by tracking number
- 05Check postcode coverage and shipment services
Use cases
- 01Finding a pickup point in a city
- 02Estimating a shipment's cost and delivery time
- 03Checking a parcel's tracking status
- 04Verifying postcode delivery coverage
MCP support
It exposes Boxberry API tools to MCP clients for city and pickup-point lookup, delivery estimates, tracking, postcode checks, and shipment service listings.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @theyahia/boxberry-mcpBOXBERRY_TOKENSecretAPI key for the serviceLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
4Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| search | string | No | Поиск по названию города (подстрока) |
Details
From the project README🗄 Репозиторий заархивирован
Разработка переехала в theYahia/WWmcp — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро
@theyahia/mcp-core, единый CI, единый релизный конвейер.Актуальная версия того, что лежало здесь:
servers/boxberry/Пакет в npm прежний —
@theyahia/boxberry-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.Archived — development moved to theYahia/WWmcp, a monorepo of MCP servers for non-Western APIs. The current version of this package now lives at
servers/boxberry/. The npm package@theyahia/boxberry-mcpis unchanged. Please open issues and pull requests there.
Boxberry MCP — расчёт доставки и пункты выдачи в диалоге с нейросетью
Если вы искали, как посчитать стоимость доставки Boxberry обычным вопросом, найти ближайший пункт выдачи в городе клиента или отследить посылку по трек-номеру не заходя в личный кабинет — это оно. 6 инструментов поверх API Boxberry: города, пункты выдачи, расчёт доставки, отслеживание, проверка индекса и список услуг.
Возможности (6 инструментов)
| Инструмент | Описание |
|---|---|
list_cities | Список городов Boxberry с поиском по названию |
list_points | Пункты выдачи в указанном городе |
calc_delivery | Расчёт стоимости и сроков доставки |
track | Отслеживание отправления по трек-номеру |
zip_check | Проверка почтового индекса на зону доставки |
list_services | Список оказанных услуг по отправлению |
Быстрый старт (stdio)
{
"mcpServers": {
"boxberry": {
"command": "npx",
"args": ["-y", "@theyahia/boxberry-mcp"],
"env": {
"BOXBERRY_API_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
HTTP-транспорт (Streamable HTTP)
BOXBERRY_API_TOKEN=<TOKEN> npx @theyahia/boxberry-mcp --http
# Endpoint: http://localhost:3000/mcp
# Health: http://localhost:3000/health
Порт настраивается через PORT:
PORT=8080 BOXBERRY_API_TOKEN=<TOKEN> npx @theyahia/boxberry-mcp --http
Smithery
Файл smithery.yaml включён. Требует BOXBERRY_API_TOKEN.
Переменные окружения
| Переменная | Обязательная | Описание |
|---|---|---|
BOXBERRY_API_TOKEN | Да | API-токен из личного кабинета Boxberry |
PORT | Нет | Порт для HTTP-транспорта (по умолчанию 3000) |
Skills (Claude Code)
| Skill | Описание |
|---|---|
/skill-track <трек> | Отследить посылку Boxberry |
/skill-calculate <город> <вес> | Расчёт стоимости доставки |
/delivery <город> <вес> | Полный цикл: город → ПВЗ → расчёт |
Разработка
npm install
npm run build
npm test
BOXBERRY_API_TOKEN=<TOKEN> npm run dev
Лицензия
MIT
Telegram: @vhodvai
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.