KosmoKrator

other

Recurly MCP Integration for Claude Agent SDK

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

7 functions 6 read 1 write API key auth
Submit Recurly feedback View package source

Connect Recurly to Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Recurly MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "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 Agent SDK

Claude Agent SDK 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

Recurly CLIUse direct JSON commands instead of MCP discovery. Recurly MCPFull gateway reference and MCP tool names. KosmoKrator for Claude Agent SDKClient-level gateway setup.