Content
<p align="center">
<img src="assets/logo.svg" width="120" alt="CerebroChain Logo">
</p>
# @cerebrochain/mcp-server
[](https://www.npmjs.com/package/@cerebrochain/mcp-server)
[](https://opensource.org/licenses/MIT)
[](https://glama.ai/mcp/servers/CerebroChain/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
```bash
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):
```json
{
"mcpServers": {
"cerebrochain": {
"command": "cerebrochain-mcp",
"env": {
"CEREBROCHAIN_API_KEY": "your-api-key"
}
}
}
}
```
### Cursor
Add to `.cursor/mcp.json` in your project:
```json
{
"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](https://cerebrochain.com) to create an account and generate an API key.
## License
MIT
