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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
@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
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →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