← Index

Cycles — Budget Authority for AI Agents

io.github.runcycles/cycles-mcp-server·v0.2.2·Calendar & Time
Quality Score
90
/100

Runtime budget authority for AI agents — reserve, enforce, reconcile spend across providers

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "cycles-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@runcycles/mcp-server"
      ],
      "env": {
        "CYCLES_API_KEY": "<your-cycles_api_key>",
        "CYCLES_BASE_URL": "https://api.runcycles.io",
        "CYCLES_MOCK": "false"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "cycles-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@runcycles/mcp-server"
      ],
      "env": {
        "CYCLES_API_KEY": "<your-cycles_api_key>",
        "CYCLES_BASE_URL": "https://api.runcycles.io",
        "CYCLES_MOCK": "false"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @runcycles/mcp-server
§02  Environment variables
CYCLES_API_KEY
requiredsecret

Cycles API key for authentication. Set CYCLES_MOCK=true for local development without a key.

CYCLES_BASE_URL

URL of the Cycles server.

CYCLES_MOCK

Enable mock mode for local development — no API key or live server required.

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
20
installability
25
documentation
15
stability
5
§04  Alternatives in Calendar & Time