Model Context Protocol
Payment MCP server for AI agents
Paymegate's MCP server lets AI agents interact with your payment account. Connect Claude, ChatGPT, Cursor, VS Code or any MCP client to answer questions about fees and payment methods, look up orders, and create payment links for card and crypto payments, without writing integration code.
What AI agents can do with the Paymegate MCP server
Answer payment questions
Public tools search Paymegate's documentation, so any AI assistant can explain fees, supported payment methods, payouts, webhooks and API details. No account or API key needed.
Check orders and payment status
Ask in chat which orders were paid today, find an order by customer email, or check why a payment is still pending. The agent reads your account through scoped tools.
Create payment links
Tell the agent who to charge and how much, and it creates a live payment order and returns a hosted checkout payment link your customer can pay by card, Apple Pay, Google Pay or crypto.
Explore the API while you code
In Cursor, VS Code or Claude Code, the agent can pull the exact OpenAPI definition of any endpoint, so payment integration code matches the real API.
One-click sign-in with OAuth
Claude and ChatGPT connect through OAuth: you sign in, choose the permissions, and the client gets its own revocable access. No API key to copy and paste.
Free to use
The MCP server costs nothing. You only pay Paymegate's normal transaction fees when a payment is completed.
What is a payment MCP server?
The Model Context Protocol (MCP) is an open standard that lets AI applications connect to outside tools and data. An MCP server exposes a set of tools; MCP clients such as Claude Desktop, ChatGPT, Cursor and VS Code discover those tools and call them when a user asks for something in chat.
A payment MCP server exposes payment actions as MCP tools. Instead of opening a dashboard or calling an API by hand, you ask your AI assistant to check a transaction, list your payment methods or create a payment link, and the agent calls the right tool for you with your permission.
Two endpoints: public docs and your merchant account
The open endpoint at https://api.paymegate.com/mcp needs no sign-in for its public tools, so any agent can use it to answer questions about Paymegate. Developers can also call the merchant tools there by sending a scoped API key in the X-API-Key header or as a Bearer token in the Authorization header.
The merchant endpoint at https://api.paymegate.com/mcp/merchant is for one-click connectors. It answers an unauthenticated request with a 401 challenge, so the MCP client starts the OAuth 2.1 sign-in automatically. You approve the connection in your Paymegate dashboard, and the client receives a scoped access token.
Security, permissions and revoking access
Every connection is limited to the permissions you approve: read your account and orders, read products, and optionally create payment orders. The access token is an API key named after the client, for example "MCP: Claude", so you can see each authorized MCP client under Settings → API keys and select Revoke to disconnect it at any time.
Agents never see card data. Customers pay on a hosted checkout page, and the MCP tools only return order details, payment status and payment links. Cross-origin browser requests to the server are blocked, and each tool enforces its own scope.
Paymegate MCP vs. the Stripe MCP server
The Stripe MCP server lets AI agents interact with the Stripe API for businesses that already have an approved Stripe account. Paymegate's payment MCP server is built for merchants who need card payments and crypto settlement without a traditional merchant account, including businesses that Stripe and other providers decline.
Both follow the Model Context Protocol, so you can use them side by side in the same MCP client. Pick the server that matches the payment provider your business actually uses.
MCP tools
| Tool | Access | What it does |
|---|---|---|
| search_paymegate_docs | Public | Answers questions about fees, payment methods, payouts, webhooks, plugins and API endpoints from Paymegate's public documentation. |
| get_api_operation | Public | Returns the OpenAPI definition and schemas for one public Merchant API operation, or lists them all. |
| get_account_capabilities | Merchant | Shows the connected key's environment, scopes, merchant status and wallet state. |
| list_payment_methods | Merchant | Lists the payment methods enabled for your account. |
| list_orders | Merchant | Lists and filters your orders by status, source, date or search text. |
| get_order | Merchant | Retrieves one order and its payment status. |
| list_products | Merchant | Lists the products in your catalog. |
| create_payment_order | Merchant | Creates a live payment order and returns its hosted checkout payment link. Needs the orders:create permission. |
Connect your MCP client
Claude and Claude Desktop
Open Settings → Connectors → Add custom connector, paste the merchant URL, and sign in to Paymegate when Claude asks. Approve the permissions on the consent page and the tools appear in chat.
https://api.paymegate.com/mcp/merchantChatGPT
In ChatGPT settings, add a custom connector with the merchant URL (available on plans that support custom MCP connectors), then sign in and approve access.
https://api.paymegate.com/mcp/merchantClaude Code
Run the following command in your terminal, then type /mcp in Claude Code to sign in.
claude mcp add --transport http paymegate https://api.paymegate.com/mcp/merchantCursor
Open Cursor settings → MCP and add the server, or put this configuration in .cursor/mcp.json at your project root.
{
"mcpServers": {
"paymegate": { "url": "https://api.paymegate.com/mcp/merchant" }
}
}VS Code
Add this configuration to .vscode/mcp.json at your project root and start the server from the MCP view.
{
"servers": {
"paymegate": { "type": "http", "url": "https://api.paymegate.com/mcp/merchant" }
}
}How to connect the payment MCP server
- 1Create a free Paymegate account if you do not have one.
- 2Add https://api.paymegate.com/mcp/merchant as an MCP server in your AI application.
- 3Sign in to Paymegate when the client opens the authorization page.
- 4Choose the permissions to grant and select Allow.
- 5Ask the agent to check your orders or create a payment link.
Who uses the Paymegate MCP server
- Merchants who want to manage payments from chat
- Developers building a payment integration with an AI coding assistant
- Agencies supporting many client stores
- Teams building AI agents that send invoices or payment links
Integrations
Payment MCP server vs. a manual API integration
| Feature | Typical alternative | Paymegate |
|---|---|---|
| Setup time | Hours of code and testing | Minutes, no code |
| Authentication | Store and rotate API keys yourself | OAuth sign-in or a scoped API key |
| Create a payment link | Write an API request | Ask in chat |
| Card and crypto payments | Depends on the provider | Both |
Traditional figures are typical industry ranges and vary by provider.
Frequently asked questions
What is MCP in a payment gateway?
+
MCP (Model Context Protocol) is how AI agents connect to tools. A payment gateway's MCP server exposes payment actions, such as checking orders or creating payment links, as tools an AI agent can call on your behalf.
Does the MCP server cost money?
+
No. Connecting to the Paymegate MCP server is free. Normal transaction fees apply only when a customer completes a payment: a 1% platform fee plus the provider fee.
Can I accept credit card payments through an AI agent?
+
Yes. The agent creates a payment order and gives you a payment link. Your customer opens it and pays by credit card, Apple Pay, Google Pay, PayPal or crypto on Paymegate's hosted checkout.
Should I connect my payment account to ChatGPT or Claude?
+
Only grant the permissions you need. Start with read-only access, and add order creation if you want the agent to make payment links. You can revoke the connection from Settings → API keys at any time.
Which MCP clients are supported?
+
Any client that supports remote MCP servers over Streamable HTTP, including Claude, Claude Desktop, Claude Code, ChatGPT, Cursor and VS Code. Clients without OAuth support can use an API key instead.
Learn more
Start accepting payments today
Free signup, no merchant documents, 1% platform fee plus provider fees.
Get started free