GoCardless MCP server. Query GoCardless: customers, mandates, payments, subscriptions, payouts, refunds, events.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"gocardless": {
"url": "https://gocardless.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
gocardless_list_customers | read | List customers List customers (payers) with cursor pagination. Read-only observability. GoCardless: GET /customers. |
gocardless_get_customer | read | Get customer Retrieve a single customer by id. Read-only. GoCardless: GET /customers/{id}. |
gocardless_list_customer_bank_accounts | read | List customer bank accounts List customer bank accounts (account details are masked by GoCardless). Read-only. GoCardless: GET /customer_bank_accounts. |
gocardless_list_mandates | read | List mandates List mandates (a mandate = a customer's authorization to debit their bank account). Read-only. GoCardless: GET /mandates. |
gocardless_get_mandate | read | Get mandate Retrieve a single mandate by id. Read-only. GoCardless: GET /mandates/{id}. |
gocardless_list_payments | read | List payments List payments (READ ONLY — this server never creates or modifies payments). GoCardless: GET /payments. |
gocardless_get_payment | read | Get payment Retrieve a single payment by id. Read-only. GoCardless: GET /payments/{id}. |
gocardless_list_subscriptions | read | List subscriptions List subscriptions (recurring payment schedules). Read-only. GoCardless: GET /subscriptions. |
gocardless_get_subscription | read | Get subscription Retrieve a single subscription by id. Read-only. GoCardless: GET /subscriptions/{id}. |
gocardless_list_payouts | read | List payouts List payouts (funds GoCardless sends to your bank account). Read-only. GoCardless: GET /payouts. |
gocardless_get_payout | read | Get payout Retrieve a single payout by id. Read-only. GoCardless: GET /payouts/{id}. |
gocardless_list_refunds | read | List refunds List refunds (READ ONLY — this server never creates refunds). GoCardless: GET /refunds. |
gocardless_list_events | read | List events List events — the audit / webhook event log (payment confirmed, mandate cancelled, etc.). Read-only. GoCardless: GET /events. |
gocardless_list_creditors | read | List creditors List creditors (your merchant accounts that receive payouts). Read-only. GoCardless: GET /creditors. |
gocardless_create_customer | write | 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_status | 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_upgrade | 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. |
| 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.