teztun-mcp

@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:

1. If the TezTun CLI (teztun) is installed, it runs teztun mcp.
2. If Docker is available, it runs docker run --rm -i -e TEZTUN_TOKEN asadullokhn/teztun:latest mcp.
3. 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.