How to Use the Bold MCP in Windsurf

Q: Can Windsurf trigger physical card machines using Bold?

Yes, Cascade can run initiateterminalpayment to send a charge directly to any active physical terminal. It uses listterminals first to grab the correct serial number. This makes hybrid retail operations easy to manage.

Run your Colombian payment operations on autopilot using the Bold MCP Server in Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Bold MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Wire up in-store terminals with Windsurf

`initiate_terminal_payment` lets your AI agent trigger transactions directly on your physical Bold card readers in Colombia. Cascade can look up active hardware using `list_terminals` first to find the right serial number, then fire the transaction without you copying IDs back and forth. This eliminates manual cashier errors during checkout. If a terminal goes offline, the agent checks the connectivity status and alerts the team instantly.

Build on-the-fly payment links via Windsurf MCP Server

`create_payment_link` generates a shareable checkout URL for a specific COP amount and reference. Cascade handles the entire customer billing flow by combining this with your CRM data to draft the email with the link ready to send. Tracking these links doesn't require opening a browser dashboard anymore. You can ask Cascade to run `get_payment_link` to verify if a customer settled their invoice.

Automate payment reconciliation

`create_webhook` registers a new HTTP endpoint in your merchant account so your backend stays updated on transaction states. Cascade can debug webhook issues by running `list_webhooks` and cleaning up dead endpoints with `delete_webhook` autonomously. When a dispute arises, the agent uses `list_transactions` to track down the exact payment. You get a clear picture of your cash flow without digging through spreadsheets.

Setup guide

Set up Bold 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 Bold 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 Bold payment history." If connected, Cascade will call the Bold tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "bold-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 Bold. 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 Bold 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 Bold MCP in Windsurf

Open your settings, go to Cascade, and add the server under the MCP configuration. Alternatively, edit your `~/.codeium/windsurf/mcp_config.json` file directly to include the Vinkius endpoint. Cascade will immediately find the 14 payment tools.

Yes, Cascade can run `initiate_terminal_payment` to send a charge directly to any active physical terminal. It uses `list_terminals` first to grab the correct serial number. This makes hybrid retail operations easy to manage.

You tell Cascade which transaction needs a refund, and it executes `refund_payment` to return the COP amount. It then tracks the status using `get_transaction` to confirm. The money lands back on the customer's card within 5 to 10 business days.

This server operates in Colombian Pesos (COP). Every payment, refund, and terminal transaction requires amounts specified in COP. Anti-fraud checks also run against Colombian compliance standards.

Vinkius hosts the connection in a zero-trust, ephemeral sandbox where your API keys and card tokenization data never persist. Only the necessary transaction payloads pass through to the gateway. No payment credentials or merchant details are ever cached or stored on our 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