# Recurly

> Recurly is a freemium MCP server for finance and payments. MCP server giving AI clients read-only access to Recurly accounts, subscriptions, invoices. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, Web, self-hosted
- **Website:** https://pipeworx.io/packs/recurly
- **Repository:** https://github.com/pipeworx-io/mcp-recurly
- **MCP Registry name:** io.github.pipeworx-io/recurly
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http recurly https://gateway.pipeworx.io/recurly/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/recurly/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "recurly": {
      "url": "https://gateway.pipeworx.io/recurly/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "recurly": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/recurly/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "recurly": {
      "serverUrl": "https://gateway.pipeworx.io/recurly/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "recurly": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/recurly/mcp"
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [Recurly MCP by usefulapi](https://ai-powered.com/mcp/recurly-mcp-by-usefulapi): Recurly MCP by usefulapi is a freemium MCP server for finance and payments.
- [Recurpay MCP by usefulapi](https://ai-powered.com/mcp/recurpay-mcp-by-usefulapi): Recurpay MCP by usefulapi is a freemium MCP server for finance and payments.
- [Paddle](https://ai-powered.com/mcp/paddle-2): Paddle is a freemium MCP server for finance and payments.
- [Invoiced MCP by usefulapi](https://ai-powered.com/mcp/invoiced-mcp-by-usefulapi): Invoiced MCP by usefulapi is a freemium MCP server for finance and payments.
- [Xero](https://ai-powered.com/mcp/xero-2): Xero is a freemium MCP server for finance and payments.
- [Polar MCP by usefulapi](https://ai-powered.com/mcp/polar-mcp-by-usefulapi): Polar MCP by usefulapi is a freemium MCP server for finance and payments.
- [Run my Accounts MCP by usefulapi](https://ai-powered.com/mcp/run-my-accounts-mcp-by-usefulapi): Run my Accounts MCP by usefulapi is a freemium MCP server for finance and payments.
- [Rechnio MCP by usefulapi](https://ai-powered.com/mcp/rechnio-mcp-by-usefulapi): Rechnio MCP by usefulapi is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/recurly
