How to Use the ngrok MCP in Claude Code

Q: How do I pipe active ngrok endpoints into other tools with Claude Code?

You can ask Claude Code to run listendpoints and output the raw JSON via MCP. The CLI agent then pipes that address directly into curl, grep, or your custom shell scripts.

Pipe active tunnel URLs and security policies directly into your terminal workflows using Claude Code.

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 Claude Code

Create your Vinkius account to connect ngrok to Claude Code 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pipe live tunnel outputs directly into terminal scripts

The `list_endpoints` tool outputs your live public tunnel addresses directly to Claude Code over MCP. You can tell the CLI to fetch this list and pipe the active URLs into other command-line utilities. This allows you to automate local webhook testing without leaving the terminal. Claude Code grabs the active endpoint, runs your local test runner, and filters the output based on the live traffic.

Inspect security rules inside your CLI workflows

The `list_ip_policies` tool lets Claude Code audit your network access rules directly via the MCP Server. SREs and DevOps engineers can use this tool to verify that local tunnels comply with corporate security standards. The CLI agent checks both `list_ip_restrictions` and active policies to ensure no unauthorized traffic can reach your local machine. This keeps your terminal-based testing secure without requiring a web browser interface.

Manage domains and keys using the ngrok MCP Server

The `list_reserved_domains` tool allows Claude Code to fetch your static domains during automated build scripts. Your CLI agent queries this list to ensure your deployment scripts target the correct production or staging hosts. It also uses `list_api_keys` to verify which credentials are active before initiating new tunnel sessions. This prevents script failures caused by expired or invalid API keys.

Setup guide

Set up ngrok MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see ngrok-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest ngrok transactions." It will automatically discover and invoke the available ngrok tools.

Terminal

claude mcp add --transport http ngrok-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "ngrok-mcp": {
      "type": "url",
      "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 Claude Code

You can ask Claude Code to run `list_endpoints` and output the raw JSON via MCP. The CLI agent then pipes that address directly into curl, grep, or your custom shell scripts.

No, the server only supports read-only operations. Claude Code can run `list_ip_policies` to inspect your rules, but it cannot modify them from the command line.

The CLI agent uses the secure transport layer managed by Vinkius. You configure your token once, and Claude Code queries `list_api_keys` and other endpoints without needing raw credentials stored in your shell history.

Claude Code detects the connection drop and displays a standard exit code. You can quickly verify the status by running the list command in your terminal.

Your list of reserved domains, API keys, and active tunnels is transmitted over encrypted SSH/HTTP tunnels. Vinkius processes these MCP requests in an isolated, zero-trust sandbox, ensuring no configuration data is cached or stored.

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