Cycles — Budget Authority for AI Agents MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add cycles-mcp-server -- npx -y @runcycles/mcp-server

{
  "mcpServers": {
    "cycles-mcp-server": {
      "args": [
        "-y",
        "@runcycles/mcp-server"
      ],
      "command": "npx"
    }
  }
}

[mcp_servers.cycles-mcp-server]
command = "npx"
args = ["-y", "@runcycles/mcp-server"]

{
  "mcpServers": {
    "cycles-mcp-server": {
      "args": [
        "-y",
        "@runcycles/mcp-server"
      ],
      "command": "npx"
    }
  }
}

{
  "mcpServers": {
    "cycles-mcp-server": {
      "args": [
        "-y",
        "@runcycles/mcp-server"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: CYCLES_API_KEY (Cycles API key for authentication. Set CYCLES_MOCK=true for local development without a key.), CYCLES_BASE_URL (URL of the Cycles server (e.g. https://api.runcycles.io). Required unless CYCLES_MOCK=true.), CYCLES_MOCK (Enable mock mode for local development — no API key or live server required.), CYCLES_DEFAULT_TENANT (Optional default tenant merged into any tool call that omits it (explicit fields win).), CYCLES_DEFAULT_WORKSPACE (Optional default workspace merged into any tool call that omits it (explicit fields win).), CYCLES_DEFAULT_APP (Optional default app merged into any tool call that omits it (explicit fields win).), CYCLES_DEFAULT_WORKFLOW (Optional default workflow merged into any tool call that omits it (explicit fields win).), CYCLES_DEFAULT_AGENT (Optional default agent merged into any tool call that omits it (explicit fields win).), CYCLES_DEFAULT_TOOLSET (Optional default toolset merged into any tool call that omits it (explicit fields win).). The author declared them in the registry entry; get the values from the project itself.