English Français العربية

io.github.asadullokhn/teztun

Registre officiel IA et agents

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @asadullokhn/teztun-mcp
Claude Code 
claude mcp add teztun -e 'TEZTUN_TOKEN=<your teztun_token>' -- npx -y @asadullokhn/teztun-mcp@1.0.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "teztun": {
            "command": "npx",
            "args": [
                "-y",
                "@asadullokhn/teztun-mcp@1.0.1"
            ],
            "env": {
                "TEZTUN_TOKEN": "<your teztun_token>"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. @asadullokhn/teztun-mcp
  2. Install & configure
  3. Get a service token
  4. How the package works
  5. Exposed tools
  6. Links
  7. License

@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

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)

License

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

Questions fréquentes

Qu'est-ce que io.github.asadullokhn/teztun ?

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

Comment installer io.github.asadullokhn/teztun ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add teztun -e 'TEZTUN_TOKEN=<your teztun_token>' -- npx -y @asadullokhn/teztun-mcp@1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.asadullokhn/teztun ?

Oui. Il attend TEZTUN_TOKEN, à renseigner dans sa configuration.

io.github.asadullokhn/teztun est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.asadullokhn/teztun ?

Il est publié par asadullokhn. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.