Boxberry Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

MCP server for the Boxberry delivery API, letting an assistant look up cities and pickup points, calculate delivery cost and time, and track parcels.

What you can do
  • Search Boxberry cities by name and list pickup points in a given city
  • Calculate delivery cost and timeframes between locations
  • Track a shipment by tracking number and check a postal code against the delivery zone
  • List services rendered for a shipment
When to use it
Useful when you want to answer delivery questions in chat — quoting Boxberry shipping cost and timing, finding the nearest pickup point in a customer's city, or checking a parcel's status — without logging into the Boxberry account.
Requirements
Runs locally over stdio via npx from the npm package @theyahia/boxberry-mcp, so Node.js is needed. Requires a Boxberry API token from the personal account; the manifest names the variable BOXBERRY_TOKEN while the README uses BOXBERRY_API_TOKEN, so confirm which name the installed version reads. An optional PORT variable enables an HTTP transport.
Before you install
The API token is a credential tied to your Boxberry account; keep it out of shared configs. The README's setup snippet uses BOXBERRY_API_TOKEN while the manifest declares BOXBERRY_TOKEN, so a mismatch can silently break authentication. The repository is archived and development has moved to another monorepo, so this package may not receive updates.

Installation

In SourceWeft

  1. Open Boxberry Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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)

json
{  "mcpServers": {    "boxberry": {      "command": "npx",      "args": ["-y", "@theyahia/boxberry-mcp"],      "env": {        "BOXBERRY_API_TOKEN": "<YOUR_TOKEN>"      }    }  }}

HTTP-транспорт (Streamable HTTP)

bash
BOXBERRY_API_TOKEN=<TOKEN> npx @theyahia/boxberry-mcp --http# Endpoint: http://localhost:3000/mcp# Health:   http://localhost:3000/health

Порт настраивается через PORT:

bash
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 <город> <вес>Полный цикл: город → ПВЗ → расчёт

Разработка

bash
npm installnpm run buildnpm testBOXBERRY_API_TOKEN=<TOKEN> npm run dev

Лицензия

MIT

Telegram: @vhodvai

Source: README.md at commit 132c152

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts