Cycles — Budget Authority for AI Agents
About
Runtime budget authority for AI agents — reserve, enforce, reconcile spend across providers
Use this server
Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.
Transportstdio (runs a local command)
Env vars
CYCLES_API_KEY CYCLES_BASE_URL CYCLES_MOCK CYCLES_DEFAULT_TENANT CYCLES_DEFAULT_WORKSPACE CYCLES_DEFAULT_APP CYCLES_DEFAULT_WORKFLOW CYCLES_DEFAULT_AGENT CYCLES_DEFAULT_TOOLSETClaude Code
claude mcp add --env CYCLES_API_KEY= --env CYCLES_BASE_URL= --env CYCLES_MOCK= --env CYCLES_DEFAULT_TENANT= --env CYCLES_DEFAULT_WORKSPACE= --env CYCLES_DEFAULT_APP= --env CYCLES_DEFAULT_WORKFLOW= --env CYCLES_DEFAULT_AGENT= --env CYCLES_DEFAULT_TOOLSET= cycles-mcp-server -- npx @runcycles/mcp-server
Cursor
If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.
VS Code
code --add-mcp '{"name":"cycles-mcp-server","command":"npx","args":["@runcycles/mcp-server"],"env":{"CYCLES_API_KEY":"","CYCLES_BASE_URL":"","CYCLES_MOCK":"","CYCLES_DEFAULT_TENANT":"","CYCLES_DEFAULT_WORKSPACE":"","CYCLES_DEFAULT_APP":"","CYCLES_DEFAULT_WORKFLOW":"","CYCLES_DEFAULT_AGENT":"","CYCLES_DEFAULT_TOOLSET":""}}'
JSON
{
"mcpServers": {
"cycles-mcp-server": {
"command": "npx",
"args": [
"@runcycles/mcp-server"
],
"env": {
"CYCLES_API_KEY": "",
"CYCLES_BASE_URL": "",
"CYCLES_MOCK": "",
"CYCLES_DEFAULT_TENANT": "",
"CYCLES_DEFAULT_WORKSPACE": "",
"CYCLES_DEFAULT_APP": "",
"CYCLES_DEFAULT_WORKFLOW": "",
"CYCLES_DEFAULT_AGENT": "",
"CYCLES_DEFAULT_TOOLSET": ""
}
}
}
}
Environment variables are listed by name only — fill in your own values. Entries never carry secrets.