KosmoKrator

other

Recurly MCP Integration for Codex

Connect Recurly to Codex 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 Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

Recurly MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "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 Codex

Codex 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 CodexClient-level gateway setup.