# Recurpay MCP by usefulapi

> Recurpay MCP by usefulapi is an MCP server. Read subscriptions, subscribers and orders; manage renewals, billing skips and payment links. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/recurpay/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/recurpay
- **MCP Registry name:** io.usefulapi/recurpay
- **Listing updated:** 2026-11-13

## About

Read subscriptions, subscribers and orders; manage renewals, billing skips and payment links.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http recurpay https://recurpay.usefulapi.io/mcp
```

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

```sh
https://recurpay.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "recurpay": {
      "url": "https://recurpay.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "recurpay": {
      "type": "http",
      "url": "https://recurpay.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "recurpay": {
      "serverUrl": "https://recurpay.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "recurpay": {
      "type": "http",
      "url": "https://recurpay.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `recurpay_get_access_scopes`: Show the API scopes of the custom app whose token is connected (read-/write- subscriptions, customers, orders, plans, payments, webhooks). Use it when a tool answers 403.
- `recurpay_list_subscriptions`: List the store's subscriptions (status active/paused/halted/cancelled/draft, subscriber, plan policies, line items, next_billing_at). Filter by status, plan, subscriber email and dates. Use status=halted to find subscriptions whose renewal payment failed. Page with next_page.
- `recurpay_get_subscription`: Get one subscription with its subscriber, addresses, line items, discount codes, billing/delivery policy, payment method and billing dates.
- `recurpay_list_subscribers`: List the store's subscribers (customers with at least one subscription): name, email, phone, addresses, total spent. Filter by name, email and dates. Page with next_page.
- `recurpay_get_subscriber`: Get one subscriber (customer) with contact data, addresses and total spent.
- `recurpay_list_orders`: List the orders generated by subscriptions (name, subscriber, status, totals). Filter by order name, subscriber email, subscription and dates. Page with next_page.
- `recurpay_get_order`: Get one order with its subscriber and line items.
- `recurpay_list_order_subscriptions`: List the subscriptions that belong to one order.
- `recurpay_list_plans`: List the subscription plans (selling plan groups) with their delivery/billing policies and discounts. Filter by plan title, product title/handle and dates. Page with next_page.
- `recurpay_get_plan`: Get one plan with its selling plans (delivery policy, billing policy, anchors, discounts).
- `recurpay_list_plan_products`: List the products attached to one plan, with the variants excluded from it.
- `recurpay_list_webhooks`: List the webhook subscriptions of the store (topic, address, status). Needs the read-webhooks scope.
- `recurpay_cancel_customer_subscription`: WRITE: cancel one subscriber's subscription in Recurpay (status becomes cancelled; billing and deliveries stop). This is the merchant's action on a customer's subscription, not the cancellation of this MCP server's own plan. Only the merchant can re-activate it. Ask the user to confirm the subscription first.
- `recurpay_skip_next_billing`: WRITE: skip the subscription's next billing/delivery cycle (the next order is not generated). Ask the user to confirm the subscription first.
- `recurpay_renew_subscription`: WRITE, MAY CHARGE THE CUSTOMER: renew the subscription now. Recurpay runs the billing cycle immediately, which can charge the subscriber's saved payment method and create an order. Use it e.g. to retry a halted subscription. Only call it when the user explicitly asks for it and set confirm=true. Repeated calls may repeat the charge or notification.
- `recurpay_send_payment_link`: WRITE, CONTACTS THE CUSTOMER: generate a payment link for the subscription (renewal payment or payment-method update); Recurpay notifies the subscriber with it. Use it for halted subscriptions. Only call it when the user explicitly asks for it and set confirm=true. Repeated calls may repeat the charge or notification.
- `recurpay_update_subscriber`: WRITE: change a subscriber's contact data (email, first name, last name, phone). Only the fields you pass are sent. Ask the user to confirm the new values.
- `recurpay_update_subscription_coupon`: WRITE: add or remove a discount code (coupon) on one subscription; it changes what the subscriber pays on the next billings. Ask the user to confirm.

## FAQ

### How do I add Recurpay MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http recurpay https://recurpay.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/recurpay-mcp-by-usefulapi
