<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