Log inSubmit server
Boxberry MCP logo

Boxberry MCP

Search Boxberry cities and pickup points, calculate delivery, track shipments, validate postal codes, and list services via MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Boxberry MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "boxberry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/boxberry-mcp"
      ],
      "env": {
        "BOXBERRY_API_TOKEN": "YOUR_VALUE_HERE",
        "PORT": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

npx -y @theyahia/boxberry-mcp

ody while trying to fetch https://registry.npmjs.org/body-parser: aborted npm ERR! network This is a problem related to network connectivity. npm ERR! network In most cases you are behind a proxy or have bad network settings. npm ERR! network npm ERR! network If you are behind a proxy, please make sure that the npm ERR! network 'proxy' config is set properly. See: 'npm help config' npm ERR! A complete log of this run can be found in: /home/user/.npm/_logs/2026-10-18T11_30_36_884Z-debug-0.log

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 17d ago.

Overview

boxberry-mcp MCP server connects AI assistants to the Boxberry delivery API through six tools for location search, delivery calculations, shipment tracking, postal-code checks, and service lookup. It runs over stdio with npx or as a Streamable HTTP service at a configurable port, using a Boxberry API token. Use it when an agent needs to answer delivery questions, find pickup points, estimate shipping, or retrieve shipment information.

Use cases

  • Find Boxberry pickup points in a customer’s city
  • Calculate delivery cost and timing for a shipment
  • Track a Boxberry shipment by tracking number
  • Check postal-code delivery coverage
  • List services associated with a shipment

Key features

  • Search Boxberry cities by name
  • Find pickup points by city
  • Calculate delivery price and timing
  • Track shipments by tracking number
  • Validate postal codes against delivery zones
  • List shipment services

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

Not checked yetLast checked 1d ago

We have not completed a health check for this listing yet.

0/10 checks healthy over the last 57d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · @theyahia/boxberry-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads105Package downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Boxberry MCP works

What boxberry-mcp MCP server does

boxberry-mcp MCP server exposes Boxberry delivery operations to an MCP-compatible AI client. The package provides six tools covering common delivery workflows: finding cities, locating pickup points, calculating delivery cost and timing, tracking a shipment, checking whether a postal code belongs to a delivery zone, and listing services associated with a shipment.

The repository is archived, and ongoing development has moved to the theYahia/WWmcp monorepo. The current package remains available as @theyahia/boxberry-mcp on npm and is described as installable and usable in the same way as before. Issues and pull requests should be directed to the newer repository.

How it works

An MCP client starts the package and communicates with its tools. In stdio mode, the client launches npx -y @theyahia/boxberry-mcp and passes the Boxberry API token through the process environment. For deployments that need a network endpoint, the package can start with the --http flag and exposes Streamable HTTP at /mcp; a health endpoint is available at /health.

The available operations are:

  • list_cities searches the Boxberry city list by name.
  • list_points returns pickup points for a specified city.
  • calc_delivery calculates delivery price and estimated timing.
  • track looks up a shipment using its tracking number.
  • zip_check checks a postal code against the delivery zone.
  • list_services lists services provided for a shipment.

Claude Code skills are also documented for tracking a shipment, calculating delivery by city and weight, and running a city-to-pickup-point-to-calculation workflow.

Setup and configuration

The required setting is BOXBERRY_API_TOKEN, obtained from the Boxberry personal account. A stdio client can configure the npm package as an MCP command and provide this token in its environment.

HTTP mode starts with BOXBERRY_API_TOKEN=<TOKEN> npx @theyahia/boxberry-mcp --http. The default HTTP port is 3000, and PORT can override it, such as PORT=8080. A smithery.yaml file is included and also requires the Boxberry token.

Tools and capabilities

The boxberry-mcp MCP server fits conversational delivery tasks where an agent needs structured access to Boxberry data rather than a user navigating the delivery account manually. It can combine several calls for a broader flow: identify a city, find pickup points there, and calculate delivery for a shipment. Separate tools support shipment tracking, postal-code validation, and service inspection.

Limitations and notes

The source repository is no longer receiving updates. Its maintained location is the servers/boxberry/ directory in theYahia/WWmcp; this repository points there for current development. Operation requires a valid Boxberry API token. The documented package supports stdio and Streamable HTTP transports, with HTTP health and MCP endpoints available when HTTP mode is selected.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Boxberry MCP

boxberry-mcp is an MCP server that connects AI assistants to the Boxberry delivery API. Its six tools search cities and pickup points, calculate delivery cost and timing, track shipments, validate postal-code coverage, and list shipment services. It requires a Boxberry API token and supports stdio or Streamable HTTP transport.

Install it by running the npm package through npx: `npx -y @theyahia/boxberry-mcp`. Configure `BOXBERRY_API_TOKEN` in the MCP client environment. For HTTP mode, add the `--http` flag.

Start it with `BOXBERRY_API_TOKEN=<TOKEN> npx @theyahia/boxberry-mcp --http`. It listens on port 3000 by default, and the port can be changed with `PORT`, such as `PORT=8080`. The MCP endpoint is `/mcp` and the health endpoint is `/health`.

Yes, boxberry-mcp documents Claude Code skills for tracking shipments, calculating delivery, and running a city-to-pickup-point-to-calculation workflow. The package also supports standard MCP stdio transport.

Related MCP servers

All in Delivery All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBoxberry MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/boxberry-mcp?style=directory)](https://allmcps.com/mcp/boxberry-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/boxberry-mcp"><img src="https://allmcps.com/api/badge/boxberry-mcp?style=directory" alt="Boxberry MCP on AllMCPs" /></a>