MCP Setup

AitherOS exposes a Model Context Protocol (MCP) server at https://api.aitheros.ai/v1/mcp with ~1,000 tools across 147 modules — code search, image generation, agent dispatch, infrastructure deployment, and more. Any MCP-compatible client (Claude Code, Cursor, Cline, custom) can use these tools.

You bring your own LLM — we never charge for inference. You only pay for tool calls based on their compute weight (tier 0=free → tier 4=100 credits).

Add to your Claude Code MCP config (~/.claude/mcp.json):

{
  "mcpServers": {
    "aitheros": {
      "command": "npx",
      "args": ["-y", "@aitherium/mcp-client"],
      "env": {
        "AITHER_API_KEY": "aith_sk_live_..."
      }
    }
  }
}

Get your API key from /portal/keys.

Cursor uses the same MCP protocol. Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "aitheros": {
      "url": "https://api.aitheros.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer aith_sk_live_..."
      }
    }
  }
}

Direct tool invocation via HTTP:

curl -X POST https://api.aitheros.ai/v1/tools/call \
  -H "Authorization: Bearer aith_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "generate_image",
    "arguments": { "prompt": "a cyberpunk cat" }
  }'

Discover available tools via the manifest endpoint: GET /v1/tools/manifest (returns name, description, credit_cost, tier, required features).

All requests use bearer-token auth. Issue a key at /portal/keys. Keys are shown once — store securely.

Keys are scoped to your tenant; rotate or revoke any time via the same UI.

Tools are tagged with a credit tier based on their compute weight:

• Tier 0 (free) — read-only, dashboards, health checks
• Tier 1 (1 credit) — LLM chat, search, memory write
• Tier 2 (5 credits) — image generation, voice, code analysis
• Tier 3 (25 credits) — swarm coding, code generation, workflows
• Tier 4 (100 credits) — training, GPU compute, video rendering

Plans start at $0 (100 credits) and scale up to $99 (25,000 credits + all tiers). Full breakdown at /pricing.

Tool calls return structured JSON on denial:

{
  "error": "PLAN_UPGRADE_REQUIRED",
  "message": "Tool 'swarm_code' requires feature(s): swarm_coding...",
  "tool": "swarm_code",
  "credit_cost": 25,
  "tier": 3,
  "upgrade_url": "https://aitheros.ai/pricing"
}

INSUFFICIENT_FUNDS is returned when your wallet balance is below the tool's credit cost. Top up at /portal/billing.