Cycles Mcp Server
by runcyclescommunityv0.2.4
The Cycles MCP Server provides runtime budget authority for autonomous agents, allowing them to check, reserve, spend, and release budget before and after costly operations.
From the registry: Runtime budget authority for AI agents — reserve, enforce, reconcile spend across providers
Install & configure
Prerequisites
- optionalCycles API keyGet an API key from runcycles.io, or set CYCLES_MOCK=true for local development without an API key.https://runcycles.io
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `cycles-mcp-server` MCP server into my current AI client (that's you).
Optional prerequisites:
- Cycles API key — Get an API key from runcycles.io, or set CYCLES_MOCK=true for local development without an API key. (https://runcycles.io)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@runcycles/mcp-server"]
- required environment variables:
- `CYCLES_API_KEY`: Cycles API key. (example: `<your-cycles-api-key>`)
- optional environment variables:
- `CYCLES_BASE_URL`: Cycles API base URL. (example: `http://localhost:7878`)
- `CYCLES_MOCK`: Set to 'true' for mock mode (no API key needed). (example: `true`)
Note: Runtime budget authority for autonomous agents. CYCLES_API_KEY required unless CYCLES_MOCK=true.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Runtime budget authority for autonomous agents. CYCLES_API_KEY required unless CYCLES_MOCK=true.
Tools (9)
cycles_reserve
Reserve budget before a costly operation
cycles_commit
Commit actual usage after operation completes
cycles_release
Release reservation without committing
cycles_extend
Extend reservation TTL (heartbeat)
cycles_decide
Lightweight preflight budget check
cycles_check_balance
Check current budget balance for a scope
cycles_list_reservations
List reservations with filters
cycles_get_reservation
Get reservation details by ID
cycles_create_event
Record usage without reserve/commit lifecycle
Environment variables
CYCLES_API_KEYrequiredAPI key for authenticationCYCLES_BASE_URLrequiredURL for the Cycles serverPrerequisites
- • Node 20+
Packages
@runcycles/mcp-server
npmv0.2.4transport: stdio
Details
- Language
- TypeScript
- License
- Apache-2.0
- Released
- May 3, 2026
- Last commit
- Jun 17, 2026
- Registry name
- io.github.runcycles/cycles-mcp-server
Categories
Related Servers
Claude Flow
AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.
65.2k
Codebase Memory Mcp
Persistent codebase knowledge graph. Survives session restarts and context compaction.
33.0k
Serena
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
26.6k