How to Use the GoCardless MCP in LangChain

Q: How do I connect the GoCardless MCP Server to LangChain?

Install the langchain-mcp-adapters package and initialize a MultiServerMCPClient pointing to your Vinkius endpoint. From there, pull the tools via client.gettools() and pass them directly to your agent constructor to start executing bank payments.

Q: Can my LangChain agent handle recurring subscription billing using GoCardless?

Yes, your agent can manage subscriptions by calling listrecurringpayments to check active plans and using collectpayment to trigger the next billing cycle. The agent evaluates the payment history and decides whether to issue a new charge or pause the account.

Run multi-step direct debit workflows directly inside your LangChain pipelines to collect bank payments using this MCP Server.

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 LangChain

Create your Vinkius account to connect GoCardless to LangChain 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 LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate bank collections in LangChain chains

The GoCardless MCP Server exposes `collect_payment` and `create_new_customer` to your LangChain agent, letting it handle the entire payment collection pipeline autonomously. Your agent receives a billing trigger, checks if the customer exists, creates one if missing, and initiates the direct debit pull. This setup avoids the typical manual back-and-forth of payment operations. By linking these tools inside an agentic chain, you get instant execution and can trace every single parameter and response payload inside LangSmith.

Validate mandate status before pulling funds

Checking authorization status with `list_active_mandates` and `get_mandate_details` prevents failed transaction fees before you attempt to pull money. Your agent runs these checks automatically as a pre-flight step in your billing chain. If a customer lacks an active mandate, the agent stops the chain and routes them to a setup flow. You save money on failed payment penalties and keep your billing database clean without manual audits.

Handle payment failures and cancellations

Controlling active transactions requires using `get_payment_status` and `stop_pending_payment` to halt billing runs before bank clearing cycles close. Your LangChain agent monitors the clearing window and executes cancellations when users cancel subscriptions mid-cycle. You feed live event streams directly into your decision chains using `list_system_events`. This ensures your application reacts to bank failures within hours instead of waiting days for manual bank statements.

Setup guide

Set up GoCardless MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes GoCardless tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "gocardless-alternative-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent GoCardless transactions"
    })
    print(result["messages"][-1].content)

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 LangChain

Install the `langchain-mcp-adapters` package and initialize a `MultiServerMCPClient` pointing to your Vinkius endpoint. From there, pull the tools via `client.get_tools()` and pass them directly to your agent constructor to start executing bank payments.

Yes, your agent can manage subscriptions by calling `list_recurring_payments` to check active plans and using `collect_payment` to trigger the next billing cycle. The agent evaluates the payment history and decides whether to issue a new charge or pause the account.

The agent catches the API error or reads a failed status from `get_payment_status`. You can configure your chain to automatically trigger a notification workflow or retry the collection depending on the failure reason.

Use LangSmith tracing to monitor every tool call. You will see the exact inputs sent to `list_payment_history` and the raw JSON response returned by the server, making debugging easy.

This server only processes bank account tokens, customer names, and transaction histories through Vinkius's secure sandboxed V8 isolates. Your actual bank credentials and customer payment details are never stored on the host, maintaining direct bank-to-client security.

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