How to Use the Checkout.com MCP in Claude

Run your Checkout.com payment operations from your Claude Desktop chat. Capture funds, refund customers, and manage saved payment methods.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Checkout.com MCP to Claude Desktop

Create your Vinkius account to connect Checkout.com to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Checkout.com with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Process payments from a prompt

This tool connects Claude to your Checkout.com account for payment processing. Ask your agent to charge a customer, and it uses `request_payment` to start the transaction through the Headless Gateway. It feels like talking to a finance assistant who can actually move money. Once a payment is authorized, you can tell Claude to lock it in. The agent invokes `capture_payment` to convert that authorization into a settled transaction. No more clicking around in a dashboard to find and capture payments. Just tell your agent what to do.

Handle refunds and voids in seconds

The tool also gives Claude the ability to reverse charges. If you need to send money back to a customer, just ask your agent to issue a refund. It calls `refund_payment` to move the cash directly back to the original card network. You don't have to look up transaction IDs or fill out forms. For charges that haven't settled yet, you can void them to avoid transaction fees. Tell your agent to `void_payment` and it drops the authorization before it closes. It's a faster way to handle cancellations and corrections.

Manage vaulted customer instruments with this MCP Server

Your agent can now manage saved payment methods in the Checkout.com vault. You can ask it to save a new card for a customer using `create_instrument`, which creates a secure token for future billing. This MCP Server makes building a subscriber base much simpler. Need to update or remove a card? Your agent can call `get_instrument` to find the right one, then use `update_instrument` or `delete_instrument` to make changes. It’s a secure way to handle sensitive data without ever seeing the raw card numbers yourself.

Setup guide

Set up Checkout.com MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Checkout.com MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Checkout.com MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under checkoutcom-1-mcp.

json

{
  "mcpServers": {
    "checkoutcom-1-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Checkout.com. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Checkout.com now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Checkout.com MCP in Claude Desktop

You have two options. For local use, install the server via the Extensions menu in the Claude Desktop app. For use in the browser at claude.ai, paste the Vinkius MCP Server URL into the Custom Connectors section in your settings.

You can manage your entire payment lifecycle using natural language. Instead of navigating the Checkout.com dashboard, you just tell your agent what to do—capture a payment, refund a customer, or save a card—right in the chat.

Yes, as long as the original transaction was made through your connected Checkout.com account. Just tell Claude the order or transaction you want to refund, and the `refund_payment` tool handles sending the money back.

Absolutely. Your Checkout.com keys are stored securely by Vinkius. The MCP server runs in a sandboxed, ephemeral environment, and all tool calls are made over encrypted connections. You get the convenience of chat-based commands with the security of the underlying platform.

The server primarily handles payment instrument tokens and transaction IDs from Checkout.com. It doesn't store or log raw credit card numbers. All operations happen within Vinkius's zero-trust environment, which isolates every request and ensures data is only passed to the authorized Checkout.com API.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript