How to Use the GoCardless MCP in Claude

Q: Can I use GoCardless with Claude Desktop for recurring billing?

Yes, your agent uses listrecurringsubscriptions to pull active schedules directly into your chat. You can then ask the agent to identify which subscriptions are due for a manual payment adjustment.

Q: How does Claude Desktop handle failed GoCardless payments?

The desktop agent calls listpaymentrefunds to find reversed transactions. It then cross-references these failures with customer details retrieved via getcustomerdetails to build a clean follow-up list.

Track customer bank mandates and trigger direct debit payouts directly inside Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GoCardless MCP to Claude Desktop

Create your Vinkius account to connect GoCardless to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup GoCardless with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Direct Debit Auditing in Claude Desktop

The `list_direct_debit_payments` and `list_merchant_payouts` tools pull real-time settlement data straight into your local Claude Desktop workspace. Your agent reads these financial records to match incoming bank transfers with outstanding invoices without you opening a browser tab. This MCP Server runs as a local subprocess, meaning your transaction logs stay on your machine. You feed the raw payouts data into your local accounting scripts directly through the chat interface.

Check Bank Mandate Status from Your Desktop

The `get_mandate_status` and `list_payment_mandates` tools let Claude Desktop verify active bank authorizations before you trigger a collection. You avoid failed pull requests by having your agent check the actual status of a customer's bank connection first. Running this on the desktop app means you can drag and drop customer CSVs straight into the chat. The local agent parses the file, matches emails using `list_payment_customers`, and flags which accounts lack active mandates.

Trigger GoCardless Collections via Claude Desktop

The `create_new_payment` tool initiates direct debit collections from your chat input. You tell your agent to draft a payment run, and it executes the request using your authenticated local session. Because this MCP setup works via Claude Web custom connectors too, your team can trigger these collections from any browser window. The system uses secure token access to ensure only authorized team members initiate these financial moves.

Setup guide

Set up GoCardless MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The GoCardless MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the GoCardless MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under gocardless-mcp.

json

{
  "mcpServers": {
    "gocardless-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by GoCardless. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect GoCardless now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about GoCardless MCP in Claude Desktop

Add the server configuration to your local config file with your API credentials. Restart the desktop application, and you will see the hammer icon indicating the tools are ready.

Yes, your agent uses `list_recurring_subscriptions` to pull active schedules directly into your chat. You can then ask the agent to identify which subscriptions are due for a manual payment adjustment.

The desktop agent calls `list_payment_refunds` to find reversed transactions. It then cross-references these failures with customer details retrieved via `get_customer_details` to build a clean follow-up list.

No, you can configure a remote MCP URL in the claude.ai browser settings under custom connectors. This allows you to query bank payouts without running local terminal commands.

This MCP integration handles sensitive customer metadata and bank mandate records through a local sandbox environment. Your actual GoCardless API keys stay in your local configuration file and never pass through third-party intermediate servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript