---
title: thv proxy tunnel
hide_title: true
description: Reference for ToolHive CLI command `thv proxy tunnel`
last_update:
  author: autogenerated
slug: thv_proxy_tunnel
mdx:
  format: md
---

## thv proxy tunnel

Create a tunnel proxy for exposing internal endpoints

### Synopsis

Create a tunnel proxy for exposing internal endpoints.

	TARGET may be either:
  • a URL (http://..., https://...) -> used directly as the target URI
  • a workload name                  -> resolved to its URL

Examples:
  thv proxy tunnel http://localhost:8080 my-server --tunnel-provider ngrok
  thv proxy tunnel my-workload        my-server --tunnel-provider ngrok

Flags:
  --tunnel-provider string   The provider to use for the tunnel (e.g., "ngrok") - mandatory
  --provider-args string     JSON object with provider-specific arguments: auth-token (mandatory),
  							 url, pooling, traffic-policy-file
  --dry-run                  If set, only validate the configuration without starting the tunnel

Examples:
  thv proxy tunnel --tunnel-provider ngrok --provider-args '{"auth-token": "your-token",
  "url": "https://example.com", "pooling": true}' http://localhost:8080 my-server
  thv proxy tunnel --tunnel-provider ngrok --provider-args '{"auth-token": "your-token",
  "traffic-policy-file": "/path/to/policy.yml"}' my-workload my-server


```
thv proxy tunnel [flags] TARGET SERVER_NAME
```

### Options

```
  -h, --help                     help for tunnel
      --provider-args string     JSON object with provider-specific arguments (default "{}")
      --tunnel-provider string   The provider to use for the tunnel (e.g., 'ngrok') - mandatory
```

### Options inherited from parent commands

```
      --debug   Enable debug mode
```

### SEE ALSO

* [thv proxy](thv_proxy.md)	 - Create a transparent proxy for an MCP server with authentication support

