Summary
This npm package wraps the TezTun tunneling service so you can manage your infrastructure through Claude or any MCP client. It exposes nine tools that let you list active tunnels and their public URLs, reserve and release subdomains, mint and revoke service tokens, and check your account plan. Under the hood it spawns either the TezTun Go CLI or a Docker container, so there's no bundled binary. You'll need a service token from app.teztun.uz to authenticate. Useful when you're debugging webhooks or provisioning ephemeral environments and want your AI editor to handle the TezTun API calls instead of switching to a dashboard or terminal.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →@asadullokhn/teztun-mcp
Official TezTun MCP server, as a single-install npm package for Claude Desktop / Claude Code / Cursor / Zed / Windsurf / any Model Context Protocol client.
Lets your AI editor manage your TezTun infrastructure through chat:
- "What's my current webhook URL?" →
list_tunnels - "Reserve a subdomain called demo" →
reserve_subdomain - "Mint a service token for prod-docker, never expires" →
create_service_token - "Revoke the staging-ci token" →
revoke_service_token
Install & configure
You don't install this manually — MCP clients run it via npx. Pick your client:
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"teztun": {
"command": "npx",
"args": ["-y", "@asadullokhn/teztun-mcp"],
"env": { "TEZTUN_TOKEN": "tzt_your-token-here" }
}
}
}
Claude Code
claude mcp add --scope user teztun \
-e TEZTUN_TOKEN=tzt_your-token-here \
-- npx -y @asadullokhn/teztun-mcp
Cursor / Zed / Windsurf
Each editor has an MCP config file (~/.cursor/mcp.json, etc.). The block shape is the same as the Claude Desktop example above.
Get a service token
Sign up at app.teztun.uz, then mint a service token. On the Max plan ($10/year) tokens never expire — recommended for AI editor use.
How the package works
This package is a thin launcher. It tries, in order:
- If the TezTun CLI (
teztun) is installed, it runsteztun mcp. - If Docker is available, it runs
docker run --rm -i -e TEZTUN_TOKEN asadullokhn/teztun:latest mcp. - Otherwise it errors with install instructions.
No bundled binaries, no postinstall side effects. The MCP server itself is the Go binary from teztun.uz/download, or the asadullokhn/teztun image on Docker Hub.
Exposed tools
| Tool | What it does |
|---|---|
get_account | Current user (plan, status) |
list_tunnels | Active tunnels with their public URLs |
list_subdomains | Reserved subdomains |
reserve_subdomain(name) | Reserve a new subdomain (plan-gated) |
release_subdomain(id) | Release a reserved subdomain (destructive) |
list_custom_domains | Custom domains on the Max plan |
list_service_tokens | Service tokens the user has minted |
create_service_token(name, expiry_seconds?, expire_never?) | Mint a token |
revoke_service_token(id) | Revoke a service token (destructive) |
Links
- Product: https://teztun.uz
- Dashboard: https://app.teztun.uz
- Docs: https://teztun.uz/docs/mcp-server
- API reference: https://teztun.uz/docs/api
- Docker image: asadullokhn/teztun
- Support: support@teztun.uz
License
MIT. Launcher only — the MCP server binary it spawns is the official TezTun client.
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Configuration
TEZTUN_TOKEN*secretA TezTun service token (starts with tzt_). Mint one at https://app.teztun.uz/tokens.
Registryactive
Package@asadullokhn/teztun-mcp
TransportSTDIO
AuthRequired
UpdatedApr 18, 2026