Claude MarketplacesSubmit
asadullokhn avatar

Teztun

asadullokhn/teztun-mcp

This npm package wraps the TezTun tunneling service so you can manage your infrastructure through Claude or any MCP client. It exposes nine tools that let you list active tunnels and their public URLs, reserve and release subdomains, mint and revoke service tokens, and check your account plan. Under the hood it spawns either the TezTun Go CLI or a Docker container, so there's no bundled binary. You'll need a service token from app.teztun.uz to authenticate. Useful when you're debugging webhooks or provisioning ephemeral environments and want your AI editor to handle the TezTun API calls instead of switching to a dashboard or terminal.

tools
5
auth
Secret needed
transport
STDIO
env var
1
last updated
Apr 18, 2026
View on GitHub

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

get_accountCurrent user (plan, status)

Current user (plan, status)

No parameter schema in public metadata yet.

list_tunnelsActive tunnels with their public URLs

Active tunnels with their public URLs

No parameter schema in public metadata yet.

list_subdomainsReserved subdomains

Reserved subdomains

No parameter schema in public metadata yet.

list_custom_domainsCustom domains on the Max plan

Custom domains on the Max plan

No parameter schema in public metadata yet.

list_service_tokensService tokens the user has minted

Service tokens the user has minted

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

TEZTUN_TOKEN*secret

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

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

{
  "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

View the full README on GitHub

Details

Repository
github.com/asadullokhn/teztun-mcp
Package
@asadullokhn/teztun-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active