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

io.github.asadullokhn/teztun

by · github.com/asadullokhn/teztun-mcp

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

Unclaimed last commit 6 months ago blockchain
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.asadullokhn/teztun

io.github.asadullokhn/teztun is an MCP server published by asadullokhn in the Blockchain category: manage TezTun tunnels, subdomains, and service tokens from any MCP-compatible AI client.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

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.

Tools (9)

create_service_token(name, expiry_seconds?, expire_never?)Mint a token

Parameters not published.

get_accountCurrent user (plan, status)

Parameters not published.

list_custom_domainsCustom domains on the Max plan

Parameters not published.

list_service_tokensService tokens the user has minted

Parameters not published.

list_subdomainsReserved subdomains

Parameters not published.

list_tunnelsActive tunnels with their public URLs

Parameters not published.

release_subdomain(id)Release a reserved subdomain (destructive)

Parameters not published.

reserve_subdomain(name)Reserve a new subdomain (plan-gated)

Parameters not published.

revoke_service_token(id)Revoke a service token (destructive)

Parameters not published.

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 presentThe repository ships documentation.

5 checks have not been run 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 copy captured when this server was indexed; it may lag the repository. 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.

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

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.asadullokhn/teztun still maintained?

The last commit was 6 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.