mcpField
B
boxberry-mcp

boxberry-mcp

Local
github.com/theYahiaMaps & Travel0Updated 8w ago

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

  1. 01Search Boxberry cities
  2. 02Find pickup points by city
  3. 03Calculate delivery cost and time
  4. 04Track shipments by tracking number
  5. 05Check postcode coverage and shipment services

Use cases

  1. 01Finding a pickup point in a city
  2. 02Estimating a shipment's cost and delivery time
  3. 03Checking a parcel's tracking status
  4. 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.

mcp.json · Universal config
{
"mcpServers": {
"theyahia-boxberry": {
"command": "npx",
"args": [
"-y",
"@theyahia/boxberry-mcp"
],
"env": {
"BOXBERRY_TOKEN": "<BOXBERRY_TOKEN>"
}
}
}
}
Run commandnpx -y @theyahia/boxberry-mcp
Environment variables to set
BOXBERRY_TOKENSecretAPI key for the service

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@theyahia/boxberry-mcp1.0.2

Tools

4

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
searchstringNoПоиск по названию города (подстрока)

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-mcp is 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

Markdown supported

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.