{
  "markdown": "# @asadullokhn/teztun-mcp\n\nOfficial [TezTun](https://teztun.uz) MCP server, as a single-install npm package for Claude Desktop / Claude Code / Cursor / Zed / Windsurf / any [Model Context Protocol](https://modelcontextprotocol.io) client.\n\nLets your AI editor manage your TezTun infrastructure through chat:\n\n- *\"What's my current webhook URL?\"* → `list_tunnels`\n- *\"Reserve a subdomain called demo\"* → `reserve_subdomain`\n- *\"Mint a service token for prod-docker, never expires\"* → `create_service_token`\n- *\"Revoke the staging-ci token\"* → `revoke_service_token`\n\n## Install & configure\n\nYou don't install this manually — MCP clients run it via `npx`. Pick your client:\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"teztun\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@asadullokhn/teztun-mcp\"],\n      \"env\": { \"TEZTUN_TOKEN\": \"tzt_your-token-here\" }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add --scope user teztun \\\n  -e TEZTUN_TOKEN=tzt_your-token-here \\\n  -- npx -y @asadullokhn/teztun-mcp\n```\n\n### Cursor / Zed / Windsurf\n\nEach editor has an MCP config file (`~/.cursor/mcp.json`, etc.). The block shape is the same as the Claude Desktop example above.\n\n## Get a service token\n\nSign up at [app.teztun.uz](https://app.teztun.uz), then [mint a service token](https://app.teztun.uz/tokens). On the Max plan ($10/year) tokens never expire — recommended for AI editor use.\n\n## How the package works\n\nThis package is a thin launcher. It tries, in order:\n\n1. If the TezTun CLI (`teztun`) is installed, it runs `teztun mcp`.\n2. If Docker is available, it runs `docker run --rm -i -e TEZTUN_TOKEN asadullokhn/teztun:latest mcp`.\n3. Otherwise it errors with install instructions.\n\nNo bundled binaries, no postinstall side effects. The MCP server itself is the Go binary from [teztun.uz/download](https://teztun.uz/download), or the `asadullokhn/teztun` image on Docker Hub.\n\n## Exposed tools\n\n| Tool | What it does |\n|---|---|\n| `get_account` | Current user (plan, status) |\n| `list_tunnels` | Active tunnels with their public URLs |\n| `list_subdomains` | Reserved subdomains |\n| `reserve_subdomain(name)` | Reserve a new subdomain (plan-gated) |\n| `release_subdomain(id)` | Release a reserved subdomain (destructive) |\n| `list_custom_domains` | Custom domains on the Max plan |\n| `list_service_tokens` | Service tokens the user has minted |\n| `create_service_token(name, expiry_seconds?, expire_never?)` | Mint a token |\n| `revoke_service_token(id)` | Revoke a service token (destructive) |\n\n## Links\n\n- Product: https://teztun.uz\n- Dashboard: https://app.teztun.uz\n- Docs: https://teztun.uz/docs/mcp-server\n- API reference: https://teztun.uz/docs/api\n- Docker image: [asadullokhn/teztun](https://hub.docker.com/r/asadullokhn/teztun)\n- Support: support@teztun.uz\n\n## License\n\nMIT. Launcher only — the MCP server binary it spawns is the official TezTun client.\n",
  "bytes": 3022,
  "sha": "9ce3b4b6f3d172b1017818ee456ed7d85f61286a87ef8f5df6aa1e185651ad2b",
  "repo_slug": "asadullokhn/teztun-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_asadullokhn_teztun_11de5959/readme"
}