Connect your AI Agents to Stripe in minutes

Merge lets you securely connect your agents to Stripe and thousands of tools instantly

Available tools

retrieve_balance

Retrieve the current balance of your Stripe account showing available and pending amounts by currency. Shows funds available for payout and funds pending from recent transactions.

list_balance_transactions

List all balance transactions with pagination and filtering by date, currency, payout, or transaction type. Shows detailed history of all funds movement including charges, refunds, payouts, and fees.

retrieve_balance_transaction

Retrieve complete details of a specific balance transaction including fees, net amount, and source information

create_charge

Create a charge to process an immediate payment from a customer using their payment method or source

retrieve_charge

Retrieve complete details of a specific charge by ID including amount, status, receipt URL, and refund information

update_charge

Update charge metadata, description, receipt email, or shipping information after the charge has been created

capture_charge

Capture a previously authorized charge to complete the payment and transfer funds from customer account to your account

list_charges

List all charges with cursor-based pagination and filtering by customer, payment intent, or creation date

search_charges

Search charges using Stripe's query syntax to find charges by amount, customer, status, or metadata fields

create_coupon

Create a new coupon for discounts and promotions. Use 'amount_off' for fixed discounts or 'percent_off' for percentage discounts. These are mutually exclusive. Set 'duration' to control how long the discount applies. Related: list_coupons (browse), apply to subscriptions/invoices.

retrieve_coupon

Retrieve complete details of a specific coupon including usage statistics and validity. Use to check coupon status before applying to customers or subscriptions. Related: create_coupon (creation), update_coupon (modifications).

update_coupon

Update coupon properties including name and metadata. Only name and metadata can be updated after creation. Discount amounts, percentages, and duration cannot be changed. Related: create_coupon (creation), retrieve_coupon (current details).

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11
Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}
Copy Code
Copied!

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }
Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}
Copy Code

FAQs on using Merge's Stripe  MCP server

FAQs on using Merge's Stripe  MCP server

How can I use the Stripe MCP server?

Here are just a few examples:

  • Automated closed-won workflow: When a sales opportunity is marked as "Closed Won" in a CRM, your agent can automatically create a Stripe customer record, set up a subscription based on the deal terms, and send the first invoice. Your agent can then notify the account owner in an app like Slack with payment details
  • Customer health monitoring: When a Stripe payment fails or a subscription is cancelled, your agent can automatically update the opportunity status in your CRM, create a high-priority task for the customer success team, and post an alert in the relevant Slack channel with customer context
  • Invoice reconciliation: When Stripe invoices are finalized, your agent can automatically create corresponding records in your ERP system (like QuickBooks or NetSuite), attach invoice PDFs from cloud storage, and update financial reporting dashboards
  • Subscription analytics: Your agent can query Stripe subscription data, cross-reference it with customer usage data from your product analytics tool, and generate reports in Google Sheets or Notion showing revenue trends, churn patterns, and expansion opportunities
  • Automated refund workflows: When a customer requests a refund through your support ticketing system (like Zendesk), your agent can verify the original charge in Stripe, process the refund, update the ticket status, and log the transaction details in your internal documentation system

What are popular tools for Stripe’s MCP server?

Here are just a few popular tools across data types:

Charges

  • <code class="blog_inline-code">create_charge</code>
  • <code class="blog_inline-code">retrieve_charge</code>
  • <code class="blog_inline-code">update_charge</code>
  • <code class="blog_inline-code">list_charges</code>

Customers

  • <code class="blog_inline-code">create_customer</code>
  • <code class="blog_inline-code">retrieve_customer</code>
  • <code class="blog_inline-code">update_customer</code>
  • <code class="blog_inline-code">list_customer_balance_transactions</code>

Invoices

  • <code class="blog_inline-code">finalize_invoice</code>
  • <code class="blog_inline-code">pay_invoice</code>
  • <code class="blog_inline-code">send_invoice</code>
  • <code class="blog_inline-code">void_invoice</code>

What makes Merge Agent Handler’s Stripe MCP server better than alternative Stripe MCP servers?

Merge Agent Handler’s Stripe MCP server also provides platform-level capabilities:

  • Enterprise-grade security and DLP: All tool inputs and outputs are scanned by a security gateway with configurable data-loss-prevention rules, allowing sensitive data to be blocked, redacted, or masked before reaching third-party systems
  • Comprehensive and customizable tools: Merge’s pre-built Stripe connector comes with nearly 100 tools. You can use them as is or modify them, whether it’s editing their names, descriptions, or schema
  • Authentication and credential management: Merge handles the full authentication lifecycle for connectors, including guided user authorization flows and credential storage, so agents can securely call tools without custom auth logic
  • Tool Pack and access control management: Developers can bundle connectors and tools into Tool Packs and control which tools an agent can access, and whether authentication is shared or per-user
  • Real-time observability and audit trails: Every tool call is logged with a fully-searchable activity log, enabling auditing, debugging, and monitoring of agent behavior across Stripe and other tools

Can I set security rules for Stripe tool calls in Merge Agent Handler?

Yes, you can set a wide range of security rules for Stripe tool calls in Merge Agent Handler. Here are just a few examples:

  • Block bank account and routing numbers before they're sent to tools like <code class="blog_inline-code">create_customer</code> or <code class="blog_inline-code">create_payout</code>
  • Block Social Security Numbers (SSNs) from being included in customer metadata fields
  • Redact customer email addresses from Stripe responses before they reach your agent (e.g., when calling <code class="blog_inline-code">list_customers</code> or <code class="blog_inline-code">search_customers</code>)
  • Log all refund operations to track when agents call <code class="blog_inline-code">create_refund</code> or <code class="blog_inline-code">cancel_refund</code>
  • Log high-value payment intents (e.g., any <code class="blog_inline-code">create_payment_intent</code> call above a certain amount threshold)
  • Log subscription cancellations to monitor when agents invoke <code class="blog_inline-code">cancel_subscription</code>

How can I start using Merge Agent Handler’s Stripe MCP server?

Here's how to get started with Merge Agent Handler's Stripe MCP server:

1. Sign up for an account. Visit this page and register for a free Agent Handler account to access the dashboard.

2. Configure a Tool Pack. Tool Packs determine which connectors and capabilities your agent can tap into. Head to the Tool Packs section and select "Create Tool Pack." Add Stripe as one of your connectors, then choose your authentication approach (either Individual, where each user links their own Stripe account, or Shared for one centralized Stripe credential for all users).

3. Define a Registered User. Navigate to Registered Users and create an entry. This represents the identity—whether human or system—that’ll execute actions through your agent. When Stripe authentication is required, Agent Handler will automatically walk users through a guided connection flow, eliminating the need to build OAuth flows from scratch.

4. Test in Sandbox mode. Before deploying to production, verify that everything functions correctly. Open your Tool Pack's Sandbox environment and experiment with Stripe operations like retrieving customers, creating payment intents, or listing invoices.

5. Connect your agent application. Integrate your agent with Agent Handler using one of these methods:

  • Model Context Protocol: Copy the MCP configuration snippet from your Tool Pack settings and paste it into your agent's MCP client configuration. This instantly grants your agent access to all Stripe tools through the protocol
  • REST API: Alternatively, call Agent Handler's REST endpoints directly if your agent doesn't support MCP natively

Explore other MCP servers built and managed by Merge

airtable
Airtable
anaplan
Anaplan
apollo
Apollo
asana
Asana
basecamp
Basecamp
box
Box
calendly
Calendly
clickup
ClickUp
confluence
Confluence
contentful
Contentful
datadog
Datadog
docusign
DocuSign
dropbox
Dropbox
figma
Figma
freshbooks
FreshBooks
freshdesk
Freshdesk
front
Front
github
GitHub
gitlab
GitLab
gmail
Gmail
gong
Gong
google_calendar
Google Calendar
google_drive
Google Drive
google_sheets
Google Sheets
greenhouse
Greenhouse
hubspot
HubSpot
intercom
Intercom
jira
Jira
jira_service_management
Jira Service Management
linear
Linear
linkedin
LinkedIn
microsoft_teams
Microsoft Teams
miro
Miro
monday
Monday.com
notion
Notion
onedrive
OneDrive
outlook
Outlook
pipedrive
Pipedrive
pylon
Pylon
quickbooks_online
QuickBooks Online
sapsf
SAP SuccessFactors
salesforce
Salesforce
sendgrid
SendGrid
sentry
Sentry
servicenow
ServiceNow
sharepoint
SharePoint
shopify
Shopify
slack
Slack
teamwork
Teamwork.com
trello
Trello
weather
Weather
wikipedia
Wikipedia
workday
Workday
zendesk
Zendesk
zendesk_sell
Zendesk Sell
zohocrm
Zoho CRM
zohodesk
Zoho Desk
zoom
Zoom

Ready to try it out?

Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now