How to Use the ngrok MCP in Windsurf

Q: How does Windsurf use ngrok endpoints during autonomous debugging?

Cascade calls listendpoints to grab your active tunnel URLs. It then uses those URLs to run local curl commands or configure test scripts without asking you to find the address.

Q: Does Windsurf need manual approval to check my ngrok IP restrictions?

No, Windsurf executes the listiprestrictions tool autonomously once you enable the server. Cascade analyzes the active IP blocks to troubleshoot connection issues on its own.

Q: What happens if my reserved domains are not configured?

Cascade runs listreserveddomains over the MCP link and alerts you inside the Windsurf terminal if your active project domain is missing. This prevents you from running tests on the wrong host.

Monitor active tunnels and domain configurations inside Windsurf while Cascade chains multi-step local setups.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ngrok MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade tracks live tunnels using the ngrok MCP Server

The `list_endpoints` tool lets Windsurf query your active public tunnels so Cascade can plan its next local testing steps. Instead of making you manually check terminal outputs, Cascade autonomously pulls this endpoint list to map out its local server configuration. When Cascade needs to configure your local test suite, it reads the active tunnel URLs directly. This means your agent can write and run integration tests using the exact live URLs currently exposed on your machine.

Verify security rules before running local tests

The `list_ip_policies` tool exposes your current network access rules directly to the Windsurf editor via the MCP Server connection. Cascade reads these policies to ensure your local development server matches the network restrictions of your staging environment. This security context blocks insecure connections before they hit your machine. You don't have to guess if your local tunnel is wide open to the public internet because your editor checks the restrictions for you.

Audit active API credentials and domains

The `list_api_keys` tool retrieves your active credentials over MCP so Windsurf can verify which keys are currently active in your local workspace. It also queries `list_reserved_domains` to check if your project is running on your company's official test domains. Cascade uses this domain data to automatically update your local environment files with the correct hosts. You skip the manual copy-paste routine when switching between different testing environments.

Setup guide

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

mcp_config.json

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

Cascade calls `list_endpoints` to grab your active tunnel URLs. It then uses those URLs to run local curl commands or configure test scripts without asking you to find the address.

Yes, by setting up read-only tokens on Vinkius. The editor only accesses the `list_api_keys` tool when Cascade explicitly needs to verify credential validity in your workspace.

No, Windsurf executes the `list_ip_restrictions` tool autonomously once you enable the server. Cascade analyzes the active IP blocks to troubleshoot connection issues on its own.

Cascade runs `list_reserved_domains` over the MCP link and alerts you inside the Windsurf terminal if your active project domain is missing. This prevents you from running tests on the wrong host.

Your active endpoints, API keys, and IP policies are processed locally in a secure V8 sandbox. Vinkius handles the MCP connection, ensuring Windsurf only receives the raw list data without exposing your root credentials.

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