Skip to main content
GoCardless MCP logo
  • Category: payment processing
  • Auth: DCR_OAUTH
  • Composio-managed OAuth available? No
  • Tools: 24
  • Triggers: 0
  • Slug: GOCARDLESS_MCP
  • Version: 20261018_00

Tools

Slug: GOCARDLESS_MCP_CANCEL_MANDATEPermission required: mandates:write. Ask the user to reconnect GoCardless and grant this permission to enable this tool.
Slug: GOCARDLESS_MCP_CANCEL_PAYMENTPermission required: payments:write. Ask the user to reconnect GoCardless and grant this permission to enable this tool.
Slug: GOCARDLESS_MCP_CREATE_PAYMENTPermission required: payments:write. Ask the user to reconnect GoCardless and grant this permission to enable this tool.
Slug: GOCARDLESS_MCP_CREATE_REFUNDPermission required: refunds:write. Ask the user to reconnect GoCardless and grant this permission to enable this tool.
Slug: GOCARDLESS_MCP_CREATE_SUBSCRIPTIONPermission required: subscriptions:write. Ask the user to reconnect GoCardless and grant this permission to enable this tool.
Slug: GOCARDLESS_MCP_GET_CUSTOMERRetrieve 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 list_customers.

Input Parameters

string
required
Customer ID (e.g. CU000123)
Slug: GOCARDLESS_MCP_GET_ENVIRONMENTReturns the current GoCardless environment (sandbox or live) and step-by-step instructions for switching. Use this when the user asks which environment they are in, wants to switch to live, wants to switch to sandbox, or seems confused about whether they are looking at real or test data.
Slug: GOCARDLESS_MCP_GET_MANDATERetrieve a single mandate (Direct Debit authorisation) by ID. Use when you have a known mandate ID (MD…). To search or filter across mandates, use list_mandates.

Input Parameters

string
required
Mandate ID (e.g. MD000123)
Slug: GOCARDLESS_MCP_GET_PAYMENTRetrieve a single payment by ID. Use when you have a known payment ID (PM…). To search or filter across multiple payments, use list_payments.

Input Parameters

string
required
Payment ID (e.g. PM000123)
Slug: GOCARDLESS_MCP_GET_PAYOUTRetrieve 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 list_payouts.

Input Parameters

string
required
Payout ID (e.g. PO000123)
Slug: GOCARDLESS_MCP_GET_REFUNDRetrieve a single refund by ID. Use when you have a known refund ID (RF…). To search or filter across refunds, use list_refunds.

Input Parameters

string
required
Refund ID (e.g. RF000123)
Slug: GOCARDLESS_MCP_GET_SUBSCRIPTIONRetrieve a single subscription (recurring payment schedule) by ID. Use when you have a known subscription ID (SB…). To search or filter across subscriptions, use list_subscriptions.

Input Parameters

string
required
Subscription ID (e.g. SB000123)
Slug: GOCARDLESS_MCP_INTEGRATE_WITH_GOCARDLESSReturns an overview of GoCardless integration options for collecting one-off and recurring bank payments. This tool returns an overview only — you MUST then call read_gocardless_resource with the relevant URI from the overview before answering the user’s question.
Slug: GOCARDLESS_MCP_LIST_CUSTOMERSList customers, optionally filtered by creation date. PII fields are partially masked. For a single known customer ID, use get_customer.

Input Parameters

string
Cursor for the next page. If the previous response’s next_cursor was non-empty, call this tool again with after=<that value> to fetch the next page. Repeat until next_cursor is absent — do not stop after the first page and present it as complete.
number
Number of results per page (default 50, max 500)
string
Filter: created at or after this ISO 8601 datetime
string
Filter: created at or before this ISO 8601 datetime
string
Sort direction: asc or desc
Slug: GOCARDLESS_MCP_LIST_EVENTSAudit log of state changes across all resources (e.g. payment confirmed, mandate cancelled). Use for audit trails and webhook debugging. Not for querying amounts or counts — use list_payments for that. Note: data older than 18 months may not be available.

Input Parameters

string
Cursor for the next page. If the previous response’s next_cursor was non-empty, call this tool again with after=<that value> to fetch the next page. Repeat until next_cursor is absent — do not stop after the first page and present it as complete.
number
Number of results per page (default 50, max 500)
string
Filter by action (e.g. created, confirmed, failed, paid_out, cancelled)
string
Filter by payout ID
string
Filter by refund ID
string
Filter by mandate ID
string
Filter by payment ID
string
Filter by subscription ID
string
Filter by resource type: payments, mandates, payouts, refunds, subscriptions, instalment_schedules
string
Filter: created at or after this ISO 8601 datetime
string
Filter: created at or before this ISO 8601 datetime
Slug: GOCARDLESS_MCP_LIST_MANDATESSearch or filter mandates (Direct Debit authorisations) by status, customer, or scheme. For a single known mandate ID, use get_mandate.

Input Parameters

string
Cursor for the next page. If the previous response’s next_cursor was non-empty, call this tool again with after=<that value> to fetch the next page. Repeat until next_cursor is absent — do not stop after the first page and present it as complete.
number
Number of results per page (default 50, max 500)
string
Filter by scheme: bacs, sepa_core, ach, autogiro, becs, becs_nz, betalingsservice, faster_payments, pad, pay_to
string
Filter by status: pending_customer_approval, pending_submission, submitted, active, suspended_by_payer, failed, cancelled, expired, consumed, blocked
string
Filter by customer ID
Slug: GOCARDLESS_MCP_LIST_PAYMENTSSearch, filter, or count payments by status, customer, mandate, subscription, currency, or date range. Use for any multi-record query. For a single known payment ID, use get_payment.

Input Parameters

string
Cursor for the next page. If the previous response’s next_cursor was non-empty, call this tool again with after=<that value> to fetch the next page. Repeat until next_cursor is absent — do not stop after the first page and present it as complete.
number
Number of results per page (default 50, max 500)
string
Filter by status: pending_submission, submitted, confirmed, paid_out, cancelled, customer_approval_denied, failed, charged_back
string
Filter by mandate ID (e.g. MD000123)
string
Filter by currency code (e.g. GBP, EUR, USD)
string
Filter by customer ID (e.g. CU000123)
string
Filter by subscription ID (e.g. SB000123)
string
Filter: created at or after this ISO 8601 datetime
string
Filter: created at or before this ISO 8601 datetime
string
Sort direction: asc or desc
Slug: GOCARDLESS_MCP_LIST_PAYOUTSSearch or filter payouts (settlements to your bank account) by status, currency, or date range. For a single known payout ID, use get_payout.

Input Parameters

string
Cursor for the next page. If the previous response’s next_cursor was non-empty, call this tool again with after=<that value> to fetch the next page. Repeat until next_cursor is absent — do not stop after the first page and present it as complete.
number
Number of results per page (default 50, max 500)
string
Filter by status: pending, paid, bounced
string
Filter by currency code (e.g. GBP, EUR, USD)
string
Filter: created at or after this ISO 8601 datetime
string
Filter: created at or before this ISO 8601 datetime
Slug: GOCARDLESS_MCP_LIST_REFUNDSSearch or filter refunds by payment, mandate, or date range. For a single known refund ID, use get_refund.

Input Parameters

string
Cursor for the next page. If the previous response’s next_cursor was non-empty, call this tool again with after=<that value> to fetch the next page. Repeat until next_cursor is absent — do not stop after the first page and present it as complete.
number
Number of results per page (default 50, max 500)
string
Filter by mandate ID
string
Filter by payment ID
string
Filter: created at or after this ISO 8601 datetime
string
Filter: created at or before this ISO 8601 datetime
Slug: GOCARDLESS_MCP_LIST_SUBSCRIPTIONSSearch or filter subscriptions (recurring payment schedules) by status, customer, or mandate. For a single known subscription ID, use get_subscription.

Input Parameters

string
Cursor for the next page. If the previous response’s next_cursor was non-empty, call this tool again with after=<that value> to fetch the next page. Repeat until next_cursor is absent — do not stop after the first page and present it as complete.
number
Number of results per page (default 50, max 500)
string
Filter by status: pending_customer_approval, active, cancelled, finished, paused
string
Filter by mandate ID
string
Filter by customer ID
Slug: GOCARDLESS_MCP_READ_GOCARDLESS_RESOURCEServes GoCardless API documentation, how-to guides, and code samples — not live account data. Use this to fetch API endpoint details, integration guides, and code samples. Available URIs:
  • gocardless://api/endpoints — list of all API endpoints
  • gocardless://api/endpoints/{name} — details of a specific endpoint
  • gocardless://api/code_samples/{language} — all code samples for a language (java, python, ruby, dotnet, php, go, javascript, http)
  • gocardless://api/code_samples/{language}/{endpoint} — code samples for a specific endpoint in a language
  • gocardless://how_to/collect_one-off_payments
  • gocardless://how_to/collect_recurring_payments
  • gocardless://how_to/create_reusable_payment_templates
  • gocardless://how_to/handle_webhooks
  • gocardless://how_to/use_billing_request_with_actions
  • gocardless://how_to/use_custom_payment_pages

Input Parameters

string
required
The gocardless:// resource URI to read
Slug: GOCARDLESS_MCP_SUBMIT_FEEDBACKSubmit 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 they explicitly ask to leave feedback.

Input Parameters

number
required
How helpful was this session? 1 = not helpful at all, 5 = extremely helpful
string
Optional additional feedback