Connect
Optimize
Secure
Recurly MCP Server
for AI Agents
Production-ready Recurly MCP server with 138 extensible actions — plus built-in authentication, security, and optimized execution.
Recurly MCP Server
Built by 
StackOne
StackOne 
Coverage
138 Agent Actions
Create, read, update, and delete across Recurly — and extend your agent's capabilities with custom actions.
Authentication
Agent Tool Authentication
Per-user OAuth in one call. Your Recurly MCP server gets session-scoped tokens with zero credentials stored on your infra.
Agent Auth →
Security
Agent Protection
Every Recurly tool response scanned for prompt injection in milliseconds — 88.7% accuracy, all running on CPU.
Prompt Injection Defense →
Performance
Max Agent Context. Min Cost.
Free up to 96% of your agent's context window to enhance reasoning and reduce cost, on every Recurly call.
Tools Discovery →What is the Recurly MCP Server?
A Recurly MCP server lets AI agents read and write Recurly data through the Model Context Protocol — Anthropic's open standard for connecting LLMs to external tools. StackOne's Recurly MCP server ships with 138 pre-built actions, fully extensible via the Connector Builder — plus managed authentication, prompt injection defense, and optimized agent context. Connect it from MCP clients like Claude Desktop, Cursor, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.
All Recurly MCP Tools and Actions
Every action from Recurly's API, ready for your agent. Create, read, update, and delete — scoped to exactly what you need.
Accounts
- Create Account
Create a new account on your Recurly site
- List Accounts
Retrieve a paginated list of all accounts on your Recurly site
- Get Account
Retrieve a specific account by its ID or code
- Update Account
Update an existing account's details
Subscriptions
- Create Subscription
Create a new subscription for an account
- List Subscriptions
Retrieve a paginated list of all subscriptions on your Recurly site
- Get Subscription
Retrieve a specific subscription by its ID
- Update Subscription
Update an existing subscription's details
Shipping Methods
- Create Shipping Method
Create a new shipping method on your Recurly site
- List Shipping Methods
Retrieve a paginated list of all shipping methods on your Recurly site
- Get Shipping Method
Fetch a specific shipping method by its ID or code
- Update Shipping Method
Update an active shipping method's details
Coupons
- Create Coupon
Create a new coupon on your Recurly site
- List Coupons
Retrieve a paginated list of all coupons on your Recurly site
- Get Coupon
Fetch a specific coupon by its ID or code
- Update Coupon
Update an active coupon's details
Transactions
- List Transactions
Retrieve a paginated list of all transactions on your Recurly site
- Get Transaction
Fetch a specific transaction by its ID or UUID
Plans
- Create Plan
Create a new plan on your Recurly site
- List Plans
Retrieve a paginated list of all plans on your Recurly site
- Get Plan
Retrieve a specific plan by its ID or code
- Update Plan
Update an existing plan's details
- Remove Plan
Remove (deactivate) a plan
Items
- Create Item
Create a new item in your Recurly item catalog
- List Items
Retrieve a paginated list of all items on your Recurly site
- Get Item
Fetch a specific item by its ID or code
- Update Item
Update an active item's details
Plan Add-ons
- Create Plan Add-on
Create a new add-on for a specific plan
- List Plan Add-ons
Retrieve a paginated list of all add-ons for a specific plan
- Get Plan Add-on
Retrieve a specific add-on for a plan by its ID or code
- Update Plan Add-on
Update an existing add-on for a specific plan
- Remove Plan Add-on
Remove (deactivate) an add-on from a plan
Credit Payments
- List Credit Payments
Retrieve a paginated list of all credit payments on your Recurly site
- Get Credit Payment
Fetch a specific credit payment by its ID or UUID
Line Items
- Create Line Item
Create a new line item for a specific account
- List Line Items
Retrieve a paginated list of all line items on your Recurly site
- Get Line Item
Fetch a specific line item by its ID
- Remove Line Item
Delete an uninvoiced line item
Invoices
- Create Invoice
Create an invoice from an account's pending line items
- List Invoices
Retrieve a paginated list of all invoices on your Recurly site
- Get Invoice
Fetch a specific invoice by its ID or number
- Update Invoice
Update an existing invoice's details
Usage Records
- Create Usage Record
Log a usage record on a subscription add-on
- List Usage Records
Retrieve a paginated list of usage records for a subscription add-on
- Get Usage Record
Retrieve a specific usage record by its ID
- Update Usage Record
Update an existing usage record by its ID
- Remove Usage Record
Delete a usage record by its ID
Active Coupon Redemptions
- List Active Coupon Redemptions
List the coupon redemptions that are active on an account
- Remove Active Coupon Redemption
Delete the active coupon redemption from an account
Coupon Redemptions
- Create Coupon Redemption
Generate an active coupon redemption on an account or subscription
- Get Coupon Redemption
Show the coupon redemption for an account
Subscription Coupon Redemptions
- List Subscription Coupon Redemptions
List the coupon redemptions for a subscription
- Get Subscription Coupon Redemption
Show the coupon redemption for a subscription
- Remove Subscription Coupon Redemption
Delete the coupon redemption from a subscription
Subscription Changes
- Create Subscription Change
Create a new subscription change
- Get Subscription Change
Fetch a subscription's pending change
- Remove Subscription Change
Delete the pending subscription change
Billing Infos
- Create Billing Info
Add new billing information to an account
- List Billing Infos
List all billing information entries for an account
- Get Billing Info
Fetch an account's billing information
- Update Billing Info
Set an account's billing information
- Remove Billing Info
Remove an account's billing information
Account Notes
- Create Account Note
Create an account note
- List Account Notes
List an account's notes
- Get Account Note
Fetch an account note
- Remove Account Note
Delete an account note
Shipping Address
- Create Shipping Address
Create a new shipping address for the account
- Get Shipping Address
Fetch an account's shipping address
- Update Shipping Address
Update an account's shipping address
- Remove Shipping Address
Remove an account's shipping address
Gift Cards
- Create Gift Card
Create a new gift card on your Recurly site
- List Gift Cards
Retrieve a paginated list of all gift cards on your Recurly site
- Get Gift Card
Fetch a specific gift card by its ID
Measured Units
- Create Measured Unit
Create a new measured unit on your Recurly site
- List Measured Units
Retrieve a paginated list of all measured units on your Recurly site
- Get Measured Unit
Fetch a specific measured unit by its ID or name
- Update Measured Unit
Update an existing measured unit's details
- Remove Measured Unit
Remove a measured unit from your Recurly site
Sites
- List Sites
Retrieve a list of sites associated with your Recurly account
- Get Site
Fetch a specific site by its ID or subdomain
Custom Field Definitions
- List Custom Field Definitions
Retrieve a paginated list of all custom field definitions on your Recurly site
- Get Custom Field Definition
Fetch a specific custom field definition by its ID
Dunning Campaigns
- List Dunning Campaigns
Retrieve the dunning campaigns for a site
- Get Dunning Campaign
Fetch a specific dunning campaign by its ID
Account Acquisitions
- List Account Acquisitions
List a site's account acquisition data
- Get Account Acquisition
Fetch an account's acquisition data
- Update Account Acquisition
Update an account's acquisition data
- Remove Account Acquisition
Remove an account's acquisition data
Invoice Templates
- List Invoice Templates
Show the invoice templates for a site
- Get Invoice Template
Fetch an invoice template by ID
Price Segments
- List Price Segments
List a site's price segments
- Get Price Segment
Fetch a price segment by ID or code
Other (46)
- Create Purchase
Create a new purchase containing subscriptions or one-time charges
- Create Pending Purchase
Create a pending purchase for Adyen HPP and Online Banking transactions
- Get Account Balance
Fetch an account's balance and past-due status
- List Subscription Invoices
List a subscription's invoices
- List Subscription Line Items
List a subscription's line items
- List Account Transactions
Retrieve a paginated list of transactions for a specific account
- List Account Credit Payments
Retrieve a paginated list of credit payments for a specific account
- List Account Line Items
Retrieve a paginated list of line items for a specific account
- List Account Invoices
Retrieve a paginated list of invoices for a specific account
- List Invoice Line Items
Retrieve a paginated list of line items on an invoice
- List Invoice Coupon Redemptions
List the coupon redemptions applied to an invoice
- List Account Coupon Redemptions
List the coupon redemptions for an account
- List Shipping Addresses
Fetch a list of an account's shipping addresses
- List Business Entities
List business entities for a site
- Get Business Entity
Fetch a business entity by ID
- Get Export Dates
List the dates that have an available export to download
- Get Export Files
List the export files available to download for a given date
- Remove Coupon Redemption By ID
Delete the coupon redemption by ID from an account
- Deactivate Account
Deactivate (soft-delete) an account
- Reactivate Account
Reactivate a previously deactivated account
- Cancel Subscription
Cancel a subscription
- Reactivate Subscription
Reactivate a canceled subscription
- Pause Subscription
Pause an active subscription
- Resume Subscription
Resume a paused subscription
- Preview Subscription Renewal
Preview a subscription's renewal invoice(s)
- Deactivate Shipping Method
Deactivate a shipping method making it unavailable for new subscriptions
- Deactivate Coupon
Expire (deactivate) an active coupon
- Restore Coupon
Restore an inactive (expired) coupon to active state
- Deactivate Item
Deactivate an item making it unavailable for new purchases
- Reactivate Item
Reactivate an inactive item making it available for new purchases
- Collect Invoice
Force a collection attempt on a pending or past due automatic invoice
- Mark Invoice Failed
Mark an open invoice as failed to halt dunning procedures
- Mark Invoice Successful
Mark an open invoice as successfully paid
- Void Invoice
Void a credit invoice
- Refund Invoice
Refund a charge invoice, generating a credit invoice
- Reopen Invoice
Reopen a closed or voided invoice
- Preview Subscription Change
Preview a new subscription change without saving it
- Verify Billing Info
Verify an account's credit card billing information
- Verify Billing Info CVV
Verify an account's credit card billing CVV
- Preview Purchase
Preview a new purchase to see resulting invoices without creating them
- Authorize Purchase
Authorize a purchase that can be captured at a later time
- Capture Purchase
Capture an open authorization request for a purchase
- Cancel Purchase
Cancel an open authorization request for a purchase
- Preview Gift Card
Preview a gift card purchase before completing the transaction
- Redeem Gift Card
Redeem a gift card and apply credit to a recipient account
- Bulk Update Dunning Campaign Plans
Assign a dunning campaign to multiple plans
Set Up Your Recurly MCP Server in Minutes
One endpoint. Any framework. Your agent is talking to Recurly in under 10 lines of code.
MCP Clients
Agent Frameworks
JSON{
"mcpServers": {
"stackone": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://api.stackone.com/mcp?x-account-id=<account_id>",
"--header",
"Authorization: Basic <YOUR_BASE64_TOKEN>"
]
}
}
}More Accounting MCP Servers
Chargify (Maxio)
118+ actions
Zoho Books
104+ actions
QuickBooks Online
95+ actions
FreshBooks
80+ actions
Xero
71+ actions
Microsoft Dynamics 365 Business Central
70+ actions
Fastbill
57+ actions
Recurly MCP Server Resources
MCP Code Mode: Keeping Tool Responses Out of Agent Context
Anthropic's code_execution processes data already in context. Custom MCP code mode keeps raw tool responses in a sandbox. 14K tokens vs 500.
11 min
Comparing BM25, TF-IDF, and Hybrid Search for MCP Tool Discovery
Benchmarking BM25, TF-IDF, and hybrid search for MCP tool discovery across 916 tools. The 80/20 TF-IDF/BM25 hybrid hits 21% Top-1 accuracy in under 1ms.
10 min
Indirect Prompt Injection Defense for MCP Tools: A Technical Guide
MCP tools that read emails, CRM records, and tickets are indirect prompt injection vectors. Here's how we built a two-tier defense that scans tool results in ~11ms.
12 min
Recurly MCP Server FAQ
Recurly MCP server vs direct API integration — what's the difference?
A Recurly MCP server and direct API integration serve different use cases. Direct API integration is for software-to-software — backend code calling Recurly. A Recurly MCP server is for AI agents — MCP clients like Claude and Cursor, plus framework agents built with OpenAI, LangChain, or Vercel AI — discovering and calling Recurly at runtime. StackOne provides both.
How does Recurly authentication work for AI agents?
Recurly authentication for AI agents works through a StackOne Connect Session. Create one via the dashboard or the SDK — you get an auth link and ready-to-paste config for Claude Desktop, Cursor, and other MCP clients. Your user authenticates their own Recurly account; StackOne handles token exchange, storage, and refresh. Credentials never reach the LLM, and each user is isolated via
origin_owner_id.Are Recurly MCP tools vulnerable to prompt injection?
Yes — Recurly MCP tools can be vulnerable to indirect prompt injection. Any tool that reads user-written content — documents, messages, tickets, records, or free-text fields — is a potential vector. StackOne Defender scans every tool response before it enters the agent's context — regex patterns in ~1ms, then a MiniLM classifier in ~4ms. 88.7% accuracy, CPU-only.
What is the context bloat of a Recurly agent and how do I avoid it?
Context bloat happens when Recurly tool schemas and API responses eat your Recurly agent's memory, preventing it from reasoning effectively. A single Recurly query can return a massive JSON response, and connecting multiple tools compounds the problem. Tools Discovery and Code Mode reduce context bloat — loading only relevant tools per query and keeping raw responses out of the agent's context.
Can I limit which actions my Recurly agent can access?
Yes — you can limit which actions your Recurly agent can access directly from the StackOne dashboard. Toggle actions on or off, or restrict them to specific accounts, with no code changes to your agent. Session tokens can be scoped to exact actions so if one leaks, exposure stays contained.
Can I create custom agent actions for my Recurly MCP server?
Yes — you can create custom agent actions for your Recurly MCP server using Connector Builder. It's an integration agent your coding assistant (Claude Code, Cursor, or Copilot) can invoke to research Recurly's API, generate production-ready connector YAML, test against the live API, and validate before you ship.
When should I NOT use a Recurly MCP server?
Skip a Recurly MCP server if your integration is purely software-to-software — direct Recurly API integration is simpler when no AI agent is involved. For deterministic, compliance-critical operations (financial transactions, regulatory reporting), direct API gives you predictable behavior without agent-driven decision-making. MCP shines when AI agents need to dynamically discover and call Recurly actions at runtime.
What AI frameworks and AI clients does the StackOne Recurly MCP server support?
The StackOne Recurly MCP server supports both. MCP clients (paste-and-go apps): Claude Desktop, Claude Code, Cursor, VS Code, Goose. Agent frameworks (code SDKs you build with): OpenAI Agents SDK, Anthropic, Vercel AI, Google ADK, CrewAI, Pydantic AI, LangChain, LangGraph, Azure AI Foundry.
Put your AI agents to work
All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.