1. Conduid
  2. Blockchain
  3. io.github.asadullokhn/teztun
MCP server · Blockchain

io.github.asadullokhn/teztun

· github.com/asadullokhn/teztun-mcp

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

Unclaimed blockchain
InstallView source
37Low

Scored 4 months ago · breakdown

About io.github.asadullokhn/teztun

io.github.asadullokhn/teztun is an MCP server in the Blockchain category: manage TezTun tunnels, subdomains, and service tokens from any MCP-compatible AI client. It has been installed 0 times through Conduid.

Install

Claude Code
claude mcp add io-github-asadullokhn-teztun -- npx -y @asadullokhn/teztun-mcp
npx
npx -y @asadullokhn/teztun-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about io.github.asadullokhn/teztun

Powered by Claude · Grounded in docs

I know everything about io.github.asadullokhn/teztun. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • ·Scoped permissionsNot checked yet.

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

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

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)

Links

License

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

README mirrored from the source repository 4 months ago. The original is authoritative.

Questions

About io.github.asadullokhn/teztun

How do I install io.github.asadullokhn/teztun?

Run claude mcp add io-github-asadullokhn-teztun -- npx -y @asadullokhn/teztun-mcp, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is io.github.asadullokhn/teztun safe to use with an AI agent?

Its trust score is 37 out of 100 (low). Conduid hasn't run static security checks on this repository yet, so review the source yourself before granting it credentials. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.asadullokhn/teztun still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.