@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.

Free tier: 100 API calls/day with just a wallet address (no API key needed).

Related Packages

| Package | Use Case | | ------------------------------------------------------------------------------ | ------------------------------------------------------- | | @cerebrochain/mcp-server (this package) | Use with Claude, Cursor, or any MCP-compatible AI agent | | @cerebrochain/bot-sdk | Direct programmatic access from JavaScript/TypeScript |

Both packages access the same underlying APIs. Use the SDK for custom integrations, use this MCP server for AI agent workflows.

License

MIT