English Français العربية

io.github.theYahia/boxberry-mcp

Official registry Archived Search and web

MCP server for Boxberry delivery API — city/point search, delivery calculation, tracking. 4 tools.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @theyahia/boxberry-mcp
Claude Code 
claude mcp add boxberry-mcp -e 'BOXBERRY_TOKEN=<your boxberry_token>' -- npx -y @theyahia/boxberry-mcp@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "boxberry-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/boxberry-mcp@1.0.2"
            ],
            "env": {
                "BOXBERRY_TOKEN": "<your boxberry_token>"
            }
        }
    }
}

Environment variables

  • BOXBERRY_TOKEN required secret API key for the service

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 🗄 Репозиторий заархивирован
  2. Boxberry MCP — расчёт доставки и пункты выдачи в диалоге с нейросетью
  3. Возможности (6 инструментов)
  4. Быстрый старт (stdio)
  5. HTTP-транспорт (Streamable HTTP)
  6. Smithery
  7. Переменные окружения
  8. Skills (Claude Code)
  9. Разработка
  10. Лицензия

🗄 Репозиторий заархивирован

Разработка переехала в 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

Frequently asked questions

What is io.github.theYahia/boxberry-mcp?

MCP server for Boxberry delivery API — city/point search, delivery calculation, tracking. 4 tools.

How do I install io.github.theYahia/boxberry-mcp?

It runs on your machine. In Claude Code: claude mcp add boxberry-mcp -e 'BOXBERRY_TOKEN=<your boxberry_token>' -- npx -y @theyahia/boxberry-mcp@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.theYahia/boxberry-mcp need an API key?

Yes. It expects BOXBERRY_TOKEN, which you set in its configuration.

Is io.github.theYahia/boxberry-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.theYahia/boxberry-mcp?

It is published by theYahia. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.