Cero Labs MCP Server

Expert escalation for AI agents over the Model Context Protocol.

The package exposes two entrypoints:

• cerolabs-mcp: stdio MCP server for Claude Desktop, Cursor, Cline, and other MCP clients
• cerolabs: small CLI for direct shell use

Install

Run directly with npx:

npx -y cerolabs-mcp

Or install globally:

npm install -g cerolabs-mcp

Required Environment

export CERO_API_KEY="cero_..."
export CERO_API_URL="https://api-production-cd65.up.railway.app"  # optional

You can create an API key from the Cero dashboard or by calling the registration endpoint:

curl -X POST https://api-production-cd65.up.railway.app/auth/register \
  -H "Content-Type: application/json" \
  -d '{"name":"Your Name","email":"[email protected]","company":"Your Company"}'

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "cerolabs": {
      "command": "npx",
      "args": ["-y", "cerolabs-mcp"],
      "env": {
        "CERO_API_KEY": "cero_your_key_here"
      }
    }
  }
}

Codex

Add the server directly with the Codex CLI:

codex mcp add cerolabs \
  --env CERO_API_KEY=cero_your_key_here \
  --env CERO_API_URL=https://api-production-cd65.up.railway.app \
  -- npx -y cerolabs-mcp

Cursor / Cline

Use the same command and env:

{
  "command": "npx",
  "args": ["-y", "cerolabs-mcp"],
  "env": {
    "CERO_API_KEY": "cero_your_key_here"
  }
}

Any Stdio-Capable Agent

If the agent supports launching MCP over stdio, the portable configuration is:

{
  "command": "npx",
  "args": ["-y", "cerolabs-mcp"],
  "env": {
    "CERO_API_KEY": "cero_your_key_here",
    "CERO_API_URL": "https://api-production-cd65.up.railway.app"
  }
}

Tools

• escalate: send a question to a verified expert
• check_escalation: non-blocking status check for an escalation
• wait_for_resolution: block until the expert resolves or timeout
• list_escalations: list recent escalations
• cancel_escalation: cancel a pending or routed escalation
• list_domains: list available escalation domains (live from API)
• submit_feedback: score a completed resolution
• usage: show tier, credit balance, cost per priority, and limits
• top_up: buy more credits — returns a Stripe Checkout URL the user clicks in-chat

CLI

cerolabs usage
cerolabs list
cerolabs domains
cerolabs escalate --domain healthcare.rcm --query "CPT 99214 denied for modifier 25"

Local Development

npm install
npm run build
node dist/cli.js usage
node dist/index.js

Publish Checklist

npm install
npm run build
npm pack --dry-run
npm publish

Remote HTTP MCP is intentionally not part of this package. The current distribution target is stdio via npm.