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

AI-generated 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.
Before you install
The server holds a TezTun service token that can mint and revoke other tokens; treat it as a secret. Releasing a subdomain and revoking a service token are destructive and cannot be undone from chat. Reserving subdomains and creating tokens may depend on a paid plan. The launcher may pull and run a Docker image from Docker Hub.

Installation

In SourceWeft

  1. Open Teztun in the dashboard and add it to a workspace.
  2. 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):

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:

  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

ToolWhat it does
get_accountCurrent user (plan, status)
list_tunnelsActive tunnels with their public URLs
list_subdomainsReserved subdomains
reserve_subdomain(name)Reserve a new subdomain (plan-gated)
release_subdomain(id)Release a reserved subdomain (destructive)
list_custom_domainsCustom domains on the Max plan
list_service_tokensService 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

License

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

Source: README.md at commit f78b226

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  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