How to Use the Modulr MCP in Windsurf

Q: How do I add the Modulr MCP Server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, use the Settings UI under Cascade to add the server, then click Refresh in the MCP panel to let Cascade discover the seven tools.

Q: Can Windsurf Cascade run bulk SEPA payouts through Modulr?

Yes. Cascade chains modulrcreatebeneficiary and modulrcreatepayment to execute sequential transfers. It handles the dependencies autonomously, meaning you provide the recipient list and Cascade executes the entire pipeline.

Q: How does Windsurf handle Modulr API rate limits during heavy payment runs?

Windsurf monitors tool execution outputs. If modulrlistpayments or transaction queries return a rate limit error, Cascade pauses, reads the error details, and retries the tool call with exponential backoff.

Run multi-step automated payout runs and ledger reconciliations directly inside Windsurf using Cascade.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Modulr MCP to Windsurf

Create your Vinkius account to connect Modulr to Windsurf 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 Modulr with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-step payout chains via Windsurf

`modulr_create_payment` triggers outgoing Faster Payments or SEPA transfers without manual oversight. Cascade reads your local payment files, maps the destination using `modulr_create_beneficiary`, and executes the ledger entry in one single pass. You do not need to prompt Cascade for every individual step. It figures out the dependency graph, checks your live liquidity using `modulr_get_accounts`, and runs the transfers sequentially.

Automated ledger creation with Modulr MCP Server

`modulr_create_account` sets up native UK or EU accounts under specific customer entities. Cascade scans your database schema, matches user sign-ups, and provisions IBANs or virtual accounts programmatically. By connecting this MCP Server, your agent links new sign-ups directly to Modulr's ledger. It queries `modulr_get_customers` to verify legal entities and creates corresponding currency accounts instantly.

Live transaction reconciliation

`modulr_get_transactions` pulls raw transaction histories to reconcile your platform's balances. Cascade compares these bank-level records against your database to flag discrepancies. Instead of exporting CSV files, you ask Windsurf to audit the ledger. It calls `modulr_list_payments` to verify bulk batches and updates your internal database status dynamically.

Setup guide

Set up Modulr MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Modulr MCP

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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Modulr payment history." If connected, Cascade will call the Modulr tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "modulr-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 Modulr Finance. 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 Modulr 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 Modulr MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Alternatively, use the Settings UI under Cascade to add the server, then click Refresh in the MCP panel to let Cascade discover the seven tools.

Yes. Cascade chains `modulr_create_beneficiary` and `modulr_create_payment` to execute sequential transfers. It handles the dependencies autonomously, meaning you provide the recipient list and Cascade executes the entire pipeline.

Windsurf monitors tool execution outputs. If `modulr_list_payments` or transaction queries return a rate limit error, Cascade pauses, reads the error details, and retries the tool call with exponential backoff.

No. The Vinkius platform handles the HMAC-SHA256 signature generation behind the scenes. Your agent calls tools like `modulr_create_payment` using a single endpoint token, eliminating manual cryptographic setup.

All communication runs through a zero-trust V8 Isolate Sandbox on Vinkius. Your European bank account details and transaction records are never stored on disk; they pass through ephemeral memory during active tool execution.

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