usefulapi

GoCardless MCP server. Query GoCardless: customers, mandates, payments, subscriptions, payouts, refunds, events.

Claude

  1. Open Settings → Connectors → Add custom connector
  2. Paste this URL:
    https://gocardless.usefulapi.io/mcp
  3. Authenticate with GoCardless when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "gocardless": {
      "url": "https://gocardless.usefulapi.io/mcp"
    }
  }
}
live17 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 17

ToolTypeWhat it does
gocardless_list_customersread
List customers
List customers (payers) with cursor pagination. Read-only observability. GoCardless: GET /customers.
gocardless_get_customerread
Get customer
Retrieve a single customer by id. Read-only. GoCardless: GET /customers/{id}.
gocardless_list_customer_bank_accountsread
List customer bank accounts
List customer bank accounts (account details are masked by GoCardless). Read-only. GoCardless: GET /customer_bank_accounts.
gocardless_list_mandatesread
List mandates
List mandates (a mandate = a customer's authorization to debit their bank account). Read-only. GoCardless: GET /mandates.
gocardless_get_mandateread
Get mandate
Retrieve a single mandate by id. Read-only. GoCardless: GET /mandates/{id}.
gocardless_list_paymentsread
List payments
List payments (READ ONLY — this server never creates or modifies payments). GoCardless: GET /payments.
gocardless_get_paymentread
Get payment
Retrieve a single payment by id. Read-only. GoCardless: GET /payments/{id}.
gocardless_list_subscriptionsread
List subscriptions
List subscriptions (recurring payment schedules). Read-only. GoCardless: GET /subscriptions.
gocardless_get_subscriptionread
Get subscription
Retrieve a single subscription by id. Read-only. GoCardless: GET /subscriptions/{id}.
gocardless_list_payoutsread
List payouts
List payouts (funds GoCardless sends to your bank account). Read-only. GoCardless: GET /payouts.
gocardless_get_payoutread
Get payout
Retrieve a single payout by id. Read-only. GoCardless: GET /payouts/{id}.
gocardless_list_refundsread
List refunds
List refunds (READ ONLY — this server never creates refunds). GoCardless: GET /refunds.
gocardless_list_eventsread
List events
List events — the audit / webhook event log (payment confirmed, mandate cancelled, etc.). Read-only. GoCardless: GET /events.
gocardless_list_creditorsread
List creditors
List creditors (your merchant accounts that receive payouts). Read-only. GoCardless: GET /creditors.
gocardless_create_customerwrite
Create customer
Creates a customer record in GoCardless. Contact details only — no bank account, MOVES NO MONEY. GoCardless: POST /customers (body wrapped as { customers: {...} }).
gocardless_usage_statusmeta
Usage status (free-tier meter)
Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter.
gocardless_upgrademeta
Upgrade to Pro (unlimited)
Subscribe to the Pro plan for UNLIMITED GoCardless tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro$9/mo · $90/yrUnlimited

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.