Cycles — Budget Authority for AI Agents

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.runcycles/cycles-mcp-server",
  "description": "Runtime budget authority for AI agents — reserve, enforce, reconcile spend across providers",
  "title": "Cycles — Budget Authority for AI Agents",
  "repository": {
    "url": "https://github.com/runcycles/cycles-mcp-server",
    "source": "github"
  },
  "version": "0.6.1",
  "websiteUrl": "https://runcycles.io",
  "packages": [
    {
      "registryType": "npm",
      "identifier": "@runcycles/mcp-server",
      "version": "0.6.1",
      "runtimeHint": "npx",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Cycles API key for authentication. Set CYCLES_MOCK=true for local development without a key.",
          "isRequired": true,
          "isSecret": true,
          "name": "CYCLES_API_KEY"
        },
        {
          "description": "URL of the Cycles server (e.g. https://api.runcycles.io). Required unless CYCLES_MOCK=true.",
          "isRequired": true,
          "name": "CYCLES_BASE_URL"
        },
        {
          "description": "Enable mock mode for local development — no API key or live server required.",
          "default": "false",
          "choices": [
            "true",
            "false"
          ],
          "name": "CYCLES_MOCK"
        },
        {
          "description": "Optional default tenant merged into any tool call that omits it (explicit fields win).",
          "name": "CYCLES_DEFAULT_TENANT"
        },
        {
          "description": "Optional default workspace merged into any tool call that omits it (explicit fields win).",
          "name": "CYCLES_DEFAULT_WORKSPACE"
        },
        {
          "description": "Optional default app merged into any tool call that omits it (explicit fields win).",
          "name": "CYCLES_DEFAULT_APP"
        },
        {
          "description": "Optional default workflow merged into any tool call that omits it (explicit fields win).",
          "name": "CYCLES_DEFAULT_WORKFLOW"
        },
        {
          "description": "Optional default agent merged into any tool call that omits it (explicit fields win).",
          "name": "CYCLES_DEFAULT_AGENT"
        },
        {
          "description": "Optional default toolset merged into any tool call that omits it (explicit fields win).",
          "name": "CYCLES_DEFAULT_TOOLSET"
        }
      ]
    }
  ]
}