How to Use the Cloudflare Tunnel MCP in Cursor

Q: How do I install the Cloudflare Tunnel MCP Server in Cursor?

Add the configuration to your project-level .cursor/mcp.json file under the mcpServers key. Once saved, Cursor will automatically detect the server and let the AI agent call tools like listtunnels or createtunnel.

Q: Can Cursor Agent automatically configure a new Cloudflare Tunnel?

Yes, the agent can run createtunnel and then use putconfiguration to set up the ingress rules based on the ports defined in your local project files.

Q: How do I retrieve a Cloudflare Tunnel token inside Cursor?

Ask the Cursor Agent to run gettunneltoken for your specific tunnel. It will fetch the token so you can paste it into your local .env file or docker-compose configuration.

Write code and manage your Cloudflare Tunnel environment side-by-side in Cursor using Agent mode.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cloudflare Tunnel MCP to Cursor

Create your Vinkius account to connect Cloudflare Tunnel to Cursor 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 Cloudflare Tunnel with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build and test routes inside Cursor

This Cloudflare Tunnel MCP Server connects your Cursor editor directly to your Zero Trust infrastructure. While writing backend code, you can ask Cursor Agent to run `create_route` to map a new local service to your public hostname immediately. Because Cursor runs these tools in context, it can inspect your active workspace files, read the local port your app is running on, and match it with a `put_configuration` call to align your tunnel settings.

Debug live network configurations as you code

No more guessing why your local webhook receiver is not getting hits. Ask the Cursor Agent to pull your active configuration using `get_configuration` and analyze the routing tables directly in your editor sidebar. If it finds an outdated IP mapping, the agent can execute `update_route` or query `get_route_by_ip` to locate the conflict. It updates your live environment without you ever switching to a browser tab.

Quick cleanup of stale workspace connectors

When switching git branches, stale dev tunnels can pile up. You can have Cursor run `cleanup_connections` to purge inactive connections from your account in seconds using this MCP Server. The agent can also verify the cleanup succeeded by running `list_tunnels` and displaying the current operational state of your tunnels directly inside your active terminal panel.

Setup guide

Set up Cloudflare Tunnel MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Cloudflare Tunnel MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Cloudflare Tunnel transactions." If the MCP tools are loaded correctly, Cursor will call the Cloudflare Tunnel tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "cloudflare-tunnel-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 Cloudflare Tunnel. 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 Cloudflare Tunnel 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 Cloudflare Tunnel MCP in Cursor

Add the configuration to your project-level `.cursor/mcp.json` file under the `mcpServers` key. Once saved, Cursor will automatically detect the server and let the AI agent call tools like `list_tunnels` or `create_tunnel`.

Yes, the agent can run `create_tunnel` and then use `put_configuration` to set up the ingress rules based on the ports defined in your local project files.

Ask the Cursor Agent to run `get_tunnel_token` for your specific tunnel. It will fetch the token so you can paste it into your local `.env` file or docker-compose configuration.

Yes, as long as you provide the correct Cloudflare credentials in your Cursor MCP configuration. The agent can then use `list_tunnels` to filter and manage tunnels across your authorized accounts.

No. Your tunnel tokens, configurations, and routing rules are handled entirely locally on your machine. The MCP server talks directly to Cloudflare's APIs, keeping your sensitive network topology private.

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