KosmoKrator

other

Recurly MCP Integration for Claude Code

Connect Recurly to Claude Code through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write API key auth

Connect Recurly to Claude Code

Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry.

Add KosmoKrator as a stdio MCP server in the Claude Code project config and select the integrations that should be visible. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Code can inspect read-capable tools without receiving write access by default.

Recurly MCP Config for Claude Code

Claude Code can launch the local kosmo binary directly from the project MCP config.

{
  "mcpServers": {
    "kosmokrator-recurly": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=recurly",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=recurly --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Recurly instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Recurly Tools Visible to Claude Code

Claude Code sees stable MCP tool names generated from the Recurly integration catalog.

MCP toolSource functionTypeDescription
integration__recurly__recurly_list_accounts recurly.recurly_list_accounts Read List billing accounts from Recurly. Supports filtering by email and state, with cursor-based pagination.
integration__recurly__recurly_get_account recurly.recurly_get_account Read Get details of a specific Recurly billing account by its ID or account code.
integration__recurly__recurly_create_account recurly.recurly_create_account Write Create a new billing account in Recurly with a unique account code, email, and name.
integration__recurly__recurly_list_subscriptions recurly.recurly_list_subscriptions Read List subscriptions from Recurly. Supports filtering by account and state, with cursor-based pagination.
integration__recurly__recurly_get_subscription recurly.recurly_get_subscription Read Get details of a specific Recurly subscription by its UUID.
integration__recurly__recurly_list_plans recurly.recurly_list_plans Read List billing plans from Recurly. Supports cursor-based pagination.
integration__recurly__recurly_get_current_user recurly.recurly_get_current_user Read Verify the Recurly API connection by fetching the first account. Useful as a health check.

Related Recurly Pages