MCP Server

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

Connect one or both. The documentation server is read-only and needs no credentials. The account server connects to your live PayNext data and requires sign-in.

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 lifecycle
get_customers, get_customer_by_id — find customers with their payment methods and subscriptions
payments_analytics_query — totals, breakdowns, and rates such as revenue, acceptance rate, and declines
refund_payment — refund a settled payment
cancel_subscription — cancel a subscription immediately or at the end of the billing cycle
list_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.

Connect to AI tools

Each example adds both servers. 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

Connect to AI tools

Quick connect

​Documentation server

​Account server

​Connect to AI tools

​Quick connect

Documentation server

Account server

Connect to AI tools

Quick connect