Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

Recurly (BYOK) — connector documentation

  • MCP endpoint: https://byok-recurly.connectorbay.com/mcp
  • REST API: POST https://byok-recurly.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-recurly.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own Recurly Recurly private API key (US data center sites), sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-recurly.connectorbay.com/health · Tool schemas: https://byok-recurly.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-recurly · agent@connectorbay.com

What Recurly (BYOK) is for

Recurly (BYOK) lets an AI assistant read your own Recurly data through the Recurly API with a key you supply (Recurly private API key (US data center sites)). Read-only: 8 tools (list_accounts, get_account, list_subscriptions, get_subscription, list_invoices, get_invoice, list_transactions, list_plans). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to v3.recurly.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Recurly. Recurly and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "Find the Recurly account with email jo@example.com"
  • "Show the details of Recurly account code-jo"
  • "Which Recurly subscriptions are active and when do their periods end?"
  • "Show the details of Recurly subscription sub123"
  • "Which Recurly invoices are past due?"
  • "Show Recurly invoice 1001"

What it does

  • list_accounts: List Recurly accounts (customers) with code, email, name, company, state and whether they have live, active, canceled or past-due subscriptions or invoices. When has_more is true, request the next page by raising begin_time to the last record's time with sort and order set accordingly.
  • get_account: Get one Recurly account with contact details, state, subscription flags and dates.
  • list_subscriptions: List Recurly subscriptions with account, plan, state, amounts, current period, trial and cancel dates. Amounts are decimal values in the subscription's currency. When has_more is true, request the next page by raising begin_time to the last record's time with sort and order set accordingly.
  • get_subscription: Get one Recurly subscription with account, plan, state, price, period dates, renewal settings and add-on total.
  • list_invoices: List Recurly invoices with number, state, account, totals, amount paid, balance and due date. Amounts are decimal values in the invoice currency. When has_more is true, request the next page by raising begin_time to the last record's time with sort and order set accordingly.
  • get_invoice: Get one Recurly invoice with state, totals, tax, balance and dates.
  • list_transactions: List Recurly payment transactions (purchases, refunds, authorizations) with type, status, amount, account and gateway message. When has_more is true, request the next page by raising begin_time to the last record's time with sort and order set accordingly.
  • list_plans: List Recurly plans with code, name, state, billing interval, trial and prices per currency.

BYOK key

You bring your own Recurly Recurly private API key (US data center sites) (https://app.recurly.com/go/developer/api_keys). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to v3.recurly.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the Recurly API (v3.recurly.com) with a BYOK key; documentation: https://recurly.com/developers/api/v2021-02-25/index.html. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Recurly. Recurly and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Recurly account.

Built for: Worldwide. Languages: English.