How do I install the cycles mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `CYCLES_BASE_URL`, `CYCLES_API_KEY`, `CYCLES_MOCK`, `CYCLES_ALLOW_MOCK_IN_PRODUCTION`, `PORT`, `HOST`, `MCP_HTTP_AUTH_TOKEN`, `CYCLES_DEFAULT_TENANT` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Cycles MCP Server

MCP server for Cycles — runtime budget authority for autonomous agents

Remote serverstreamable-httpTypeScript

What is the Cycles MCP Server?

MCP server for Cycles — runtime budget authority for autonomous agents

What it actually does

Autonomous AI agents (Claude, GPT, custom agents) call LLMs, invoke tools, and hit external APIs — but have no built-in way to cap how much they spend. A single agent loop can burn through hundreds of dollars before anyone notices. Multiply that across tenants and teams, and cost control becomes a real problem.

Platform teams — building multi-tenant agent systems that need per-customer or per-workspace spend limits
Agent developers — who want agents to self-regulate — degrade to cheaper models when budget is low, skip optional tool calls, reduce retries
Enterprises — deploying AI agents that need guardrails so a runaway agent can't blow through a budget

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
cycles_reserve	POST /v1/reservations
cycles_commit	POST /v1/reservations/{id}/commit
cycles_release	POST /v1/reservations/{id}/release
cycles_extend	POST /v1/reservations/{id}/extend
cycles_decide	POST /v1/decide
cycles_check_balance	GET /v1/balances
cycles_list_reservations	GET /v1/reservations
cycles_get_reservation	GET /v1/reservations/{id}
cycles_create_event	POST /v1/events

How to install the Cycles MCP Server

{
  "mcpServers": {
    "cycles": {
      "command": "npx",
      "args": [
        "-y",
        "@runcycles/mcp-server"
      ],
      "env": {
        "CYCLES_BASE_URL": "http://localhost:7878",
        "CYCLES_API_KEY": "YOUR_CYCLES_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
CYCLES_BASE_URL	Declared in the maintainer’s client configuration.	Yes
CYCLES_API_KEY	Declared in the maintainer’s client configuration.	Yes

Example prompts to try

“Use Cycles to cycles reserve.”
“Use Cycles to cycles commit.”
“Use Cycles to cycles release.”

Frequently asked questions

MCP server for Cycles — runtime budget authority for autonomous agents Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Cycles MCP Server

Slack Archived Reference

Your assistant inside the workspace — read channels, search history, post messages and tame the noise.

CommunicationTypeScript★ 63.0k

Fonoster

Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.

AI & ML ServicesTypeScript★ 8.1k

Streamnative

A Model Context Protocol (MCP) server for integrating AI agents with StreamNative Cloud resources and Apache Kafka/Pulsar messaging systems.

CommunicationPython

Alion: jobs, employers and labour-market data

Verified job postings from employer ATS boards, employer hiring signals and pay statistics.

Finance & Market DataRemote

Optout-signal-lint

Finds the ad and analytics code that keeps firing after a visitor’s browser has already sent Global

Communication

Wapiworld WhatsApp API

Check your WhatsApp numbers, connection status and webhooks, and send a text when you confirm.

CommunicationRemote