How to Use the Aporia MCP in Windsurf

Q: What happens when Aporia blocks a prompt in Windsurf?

Cascade sees the failure from validateguardrails. It reads the error context, rewrites the prompt to fix the violation, and tests it again until it passes.

Q: Is my prompt data private when using Aporia with Windsurf?

When Cascade sends message arrays to validateguardrails, they pass through Vinkius's V8 Isolate Sandbox. The connection is ephemeral and zero-trust, ensuring we never store your PII or toxicity payloads on disk.

Give Cascade the ability to test your LLM outputs against Aporia guardrails directly inside Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aporia MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let Cascade run the Aporia MCP Server

The Aporia MCP Server lets you check if your model is drifting without switching tabs. Windsurf handles that autonomously now. Tell Cascade to audit your production endpoints, and it pulls down everything using `list_models` and `get_metrics` without asking for permission. If it finds a spike in toxicity or off-topic responses, Cascade doesn't just alert you. It uses `trigger_monitor` to force an immediate evaluation run while you keep coding. You get the results right in your editor.

Test safety rules before shipping

Testing system prompts via the MCP protocol happens instantly in your editor. Writing prompts is easy, but making sure they avoid leaking PII is hard. When you draft a new prompt, Cascade tests it against your safety rules by passing the message array to `validate_guardrails`. You see exactly which inputs fail before you commit the code. If a prompt triggers a block, Cascade rewrites it and tests again. You skip the entire trial-and-error phase in staging.

Pull live dashboards into your IDE

Pulling Aporia telemetry into your IDE gives you the raw numbers to debug hallucinations. Instead of hunting for the right workspace in a browser, ask Windsurf to fetch the data. It calls `list_dashboards` to find the relevant views and `get_model` to grab the specific configuration. You get the context you need to fix the issue right next to your code. If the drift metrics look bad, you know exactly which file needs an update.

Setup guide

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

mcp_config.json

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

Use the built-in MCP Marketplace for a one-click install. You can also edit your `~/.codeium/windsurf/mcp_config.json` file and click Refresh in the MCP panel.

Yes. Cascade chains tools autonomously. It notices a metric drop and fires `trigger_monitor` immediately to investigate the root cause.

Cascade sees the failure from `validate_guardrails`. It reads the error context, rewrites the prompt to fix the violation, and tests it again until it passes.

Yes. The MCP protocol connects directly to your configured environment. You just provide your API token to authenticate the requests.

When Cascade sends message arrays to `validate_guardrails`, they pass through Vinkius's V8 Isolate Sandbox. The connection is ephemeral and zero-trust, ensuring we never store your PII or toxicity payloads on disk.

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