Cycles — Budget Authority for AI Agents MCP Server
by runcyclesio.github.runcycles/cycles-mcp-serverv0.6.1
Runtime budget authority for AI agents — reserve, enforce, reconcile spend across providers
context tax
queued
security
queued
cold start
queued
freshness
Active5d ago
Install Cycles — Budget Authority for AI Agents MCP server
Install in Claude Code
claude mcp add runcycles -e CYCLES_API_KEY='<cycles-api-key>' -e CYCLES_BASE_URL='<cycles-base-url>' -- npx -y @runcycles/mcp-serverInstall in Cursor
{
"mcpServers": {
"runcycles": {
"command": "npx",
"args": [
"-y",
"@runcycles/mcp-server"
],
"env": {
"CYCLES_API_KEY": "<cycles-api-key>",
"CYCLES_BASE_URL": "<cycles-base-url>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"runcycles": {
"command": "npx",
"args": [
"-y",
"@runcycles/mcp-server"
],
"env": {
"CYCLES_API_KEY": "<cycles-api-key>",
"CYCLES_BASE_URL": "<cycles-base-url>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"runcycles": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@runcycles/mcp-server"
],
"env": {
"CYCLES_API_KEY": "<cycles-api-key>",
"CYCLES_BASE_URL": "<cycles-base-url>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"runcycles": {
"command": "npx",
"args": [
"-y",
"@runcycles/mcp-server"
],
"env": {
"CYCLES_API_KEY": "<cycles-api-key>",
"CYCLES_BASE_URL": "<cycles-base-url>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| CYCLES_API_KEY | yes | yes | Cycles API key for authentication. Set CYCLES_MOCK=true for local development without a key. |
| CYCLES_BASE_URL | yes | — | 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). |
Freshness
Active — last maintenance signal 5d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-04 · 5d ago · GitHub
Latest release
2026-07-27 · 2mo ago · GitHub · v0.6.1
Package published
no data · npm/PyPI
Registry entry updated
2026-07-27 · 2mo ago · official registry · v0.6.1
FAQ
›How do I install the Cycles — Budget Authority for AI Agents MCP server in Claude Code?
Run: claude mcp add runcycles -e CYCLES_API_KEY='<cycles-api-key>' -e CYCLES_BASE_URL='<cycles-base-url>' -- npx -y @runcycles/mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Cycles — Budget Authority for AI Agents require an API key?
Yes. It expects CYCLES_API_KEY, CYCLES_BASE_URL, of which 1 is a secret.
›Can I use Cycles — Budget Authority for AI Agents as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Cycles — Budget Authority for AI Agents in the official MCP registry?
Yes, as io.github.runcycles/cycles-mcp-server.