usefulapi

Checkout.com MCP server. Read Checkout.com payments, disputes, reports and payouts.

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://checkoutcom.usefulapi.io/mcp
Authenticate with Checkout.com when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "checkoutcom": {
      "url": "https://checkoutcom.usefulapi.io/mcp"
    }
  }
}

live18 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 18

Tool	Type	What it does
`checkout_get_payment`	read	Get payment Get the full details of a payment (or payment session) by its id, e.g. 'pay_...'. Checkout.com: GET /payments/{id}.
`checkout_list_payments`	read	List payments by reference List your business's payments that match a given reference. Checkout.com: GET /payments (query parameters). For richer filtering use checkout_search_payments.
`checkout_search_payments`	read	Search payments Search payments using flexible query filters (this is a READ — it queries, it does not mutate). Checkout.com: POST /payments/search. Pass a `query` filter object and/or paging fields.
`checkout_get_payment_actions`	read	Get payment actions List all the actions (authorization, capture, refund, void, etc.) associated with a payment, latest first. Checkout.com: GET /payments/{id}/actions.
`checkout_get_payment_link`	read	Get payment link Retrieve the details and status of a Payment Link by its id, e.g. 'pl_...'. Checkout.com: GET /payment-links/{id}.
`checkout_get_customer`	read	Get customer Get a customer's details (email, name, phone, saved instruments) by id 'cus_...' or by email. Checkout.com: GET /customers/{id}.
`checkout_get_instrument`	read	Get instrument Get the details of a saved payment instrument (tokenized card / bank account) by id 'src_...'. Checkout.com: GET /instruments/{id}.
`checkout_list_disputes`	read	List disputes List disputes (chargebacks) against your business, most-recently-modified first, with optional filters. Checkout.com: GET /disputes.
`checkout_get_dispute`	read	Get dispute Get all the details of a single dispute (reason code, amount, deadline, evidence status) by id 'dsp_...'. Checkout.com: GET /disputes/{id}.
`checkout_list_reports`	read	List reports List the reports available on your account (settlement, payments, etc.) and their details. Checkout.com: GET /reports.
`checkout_get_report`	read	Get report Get the metadata of a specific report (including its downloadable files) by id 'rpt_...'. Checkout.com: GET /reports/{id}.
`checkout_get_forex_rates`	read	Get forex rates Get the indicative foreign-exchange rates Checkout.com uses (e.g. for card payouts). Checkout.com: GET /forex/rates.
`checkout_create_payment`	write	Create payment CREATES a payment (request an authorization, or an immediate capture) — this MOVES MONEY: it charges a card / payment source. Checkout.com: POST /payments. Provide `amount` (minor units), `currency`, and a `source` object such as { type: 'token', token: 'tok_...' }, { type: 'id', id: 'src_...' } (a saved instrument), or { type: 'customer', id: 'cus_...' }.
`checkout_capture_payment`	write	Capture payment CAPTURES a previously authorized payment — this MOVES MONEY: it settles the (full or partial) authorized amount. Checkout.com: POST /payments/{id}/captures.
`checkout_refund_payment`	write	Refund payment REFUNDS a captured payment — this MOVES MONEY BACK to the customer (full or partial). Checkout.com: POST /payments/{id}/refunds.
`checkout_void_payment`	write	Void payment VOIDS (cancels) a payment that has been authorized but not yet captured — this releases the hold on the customer's funds. Checkout.com: POST /payments/{id}/voids.
`checkout_create_payment_link`	write	Create payment link CREATES a hosted Payment Link the customer can pay through — this sets up a way to COLLECT MONEY. Checkout.com: POST /payment-links. Returns a URL to share with the customer.
`checkout_create_customer`	write	Create customer CREATES a customer record (which saved instruments and future payments can be attached to). This ADDS data to your account. Checkout.com: POST /customers.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Pro	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.