<p align="center"> <img src="assets/logo.svg" width="120" alt="CerebroChain Logo"> </p>
@cerebrochain/mcp-server
  
The first logistics/WMS MCP server for AI agents. Connect Claude, Cursor, or any MCP-compatible AI to CerebroChain's supply chain APIs.
Installation
npm install -g @cerebrochain/mcp-server
Configuration
Claude Desktop
Add to ~/.config/claude-desktop/claude_desktop_config.json (Linux) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"cerebrochain": {
"command": "cerebrochain-mcp",
"env": {
"CEREBROCHAIN_API_KEY": "your-api-key"
}
}
}
}
Cursor
Add to .cursor/mcp.json in your project:
{
"mcpServers": {
"cerebrochain": {
"command": "cerebrochain-mcp",
"env": {
"CEREBROCHAIN_API_KEY": "your-api-key"
}
}
}
}
Environment Variables
| Variable | Required | Description | |----------|----------|-------------| | CEREBROCHAIN_API_KEY | For Tier 2/3 | Your CerebroChain API key | | CEREBROCHAIN_API_URL | No | Custom API URL (default: https://cerebrochain.com/api) | | CEREBROCHAIN_JWT_TOKEN | No | Alternative auth via JWT token |
Available Tools
Tier 1 — Free (No API Key)
| Tool | Description | |------|-------------| | compare_shipping_rates | Compare rates across UPS, FedEx, USPS, DHL | | get_platform_status | Check platform health |
Tier 2 — Authenticated (API Key Required)
| Tool | Description | |------|-------------| | search_inventory | Search inventory items with filters | | check_stock_levels | Get stock levels for an item | | lookup_sku | Look up item by SKU | | get_warehouse_locations | List warehouse storage locations | | list_orders | List and search orders | | get_order_status | Get order details and tracking | | get_order_statistics | Get order KPIs | | get_fleet_stats | Get fleet utilization metrics | | list_vehicles | List fleet vehicles | | track_shipment | Track a shipment route | | list_shipments | Get shipment history |
Tier 3 — Premium (Subscription Required)
| Tool | Description | |------|-------------| | optimize_route | AI-powered route optimization | | forecast_demand | AI demand forecasting | | detect_bottlenecks | AI bottleneck detection | | get_optimization_recommendations | AI optimization suggestions | | get_financial_metrics | Revenue, margins, cash flow | | get_kpi_dashboard | KPI targets vs actuals | | natural_language_command | Natural language commands |
Resources
| URI | Description | |-----|-------------| | cerebrochain://inventory/summary | Inventory overview | | cerebrochain://logistics/fleet-status | Fleet status snapshot | | cerebrochain://executive/kpi-snapshot | Executive KPIs |
Example Usage
Once configured, ask your AI:
- "Compare shipping rates from 90210 to 10001 for a 5lb package"
- "Search inventory for items containing 'widget'"
- "What's the status of order ORD-12345?"
- "Optimize delivery route for these 10 stops"
- "What items will be out of stock in 30 days?"
Get an API Key
Visit cerebrochain.com to create an account and generate an API key.
License
MIT






