Recurpay MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.8.4Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Connects an assistant to a Recurpay store to read subscriptions, subscribers, orders and plans, and to perform confirmed billing actions such as renewals and…

What you can do
  • Inspect subscriptions, subscribers, orders and plans, with filters and paging, and see which subscriptions are halted after a failed renewal.
  • Look up a single subscription, subscriber, order or plan, the subscriptions on an order, and the products attached to a plan.
  • Review webhook subscriptions and check the API scopes of the connected custom app.
  • Cancel a customer's subscription, skip the next billing cycle, renew immediately, send a payment link, update subscriber contact data, or add and remove a subscription coupon.
  • Check monthly usage, request a missing feature, and upgrade or cancel the UsefulAPI plan.
When to use it
Useful when a merchant wants to ask questions about their Recurpay subscription business in natural language, or handle routine billing tasks like retrying a halted renewal, skipping a cycle or sending a payment link without opening the Recurpay dashboard.
Requirements
Remote MCP endpoint added by URL only; no API key or Authorization header in the client config. Sign-in uses OAuth with the user's Recurpay credentials. A custom app must be created in the user's own Recurpay store with the needed scopes. Free tier allows 50 tool calls per month; paid plans raise the limit.
Before you install
Write tools change store data: cancelling a customer subscription stops billing and deliveries, and coupon or contact changes affect future bills. Renewal can charge a saved payment method and payment links notify the customer; both require explicit confirmation and repeated calls can repeat charges or notifications. A timeout can leave a write uncertain, so check Recurpay before retrying. Subscriber, subscription and order records pass through UsefulAPI to the AI client and LLM provider. Paid…

Installation

In SourceWeft

  1. Open Recurpay MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Frecurpay/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Recurpay MCP server

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://recurpay.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http recurpay https://recurpay.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "recurpay": {      "url": "https://recurpay.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Recurpay credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/recurpay/

Tools

ToolTypeWhat it does
recurpay_get_access_scopesreadGet the token's API scopes
recurpay_list_subscriptionsreadList subscriptions
recurpay_get_subscriptionreadGet a subscription
recurpay_list_subscribersreadList subscribers
recurpay_get_subscriberreadGet a subscriber
recurpay_list_ordersreadList orders
recurpay_get_orderreadGet an order
recurpay_list_order_subscriptionsreadList an order's subscriptions
recurpay_list_plansreadList plans
recurpay_get_planreadGet a plan
recurpay_list_plan_productsreadList a plan's products
recurpay_list_webhooksreadList webhooks
recurpay_cancel_customer_subscriptionwriteCancel a customer's subscription
recurpay_skip_next_billingwriteSkip the next billing
recurpay_renew_subscriptionwriteRenew a subscription now
recurpay_send_payment_linkwriteSend a payment link to the subscriber
recurpay_update_subscriberwriteUpdate a subscriber
recurpay_update_subscription_couponwriteAdd or remove a subscription coupon
recurpay_usage_statusmetaUsage status (free-tier meter)
recurpay_request_featuremetaRequest a missing feature
recurpay_upgrademetaUpgrade to Pro or Pro+
recurpay_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free (per Recurpay store)$050 tool calls / month
Pro (per Recurpay store)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with recurpay_upgrade (it returns a Stripe Checkout link). Cancel any time with recurpay_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running recurpay_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

Store access and billing actions

Create a custom app in your own Recurpay store: Settings → Integrations → Develop apps → Create new app. Grant only the needed scopes. Recurpay documents this per-store custom-app route as approval-free. This independent connector is not a Recurpay public app or marketplace listing. Your vendor account, API eligibility and any vendor charges remain separate.

The token is encrypted for authorized API calls. Requested subscriber, subscription and order records pass through UsefulAPI to your chosen AI client and LLM provider. Connected-token values and credential fields are removed from results. Revoke the custom app/token in Recurpay to end vendor access; disconnect UsefulAPI to stop this connection. Billing follows the store, normally including token rotation.

Immediate renewal can charge a saved payment method; generating a payment link notifies the subscriber. Both tools require explicit confirmation. Cancelling a customer subscription stops its billing and deliveries; skipping advances the next cycle. Contact and discount changes can affect future billing. These are separate from cancelling your UsefulAPI plan.

No vendor operation is automatically replayed. A timeout or unreadable reply can leave a write uncertain; check Recurpay before repeating it. Repeated explicit renewal or payment-link calls can repeat charges or notifications. An acknowledged renewal record is not independent proof that a payment settled. Operations have a 30-second deadline and an 8-MiB response cap.

The 18 tools were checked against current vendor definitions and local mocks. Release authentication checks used a nonexistent token on the vendor-owned demo. No real customer reads, charges, customer messages or business writes were tested.

Source: servers/recurpay/README.md at commit 4046075

Tools

18

recurpay_get_access_scopes

Get the token's API 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.

Takes no parameters.

recurpay_list_subscriptions

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.

Parameterspageemaillimitstatusplan_idsort_bysort_keycreated_at_maxcreated_at_minupdated_at_maxupdated_at_min

recurpay_get_subscription

Get a subscription

Get one subscription with its subscriber, addresses, line items, discount codes, billing/delivery policy, payment method and billing dates.

Parameterssubscription_idrequired

recurpay_list_subscribers

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.

Parameterspageemaillimitsort_bysort_keylast_namefirst_namecreated_at_maxcreated_at_minupdated_at_maxupdated_at_min

recurpay_get_subscriber

Get a subscriber

Get one subscriber (customer) with contact data, addresses and total spent.

Parameterssubscriber_idrequired

recurpay_list_orders

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.

Parametersnamepageemaillimitsort_bysort_keycreated_at_maxcreated_at_minupdated_at_maxupdated_at_minsubscription_id

recurpay_get_order

Get an order

Get one order with its subscriber and line items.

Parametersorder_idrequired

recurpay_list_order_subscriptions

List an order's subscriptions

List the subscriptions that belong to one order.

Parameterspagelimitsort_byorder_idrequiredsort_keycreated_at_maxcreated_at_minupdated_at_maxupdated_at_min

recurpay_list_plans

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.

Parameterspagelimitsort_bysort_keyplan_titleproduct_titlecreated_at_maxcreated_at_minproduct_handleupdated_at_maxupdated_at_min

recurpay_get_plan

Get a plan

Get one plan with its selling plans (delivery policy, billing policy, anchors, discounts).

Parametersplan_idrequired

recurpay_list_plan_products

List a plan's products

List the products attached to one plan, with the variants excluded from it.

Parameterspagelimitplan_idrequired

recurpay_list_webhooks

List webhooks

List the webhook subscriptions of the store (topic, address, status). Needs the read-webhooks scope.

Parameterspagelimitcreated_at_maxcreated_at_min

recurpay_cancel_customer_subscription

Cancel a customer's 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.

Parameterssubscription_idrequiredcancelled_reasonrequired

recurpay_skip_next_billing

Skip the 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.

Parameterssubscription_idrequired

recurpay_renew_subscription

Renew a subscription now

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.

Parametersconfirmrequiredsubscription_idrequired

recurpay_update_subscriber

Update a 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.

Parametersemailphonelast_namefirst_namesubscriber_idrequired

recurpay_update_subscription_coupon

Add or remove a 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.

Parameterscoderequiredactionrequiredsubscription_idrequired

Version history

10
  1. v1.8.4LatestNov 7, 2026
  2. v1.7.3Nov 5, 2026
  3. v1.7.2Nov 5, 2026
  4. v1.7.1Nov 4, 2026
  5. v1.7.0Nov 3, 2026
  6. v1.6.1Nov 3, 2026
  7. v1.5.0Nov 1, 2026
  8. v1.3.0Oct 31, 2026
  9. v1.2.0Oct 31, 2026
  10. v1.1.0Oct 31, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations