MCP Server

The Model Context Protocol (MCP) is an open standard that connects AI applications to external data sources. With the PayNext MCP servers, you can search the docs or work with your payments, customers, and plans by chatting with your AI tool.

Server	URL	Use it for	Access
Documentation	`https://docs.paynext.com/mcp`	Searching the docs, guides, and API reference	No sign-in
Account	`https://mcp.paynext.com/mcp`	Asking about and acting on your PayNext data in chat	Sign in with your PayNext account
Account, with an API key	`https://mcp.paynext.com/mcp/organization`	Connecting your own software	PayNext API key

Connect one or both. The documentation server is read-only and needs no credentials. The account server works with your live PayNext data, and you connect to it either by signing in or with an API key.

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 gives your AI tool access to your PayNext data, using the same data and rules as the Dashboard. Ask in plain language, and your AI tool picks the right tool and fills in the details:

“Find payments for jane@example.com from last week and tell me why the failed ones failed.”
“Refund pay_123 but keep the customer’s subscription.”
“What was our acceptance rate last month?”
“How did MRR change over the last 3 months?”
“How much revenue did we recognize in September, and how much is still deferred?”
“Add these eight BINs to our block list.”
“Create a monthly Pro plan at 19.99 EUR with a 7-day trial.”
“Which of our API keys haven’t been used this month?”

Answers follow the Dashboard’s rules. A payment the Dashboard wouldn’t let you refund can’t be refunded through your AI tool either. URL: https://mcp.paynext.com/mcp

Add the account server to your AI tool. See Connect to AI tools.
Your browser opens. Sign in with your PayNext account.
On the access screen, review the access your AI tool asks for, then select Approve:
- Read access lets your AI tool look up your data.
- Write access also lets it make changes, such as refunds, cancellations, and plan updates. Without it, every change is refused.
Return to your AI tool. The session starts in the organization you last selected in the Dashboard.

Your AI tool never sees your PayNext password. To check which organization and role a session uses, ask “Which organization am I in?” To move to another of your organizations, ask your AI tool to switch. It may give you a link to open in your browser to finish the switch. If your PayNext sign-in ends, changes stop at once and reads stop within a minute. A sign-in ends when you sign out in the browser you signed in with, or when it expires. Your AI tool then asks you to sign in again. If it doesn’t, remove the account server from your AI tool and add it again.

What you can do

The tools available to you depend on your role. Your AI tool only lists the tools your role allows.

Organizations

Tool	What it does	Roles
`paynext_organization_current`	Shows the organization and role your session uses	All
`paynext_organizations_query`	Lists your organizations and your role in each	All
`paynext_organization_switch`	Moves your session to another of your organizations	All

Payments

Tool	What it does	Changes data	Roles
`paynext_payments_query`	Finds payments with the Dashboard’s filters, or reads one payment		All
`paynext_payment_timeline_get`	Shows one payment’s timeline. Payments created before March 20, 2026 may show a short or empty timeline		All
`paynext_filter_options_query`	Lists the values a Dashboard filter accepts		All
`paynext_payments_analytics_query`	Calculates totals, breakdowns, and rates across payments		Admin, Member
`paynext_payment_refund`	Refunds a payment in full. By default, it also cancels the payment’s subscription, so say whether to cancel or keep it	✓	All

Dashboard

Tool	What it does	Roles
`paynext_overview_metrics_query`	Reads a chart on the Overview tab: authorized, settled, and unsettled volume, acceptance rate, high-risk rate, created payments, tax, 3D Secure authentication rate, or recovered revenue	Admin, Member
`paynext_billing_metrics_query`	Reads a chart on the Billing tab: active subscriptions, MRR, ARR, subscription growth, average revenue per customer, dunning recovery, trial activation, created or cancelled subscriptions, recovered subscriptions, or retention cohorts	Admin, Member
`paynext_active_subscriptions_query`	Counts active subscriptions at the end of a period, the same figure as the Billing tab’s Active subscriptions chart, with the count at the period’s start and the activations and cancellations in between	Admin, Member
`paynext_risk_metrics_query`	Reads a chart on the Risk tab: early fraud warnings, Ethoca alerts, Visa CDRN alerts, Visa RDR, Visa CE 3.0, Order Insights, or Consumer Clarity. See Fraud Prevention	Admin, Member
`paynext_disputes_metrics_query`	Reads a chart on the Disputes tab: dispute rate, dispute outcomes, win rate, or open disputes. See Disputes	Admin, Member
`paynext_revenue_recognition_query`	Reads the Revenue recognition report: period summary, cash vs accrual, deferred revenue roll-forward, revenue waterfall, revenue by plan, journal entries, or monthly totals. See Revenue Recognition	Admin, Member

Customers and subscriptions

Tool	What it does	Changes data	Roles
`paynext_customers_query`	Finds customers with the Dashboard’s filters, or reads one customer with their payment methods and subscriptions		All
`paynext_subscription_cancel`	Cancels a subscription as the Dashboard does. A trial or active subscription ends at the end of the billing cycle, and a past-due one ends immediately. Any other status, such as canceled or already scheduled, is refused	✓	All

Checkout

Tool	What it does	Changes data	Roles
`paynext_checkout_get`	Reads your checkout’s payment methods and bot protection mode		Admin, Member
`paynext_checkout_bot_protection_set`	Sets the bot protection mode to Off, Shadow, or Enforce	✓	Admin

Lists

Tool	What it does	Changes data	Roles
`paynext_lists_query`	Reads Card BIN lists and their BINs		Admin, Member
`paynext_list_create`	Creates a Card BIN list. Lists can’t be deleted	✓	Admin, Member
`paynext_list_add_entries`	Adds BINs to a list	✓	Admin, Member
`paynext_list_remove_entries`	Removes BINs from a list	✓	Admin, Member

Workflows

Tool	What it does	Roles
`paynext_workflows_query`	Reads workflows and their versions	Admin, Member
`paynext_workflow_compare`	Shows what changed between two versions of a workflow	Admin, Member
`paynext_workflow_runs_query`	Shows what your workflows did, with the Dashboard’s counts	Admin, Member

Plans

Tool	What it does	Changes data	Roles
`paynext_plans_query`	Finds plans with the Dashboard’s search and filters, or reads one plan		Admin, Member
`paynext_plan_create`	Creates a plan	✓	Admin, Member
`paynext_plan_update`	Changes a plan’s name, price, billing interval, trial, or tax collection	✓	Admin, Member
`paynext_plan_duplicate`	Duplicates a plan. Without a new name, the copy is named after the original with “(Copy)” added	✓	Admin, Member
`paynext_plan_archive`	Archives a plan	✓	Admin, Member
`paynext_plan_unarchive`	Unarchives an archived plan	✓	Admin, Member

API keys

Tool	What it does	Changes data	Roles
`paynext_api_keys_query`	Lists API keys, their permissions, and when each was last used		Admin, Member
`paynext_api_key_create`	Creates an API key. The key value is shown once	✓	Admin
`paynext_api_key_update`	Changes the permissions you name. The others keep their level, except on an older full-access key with no permissions set, which keeps only the ones you name	✓	Admin
`paynext_api_key_revoke`	Revokes a key permanently	✓	Admin

Integrations

Tool	What it does	Roles
`paynext_processors_query`	Reads your payment processors and their 3D Secure setup	Admin, Member
`paynext_tax_providers_query`	Reads your tax providers	Admin, Member
`paynext_integrations_health_query`	Shows whether your dispute-prevention programs are working for each processor	Admin, Member

Approvals

Tool	What it does	Changes data	Roles
`paynext_approvals_query`	Lists the changes waiting for your approval in this session, and how each ended. A change is listed until your AI tool has its result, and for no more than 10 minutes after it ended		All

“All” means Admin, Member, and Support Specialist. With a role outside these three, your AI tool can look up records, such as payments and customers. It can’t change data or read the Dashboard figures, and it can’t see API keys, processors, tax providers, integration health, or workflow runs.

Dashboard figures

The Dashboard tools return the same figures as the Dashboard charts, so an answer matches what you see on the same tab with the same settings.

Same defaults. Without a date range, each tool reads the period its tab opens on: the last 30 days for Overview, Risk, and Disputes, the last 3 months for Billing, and the last 6 months for Revenue recognition. Open disputes are always as of now. Name a different period, interval, breakdown, or filter in your question, as you would pick it on the tab. A period can’t end after today.
UTC and USD. Dates are in UTC, and amounts are in USD, as on the Dashboard.
Today is still moving. A period that includes today shows it to date, so figures for today can change between two questions.
Unavailable isn’t zero. If a figure can’t be read, your AI tool says it’s unavailable rather than showing 0, and whether asking again can help. If a Revenue recognition report is too large for your AI tool to compute, add filters, such as a processor, payment method, or currency. A shorter period helps less than you might expect.

Before a change runs

Every change runs with your role, in the organization your session was in when your AI tool asked for it.

The account server changes live data. Refunds, subscription cancellations, and revoking an API key can’t be undone. When you sign in, they wait for your approval, and with an API key they run at once.

A rate limit on changes. You can make up to 30 changes per minute in each organization. The limit is yours alone, and your teammates each have their own. Above it, the change isn’t sent, and your AI tool tells you when you can continue. Your approvals in the browser have their own limit of 30 per minute. Above it, the page tells you when to try again, and the link still works.
No silent repeats. If PayNext doesn’t confirm a change, for example after a timeout, your AI tool tells you the result is unknown. Check the record before you try again, so a refund is never sent twice.
Amounts use minor units. 1999 in EUR is 19.99 EUR. See Currencies for currencies with other decimal places.

Approve a change in your browser

When you sign in to the account server, a refund, a subscription cancellation, or revoking an API key waits for your approval. Your AI tool asks, and you decide on a PayNext page. Your AI tool gives you an approval link, or opens it in your browser. Nothing has changed yet. Only you can approve: anyone else who opens the link is refused.

Open the link in a browser signed in to PayNext as yourself, if your AI tool hasn’t opened it for you. If you aren’t signed in, the page takes you to the PayNext sign-in first, then back to the approval page. On the approval page, check that your browser’s address bar shows mcp.paynext.com. If it doesn’t, don’t approve.
Check the action on the page, then select Approve or Reject. Approve runs what the page shows, once. For a refund, that can include the subscription cancellation. Reject changes nothing.
Return to your AI tool. If it hasn’t reported the result, send it any message.

When you select Approve, PayNext reads the record again and sends nothing if the change no longer applies. For example, the payment was already refunded, or a refund’s amount or cancellation differs from what the page showed. PayNext also sends nothing if you left the organization or your role no longer allows the change. The page says why. The change runs in the organization where your AI tool asked for it, even if you’ve switched since. The link works for 10 minutes. After that, nothing changes, and your AI tool can give you a new link. Closing the page, ending the chat, or dismissing your AI tool’s prompt to open the link doesn’t reject the change. Only Reject does. Some AI tools show the link themselves, wait up to 5 minutes for your decision, and report the result in the same reply. Others reply at once and report the result after your next message, or on their own. To check in the same session, ask “What happened to my approvals?” Your AI tool can report a result for up to 10 minutes after the change ends. After that, or in a new chat, ask it to look up the payment, subscription, or API key. If PayNext doesn’t confirm an approved change, your AI tool says it may or may not have happened, and nothing is sent again. Only refunds, subscription cancellations, and API key revocations wait for approval. Every other change runs as soon as your AI tool calls it. That includes creating an API key, and your AI tool sees the new key’s secret. A key with the Refunds: Write permission can refund through an API key connection, where nothing waits. Approval doesn’t protect you from an AI tool you don’t trust, so don’t give one write access.

An approval isn’t a second factor. Anyone, or any AI tool, that can use your signed-in browser can approve. Don’t let an AI tool control the browser you approve in.

Connect your software with an API key

Your own software can connect to the account server without a person signing in. Send your PayNext API key in the Authorization header of every request. Most AI tools accept a configuration like this:

{
  "mcpServers": {
    "PayNext": {
      "url": "https://mcp.paynext.com/mcp/organization",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

With an API key, the account server offers four tools:

Tool	What it does
`paynext_payments_query`	Searches payments with the PayNext search query language
`paynext_customers_query`	Searches customers with the PayNext search query language
`paynext_payment_refund`	Refunds a payment in full. It doesn’t cancel the subscription
`paynext_subscription_cancel`	Cancels a subscription

A search looks like payment_status:"SETTLED" AND amount>5000, which finds settled payments over 5000 in minor units (50.00 in a two-decimal currency). The key’s own permissions decide what each call can do, so a key without the Refunds: Write permission can’t refund. The 30-changes-per-minute rate limit applies to each key. Nothing waits for approval with an API key: a refund or a cancellation runs as soon as your software calls it. For security, the account server refuses any search that mentions network_token, including payment_token_type:"NETWORK_TOKEN". To find a payment by its card, search payment_method.details.bin or payment_method.details.last4. To find a customer by a card, search payment_methods.details.bin or payment_methods.details.last4. You can sort results by any field PayNext supports sorting on. Sorting by a field whose value is always hidden, such as a card number or a token, is refused.

Never expose API keys in frontend code, public repositories, or client-side applications. Create a separate key for each integration, with only the permissions it needs.

Connect to AI tools

Each example adds the documentation server and the account server. Drop the PayNext server if you only need documentation search.

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

Verify the connection:

claude mcp list

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

Introduction

Use Cases

Platform

Payments

Fraud Prevention

Advanced Features

Developers

Documentation server

Account server

What you can do

Dashboard figures

Before a change runs

Approve a change in your browser

Connect your software with an API key

Connect to AI tools

Quick connect

​Documentation server

​Account server

​Sign in and grant access

​What you can do

​Dashboard figures

​Before a change runs

​Approve a change in your browser

​Connect your software with an API key

​Connect to AI tools

​Quick connect

Documentation server

Account server

Sign in and grant access

What you can do

Dashboard figures

Before a change runs

Approve a change in your browser

Connect your software with an API key

Connect to AI tools

Quick connect