@cargoffer/zbe-mcp

MCP (Model Context Protocol) server for checking vehicle routes against Low Emission Zones (ZBE/LEZ) in Spain and Portugal.

Quick Start

npx @cargoffer/zbe-mcp

Tools

| Tool | Description | |------|-------------| | zbe.checkRoute | Check if a vehicle route intersects ZBE polygons | | zbe.listPolygons | List ZBE polygons with optional filters | | zbe.getStats | Get coverage statistics | | zbe.getBadgeInfo | Get info about DGT environmental badges | | zbe.getVehicleRestrictions | Get vehicle access rules for a specific city |

Configuration

| Environment Variable | Default | Description | |---------------------|---------|-------------| | ZBE_API_URL | https://zbe.transcend.cargoffer.com/api | ZBE API base URL | | ZBE_API_KEY | (none) | API key for authentication |

🔑 How to get your API Key (Required)

To use this MCP server, you need a ZBE API Key from Cargoffer. This key is required for all API calls.

Get your free API key:

1. Go to https://zbe.cargoffer.com (or https://transcend.cargoffer.com)
2. Sign up / Log in to your Cargoffer account
3. Navigate to Dashboard → API Keys → Create New Key
4. Copy the key and use it as ZBE_API_KEY in your config

💡 Need help? Contact Cargoffer support at [email protected] or visit https://cargoffer.com for enterprise plans (TRANSCEND TMS, Bolsa de Carga, eCMR/DeCA).

Claude Desktop Config

{
  "mcpServers": {
    "zbe": {
      "command": "npx",
      "args": ["@cargoffer/zbe-mcp"],
      "env": {
        "ZBE_API_KEY": "your-api-key"
      }
    }
  }
}

SDKs

TypeScript: @cargoffer/zbe-sdk

import { ZbeClient } from '@cargoffer/zbe-sdk';
const client = new ZbeClient({ apiKey: 'YOUR_KEY' });
const result = await client.checkRoute({...});

Python: cargoffer-zbe

from zbe_client import ZbeClient
client = ZbeClient(api_key="YOUR_KEY")
result = await client.check_route(route=[...], vehicle={...})

Links

• GitHub: https://github.com/cargoffer/zbe-mcp-server
• API Docs: https://zbe.transcend.cargoffer.com/api/docs.json
• Website: https://zbe.cargoffer.com
• Report issues: https://github.com/cargoffer/zbe-mcp-server/issues