How to Use the MintMCP MCP in Windsurf

Q: How do I add MintMCP to my Windsurf configuration?

Open /.codeium/windsurf/mcpconfig.json and add the MintMCP configuration under the mcpServers key. You can also use the Settings UI in Windsurf under Cascade settings to paste your Vinkius connection URL. Restart Cascade, and it will immediately discover the gateway tools.

Q: Can Windsurf Cascade use MintMCP to run multi-step administrative tasks?

Yes, Cascade excels at chaining tools, and it uses mintmcpruntoolaction to step through tasks while the MintMCP gateway checks permissions at each step. If a step violates a policy, the gateway halts the Windsurf chain immediately.

Q: How does MintMCP handle token revocation in Windsurf?

You run mintmcprevokeaccesstoken to kill an active OAuth session inside Windsurf instantly. Cascade will lose access to the underlying MintMCP virtual servers the second the token is severed. This is critical when you need to lock down an active session without editing config files.

Secure your enterprise tool APIs while Cascade runs autonomous multi-step chains inside Windsurf using this MintMCP gateway.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MintMCP MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run proxy actions securely through Windsurf Cascade

`mintmcp_run_tool_action` executes the actual tool payload safely behind the MintMCP gateway. When Cascade plans a long chain of file reads and API calls, this endpoint acts as the single gatekeeper for Windsurf. It keeps your raw backend APIs hidden from the direct execution environment. Your Windsurf agent doesn't need direct access keys to every database or service because MintMCP registers them behind a virtual server. This setup stops autonomous loops in Cascade from executing rogue actions directly on your production infrastructure.

Apply real-time security guardrails on dynamic prompts

`mintmcp_eval_guardrail` intercepts raw inputs from Cascade and filters out sensitive PII or injection attacks before they hit downstream services. Windsurf moves fast when chaining commands. It can easily pass raw code or user data that shouldn't leave your network without MintMCP checking it first. This check happens synchronously inside the MintMCP gateway. The gateway evaluates the Windsurf payloads against your security engines, blocking bad inputs instantly. It keeps your data compliant without forcing you to write custom validation scripts for every single tool on your MCP gateway.

Audit tool execution policies on the fly

`mintmcp_get_tool_policy` checks the exact SOC2 RBAC rules for any tool before Windsurf executes it. You don't want an autonomous Cascade agent stumbling into administrative endpoints. This tool lets your Windsurf agent verify its boundaries using MintMCP before making a call. You also get `mintmcp_list_available_tools` to show Cascade exactly what is permitted in its current Windsurf context. If a tool isn't on the approved MintMCP list for that virtual server, the gateway blocks it. No guesswork, no accidental privilege escalation inside your editor.

Setup guide

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

mcp_config.json

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

Open `~/.codeium/windsurf/mcp_config.json` and add the MintMCP configuration under the `mcpServers` key. You can also use the Settings UI in Windsurf under Cascade settings to paste your Vinkius connection URL. Restart Cascade, and it will immediately discover the gateway tools.

Yes, Cascade excels at chaining tools, and it uses `mintmcp_run_tool_action` to step through tasks while the MintMCP gateway checks permissions at each step. If a step violates a policy, the gateway halts the Windsurf chain immediately.

You run `mintmcp_revoke_access_token` to kill an active OAuth session inside Windsurf instantly. Cascade will lose access to the underlying MintMCP virtual servers the second the token is severed. This is critical when you need to lock down an active session without editing config files.

A virtual server is a logical grouping of tools managed by this MintMCP gateway for Windsurf. You use `mintmcp_list_virtual_servers` to see what environments are configured, and `mintmcp_get_virtual_server` to inspect their setups. This lets you partition tools by Windsurf project or team.

Your parameter strings and access tokens are processed inside ephemeral V8 isolates on the Vinkius MintMCP sandbox. The gateway evaluates these Windsurf payloads against your policies using `mintmcp_eval_guardrail` and logs the telemetry via `mintmcp_fetch_audit_logs`. No raw payload data is stored permanently 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