How to Use the Bolt MCP in Windsurf

Q: Can Windsurf auto-approve refunds on Bolt?

Cascade can chain gettransaction to check a payment and then call refundtransaction to send the money back. It runs these steps autonomously based on your instructions, but you can always review the plan before Cascade executes the refund.

Q: How does Windsurf handle Bolt transaction lists?

The agent uses the listtransactions tool to pull your latest payment records. It parses the JSON payload to show you a clean table of recent charges right inside your Cascade session.

Track transactions and issue checkout refunds directly inside Windsurf without leaving your Cascade workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Bolt MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run checkout flows with Windsurf Cascade

Cascade can kick off a transaction flow by calling `create_order_token` to generate the checkout token. It doesn't ask you for permission at every step, meaning it can immediately chain this to check your setup status using `get_merchant_status` and ensure everything is clear for the buyer. If a customer hits a snag, Cascade reads the context of your chat, pulls the specific checkout data, and coordinates the setup. You get a working checkout flow without manually copying tokens back and forth.

Auto-resolve order disputes in your IDE

When a customer files a dispute, Windsurf uses the `get_transaction` tool to inspect the purchase history. The agent chains this with `get_order_details` to verify the payment status and order contents in one quick run. If the dispute is valid, the agent can execute `refund_transaction` or `void_transaction` right away. You don't have to open a browser tab to log into your merchant dashboard.

Monitor merchant webhooks and account health

Keep tabs on your payment infrastructure by letting your IDE run `list_webhooks` via the MCP Server to check active system integrations. Cascade runs this alongside `get_account_details` to build a quick health report of your active store. This means you can spot disconnected payment endpoints before they impact your sales. The agent handles the discovery and lists the status directly in your Cascade chat panel.

Setup guide

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

mcp_config.json

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

Open your Settings, head to Cascade, and find the MCP Servers UI. Paste your Vinkius endpoint URL there to register the server, or edit the `~/.codeium/windsurf/mcp_config.json` file directly to add it under the mcpServers key.

Cascade can chain `get_transaction` to check a payment and then call `refund_transaction` to send the money back. It runs these steps autonomously based on your instructions, but you can always review the plan before Cascade executes the refund.

The agent uses the `list_transactions` tool to pull your latest payment records. It parses the JSON payload to show you a clean table of recent charges right inside your Cascade session.

Yes, you can tell your agent to cancel an uncaptured payment. It will use the `void_transaction` tool to stop the charge before it settles, saving you from processing fees.

Your raw transaction logs and customer payment tokens are never stored by Vinkius. The server runs inside an ephemeral, zero-trust MCP sandbox that only passes the API responses directly to your local IDE client over a secure connection.

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