io.github.asadullokhn/teztun

Official

by asadullokhn · JavaScript

Manage TezTun tunnels, subdomains, and service tokens from any MCP-compatible AI client.

io.github.asadullokhn/teztun — Model Context Protocol (MCP) Server

This MCP server manages TezTun infrastructure from any MCP-compatible AI client. It provides chat-driven access to TezTun tunnels, subdomains, and service tokens, covering operations like listing tunnels, reserving subdomains, creating service tokens, and revoking existing tokens.

🛠️ Key Features

Manage TezTun tunnels via list_tunnels
Reserve subdomains via reserve_subdomain
Create service tokens via create_service_token
Revoke service tokens via revoke_service_token

🚀 Use Cases

Retrieve the current webhook URL by listing tunnels
Reserve a specific subdomain (e.g., “demo”)
Mint a non-expiring service token for a service (e.g., prod-docker)
Revoke a token for environments like staging-ci

⚡ Developer Benefits

Single-install npm package for MCP clients (e.g., Claude Desktop/Claude Code/Cursor/Zed/Windsurf)
Works with any Model Context Protocol (MCP) client that supports MCP

README.md3 KBView on GitHub

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

json

{
  "mcpServers": {
    "teztun": {
      "command": "npx",
      "args": ["-y", "@asadullokhn/teztun-mcp"],
      "env": { "TEZTUN_TOKEN": "tzt_your-token-here" }
    }
  }
}

Claude Code

bash

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 runs teztun 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)

License

MIT. Launcher only — the MCP server binary it spawns is the official TezTun client.

Install

Configuration

Environment variables

TEZTUN_TOKENrequiredsecret

A TezTun service token (starts with tzt_). Mint one at https://app.teztun.uz/tokens.

Add to VS Code Add to Cursor

claude_desktop_config.json