# GoCardless MCP MCP Server

> **GoCardless MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to GoCardless MCP.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/gocardless-mcp
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Connect GoCardless to AI assistants for payment integration guidance and account management. Retrieve payment, customer, mandate, subscription, payout and refund data, create payments, issue refunds, and access API documentation, webhook patterns and code examples.

---

## Details

- Server ID: `gocardless-mcp`
- Version: cf5798c5149c6aff210aa09756c4caa41a41f6c8
- Tools: 26
- Authentication: OAuth, managed by MewCP
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — GoCardless MCP has to be in the toolset
first. In order:

1. Add GoCardless MCP to your toolset at https://mewcp.com/mcp/gocardless-mcp
2. Connect your GoCardless MCP account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (26)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `cancel_mandate` _(destructive)_ — Cancel a mandate. Also known as: stop a direct debit, revoke a mandate, cancel an authorisation. HIGH-BLAST-RADIUS operation — this also cancels everything…
- `cancel_payment` _(destructive)_ — Cancel a payment before it is submitted to the bank. Also known as: stop a payment, void a payment, withdraw a payment. Two-call pattern: first call with…
- `create_payment` _(destructive)_ — Create a one-off payment against an existing mandate. Also known as: take a payment, charge a customer, collect a payment, debit a customer. Two-call pattern:…
- `create_payment_link` _(write)_ — Create a Billing Request — a single-use GoCardless-hosted authorisation link for one payer. Also known as: payment link, authorisation link, send a payment…
- `create_payment_template_link` _(write)_ — Create a reusable Billing Request Template — a permanent shareable link that creates a new customer session each time it is visited. Also known as: payment…
- `create_refund` _(destructive)_ — Refund all or part of a previously-collected payment back to the payer's bank account. Also known as: issue a refund, send money back, reverse a payment,…
- `create_subscription` _(destructive)_ — Create a recurring subscription against a mandate. Also known as: set up recurring payments, set up a direct debit, schedule regular payments. Two-call…
- `get_customer` _(read)_ — Retrieve a single customer by ID. PII fields are partially masked. Use when you have a known customer ID (CU…). To search or list multiple customers, use…
- `get_environment` _(read)_ — Returns the current GoCardless environment (sandbox or live) and step-by-step instructions for switching. Use this when the user asks which environment they…
- `get_mandate` _(read)_ — Retrieve a single mandate (Direct Debit authorisation) by ID. Use when you have a known mandate ID (MD…). To search or filter across mandates, use…
- `get_payment` _(read)_ — Retrieve a single payment by ID. Use when you have a known payment ID (PM…). To search or filter across multiple payments, use list_payments.
- `get_payment_summary` _(read)_ — Get the count and total amount of payments in a date range, optionally filtered by status, customer, mandate, subscription, or currency. The total is net of…
- `get_payout` _(read)_ — Retrieve a single payout (settlement to your bank account) by ID. Use when you have a known payout ID (PO…). To search or filter across payouts, use…
- `get_refund` _(read)_ — Retrieve a single refund by ID. Use when you have a known refund ID (RF…). To search or filter across refunds, use list_refunds.
- `get_subscription` _(read)_ — Retrieve a single subscription (recurring payment schedule) by ID. Use when you have a known subscription ID (SB…). To search or filter across subscriptions,…
- `integrate_with_gocardless` _(read)_ — Returns an overview of GoCardless integration options for collecting one-off and recurring bank payments. This tool returns an overview only — you MUST then…
- `list_customers` _(read)_ — List customers, optionally filtered by creation date. PII fields are partially masked. For a single known customer ID, use get_customer.
- `list_events` _(read)_ — Audit log of state changes across all resources (e.g. payment confirmed, mandate cancelled). Use for audit trails and webhook debugging. Not for querying…
- `list_mandates` _(read)_ — Search or filter mandates (Direct Debit authorisations) by status, customer, or scheme. For a single known mandate ID, use get_mandate.
- `list_payments` _(read)_ — Search, filter, or count payments by status, customer, mandate, subscription, currency, or date range. Use for any multi-record query. For a single known…
- `list_payouts` _(read)_ — Search or filter payouts (settlements to your bank account) by status, currency, or date range. For a single known payout ID, use get_payout.
- `list_refunds` _(read)_ — Search or filter refunds by payment, mandate, or date range. For a single known refund ID, use get_refund.
- `list_subscriptions` _(read)_ — Search or filter subscriptions (recurring payment schedules) by status, customer, or mandate. For a single known subscription ID, use get_subscription.
- `read_gocardless_resource` _(read)_ — Serves GoCardless API documentation, how-to guides, and code samples — not live account data. Use this to fetch API endpoint details, integration guides, and…
- `submit_feedback` _(write)_ — Submit a rating (1–5) of how helpful this MCP session was. Call this at the end of a session when the user expresses satisfaction or dissatisfaction, or when…
- `update_subscription` _(destructive)_ — Update an existing subscription: change its amount, name, payment reference, metadata or retry setting. Also known as: change a subscription amount, edit a…

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/gocardless-mcp/connect/claude
- ChatGPT: https://mewcp.com/mcp/gocardless-mcp/connect/chatgpt
- VS Code: https://mewcp.com/mcp/gocardless-mcp/connect/vscode
- Cursor: https://mewcp.com/mcp/gocardless-mcp/connect/cursor
- Codex: https://mewcp.com/mcp/gocardless-mcp/connect/codex
- Claude Code: https://mewcp.com/mcp/gocardless-mcp/connect/claude-code
- OpenCode: https://mewcp.com/mcp/gocardless-mcp/connect/opencode
- OpenClaw: https://mewcp.com/mcp/gocardless-mcp/connect/openclaw
- Antigravity: https://mewcp.com/mcp/gocardless-mcp/connect/antigravity
- Hermes: https://mewcp.com/mcp/gocardless-mcp/connect/hermes
- DeepSeek Harness: https://mewcp.com/mcp/gocardless-mcp/connect/dsh
- Python: https://mewcp.com/mcp/gocardless-mcp/connect/python
- TypeScript: https://mewcp.com/mcp/gocardless-mcp/connect/typescript