
Teztun
io.github.asadullokhnPublished by GitHub account asadullokhnv1.0.1Updated Oct 24, 2026
Manage TezTun tunnels, subdomains, and service tokens from any MCP-compatible AI client.
Overview
Official TezTun MCP server that lets an AI client list tunnels and subdomains and manage service tokens for TezTun tunneling infrastructure.
- What you can do
- Inspect account and tunnels: view the current user's plan and status, active tunnels with public URLs, reserved subdomains, and custom domains
- Manage subdomains: reserve a new subdomain or release an existing one
- Manage service tokens: list minted tokens, create a new token with optional expiry, or revoke a token
- When to use it
- Useful when you run TezTun tunnels and want to check webhook or public URLs, reserve or release subdomains, and mint or revoke service tokens from chat instead of the dashboard.
- Requirements
- Runs locally via npx as a thin launcher; it needs either the TezTun CLI installed or Docker available, otherwise it errors with install instructions. Requires a TezTun account and a service token supplied in the TEZTUN_TOKEN environment variable. Some features are plan-gated, such as custom domains and non-expiring tokens on the Max plan.
Installation
In SourceWeft
- Open Teztun in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
@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):
Claude Code
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
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: [email protected]
License
MIT. Launcher only — the MCP server binary it spawns is the official TezTun client.
Source: README.md at commit f78b226
Tools
0Version history
1- v1.0.1LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts