The Model Context Protocol (MCP) is an open standard that connects AI applications to external data sources. PayNext hosts two MCP servers:
| Server | URL | Use it for | Sign-in |
|---|
| Documentation | https://docs.paynext.com/mcp | Searching the docs, guides, and API reference | Not required |
| Account | https://mcp.paynext.com/mcp | Reading payments, customers, and subscriptions, plus running analytics | Sign in with PayNext |
Documentation server
The documentation server lets AI tools search PayNext documentation directly instead of relying on training data or web search. You get answers from the latest docs, including new features and API changes, with relevant code examples while you work.
URL: https://docs.paynext.com/mcp
Account server
The account server connects AI tools to your PayNext data. After you sign in, your tools can query and act on your account:
get_payments, get_payment_by_id, get_payment_timeline — find payments and inspect a payment’s full lifecycleget_customers, get_customer_by_id — find customers with their payment methods and subscriptionspayments_analytics_query — totals, breakdowns, and rates such as revenue, acceptance rate, and declinesrefund_payment — refund a settled paymentcancel_subscription — cancel a subscription immediately or at the end of the billing cyclelist_my_organizations, current_organization, set_active_organization — choose which organization the session uses
Ask in plain language — “show last week’s declined payments” or “refund payment pay_…”. Your AI tool picks the right tool and builds the query for you.
URL: https://mcp.paynext.com/mcp
The account server reads and changes live data. The first time you connect, your browser opens to sign in to PayNext and authorize access. refund_payment and cancel_subscription change account state, so your AI tool asks for confirmation before running them.
Cursor
VS Code
Claude
Claude Code
- Press
Cmd + Shift + P (Mac) or Ctrl + Shift + P (Windows) to open the command palette
- Search for Open MCP settings
- Select Add custom MCP to open
mcp.json
- Add the PayNext servers:
{
"mcpServers": {
"PayNext Docs": {
"url": "https://docs.paynext.com/mcp"
},
"PayNext": {
"url": "https://mcp.paynext.com/mcp"
}
}
}
- In Cursor’s chat, ask “What tools do you have available?” to verify the connection
- Create a
.vscode/mcp.json file in your project
- Add the PayNext servers:
{
"servers": {
"PayNext Docs": {
"type": "http",
"url": "https://docs.paynext.com/mcp"
},
"PayNext": {
"type": "http",
"url": "https://mcp.paynext.com/mcp"
}
}
}
- Open Claude and navigate to Settings → Connectors
- Select Add custom connector
- Add the documentation server:
- Name: PayNext Docs
- URL:
https://docs.paynext.com/mcp
- Select Add custom connector again and add the account server:
- Name: PayNext
- URL:
https://mcp.paynext.com/mcp
- Select Add. For the account server, complete the PayNext sign-in when prompted
- When chatting, click the attachments button (plus icon) and select a PayNext server
Run these commands in your terminal:claude mcp add --transport http paynext-docs https://docs.paynext.com/mcp
claude mcp add --transport http paynext https://mcp.paynext.com/mcp
Quick connect
You can also connect the documentation server from any documentation page:
- Click the contextual menu (three dots) at the top of any page
- Select Connect to Cursor or Connect to VS Code for one-click installation
- Or select Copy MCP server URL to get the URL for other tools
