
Recurly
MCP server giving AI clients read-only access to Recurly accounts, subscriptions, invoices
- Pricing
- Freemium
- Platforms
- API, Web, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Recurly
Recurly is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.
The README describes this as a read-only bridge to Recurly API v3, where an agent can inspect customer account lifecycle, recurring subscription state, invoice collection status and payment outcomes. It is hosted on the Pipeworx gateway, so requests go through that gateway rather than directly from the client to Recurly.
Access to Recurly data requires a Recurly private API key passed per call as _apiKey, authenticated with HTTP Basic and pinned to the v2021-02-25 API version. The README advises using a key restricted to read permissions. The gateway also lists shared Pipeworx meta-tools alongside the four Recurly tools, so the tool count a client sees is larger than the pack's own set.
The package is an unofficial integration, not affiliated with or endorsed by Recurly. It is aimed at billing and finance operators, or developers building support and reporting workflows, who want an assistant to answer questions about balances, past-due invoices or failed payments.
Install
Run in a terminal
claude mcp add --transport http recurly https://gateway.pipeworx.io/recurly/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/recurly/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"recurly": {
"url": "https://gateway.pipeworx.io/recurly/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"recurly": {
"type": "http",
"url": "https://gateway.pipeworx.io/recurly/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"recurly": {
"serverUrl": "https://gateway.pipeworx.io/recurly/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"recurly": {
"type": "http",
"url": "https://gateway.pipeworx.io/recurly/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- recurly_list_accounts
- Customer account lifecycle state
- recurly_list_subscriptions
- Recurring subscription state
- recurly_list_invoices
- Invoice and collection state
- recurly_list_transactions
- Payment outcomes
What it does
- Account state lookup
- Lists customer accounts with codes, contact details, state, tax status, balances and timestamps.
- Subscription status tracking
- Returns subscriptions with plan, state, pricing, trial, renewal, cancellation and expiration dates.
- Invoice collection view
- Shows invoices with totals, balance, currency, collection method, due date and payment status.
- Payment transaction history
- Lists charges, refunds and verifications with type, status, amount and gateway response.
- Read-only access
- The pack only reads Recurly data and does not modify billing records.
Good for
- Finding customers with past-due or failed invoices
- Checking which subscriptions are trialing, paused or expiring
- Reviewing recent refunds and failed charges
- Answering support questions about a customer's account balance
Pricing
Freemium, from $49 a month
Free anonymous and free registered daily tiers; paid credits and subscriptions above that. Recurly itself needs your own key.
Prices change. Check pipeworx.io before you buy.
Recurly FAQ
Does the server modify data in Recurly?
No. The README states the pack is read-only.
Which authentication does it use?
It takes a Recurly private API key passed as _apiKey, using HTTP Basic authentication and the v2021-02-25 API version.
Is it an official Recurly product?
No. The README says it is an independent, unofficial integration not affiliated with or endorsed by Recurly.
Do I need an account to try it?
The Pipeworx pricing page allows anonymous use capped at 50 tool calls a day, and a free account raises that to 200 a day. The upstream Recurly key is still required for Recurly data.
Is Recurly free?
Recurly has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Recurly to Claude Code?
Run this command in your terminal: claude mcp add --transport http recurly https://gateway.pipeworx.io/recurly/mcp
What are the best alternatives to Recurly?
The closest alternatives to Recurly are Recurly MCP by usefulapi, Recurpay MCP by usefulapi, Paddle, Invoiced MCP by usefulapi and Xero.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.