Skip to main content
Glama
Sign In
ngsrv-mcp

ngsrv-mcp

Official
by ngsrv
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

@ngsrv/mcp

MCP server for ngsrv tunnels. Expose localhost on public HTTPS from Cursor and other MCP clients.

ngsrv is a developer tunnel tool (CLI, YAML, webhooks). This package is the optional MCP integration.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "ngsrv": {
      "command": "npx",
      "args": ["-y", "@ngsrv/mcp@latest"]
    }
  }
}

First tunnel.start provisions a free 12-hour device trial (no signup). Agent tokens skip the Free-tier visitor warning page.

Optional: NGSRV_API_TOKEN from ngsrv.com → API Tokens → Create agent token.

Related MCP server: tcpsh-mcp

Tools

Tool

Description

tunnel.start

port → public HTTPS URL

tunnel.list

Active tunnels in this process

tunnel.stop

Stop by port

token.provision

12h agent token (trial or refresh)

docs.install

Cursor config + install snippets

Legacy aliases (start_tunnel, etc.) still work.

Registry install (optional)

Some MCP clients support Smithery:

smithery mcp add ngsrv/ngsrv

Docs

Available Tools

5 tools
docs.installInstall helpA
Read-onlyIdempotent

Return ngsrv CLI install commands and MCP client configuration snippets. Call when the user asks how to install ngsrv, configure Cursor, or use npx. Does not start a tunnel.

Inputs: client.

token.provisionProvision agent tokenA
Read-only

Obtain a 12-hour ngsrv agent token for tunnel commands. Uses NGSRV_API_TOKEN when set; otherwise starts a free device trial (no signup). Returns token_prefix and expiry — not the full secret.

Inputs: refresh.

tunnel.listList tunnelsA
Read-onlyIdempotent

List HTTPS tunnels started by this MCP process in the current session. Returns port, public_url, and started_at for each tunnel. Call this before tunnel.stop to confirm which port to close.

Inputs: limit.

tunnel.startStart tunnelA

Expose a local HTTP server on a public HTTPS URL via ngsrv. Returns public_url and local_port. Use for webhooks, OAuth callbacks, and sharing dev servers. Call tunnel.list afterward to see active tunnels.

Inputs: port (required).

tunnel.stopStop tunnelA
DestructiveIdempotent

Stop an ngsrv tunnel started by this MCP session. Pass the same port given to tunnel.start. Call tunnel.list first if you are unsure which ports are active.

Inputs: port (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A4.3/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: installation documentation, token provisioning, and tunnel lifecycle management (list, start, stop). There is no overlap or ambiguity between them.

    Naming Consistency5/5

    All tool names follow a consistent <category>.<action> pattern with lowercase and dots (e.g., docs.install, tunnel.start). No mixing of conventions or styles.

    Tool Count5/5

    Five tools cover the essential operations for the ngsrv tunnel service: installation, token provisioning, and managing tunnels. The count is well-scoped and not excessive.

    Completeness4/5

    The tool surface covers the core workflow (install, auth, start/list/stop tunnels). Minor gaps exist, such as no tool to inspect token details or restart tunnels, but the set is functional for typical use cases.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • rustunnel-mcp

      joaoh82
      A
      license
      A
      quality
      B
      maintenance
      MCP (Model Context Protocol) server for rustunnel. Lets AI agents (Claude Code, Cursor, Windsurf) create and manage public tunnels to local services from inside an agent session.
      6
      663
      AGPL 3.0

    • tcpsh-mcp

      nchgroup
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for interactive TCP connection management, enabling opening listeners, managing sessions, port forwarding, proxy with logging, and local command execution from any MCP host.
      MIT

    • AccelMCP

      t-ogawa-dev
      F
      license
      Not graded
      quality
      C
      maintenance
      An MCP server with HTTP/stdio support, a web admin panel for managing services, capabilities, and user permissions with Bearer token authentication, enabling relay and access control for MCP tools.
      -

    • mcp-server

      gwanghun-choi
      F
      license
      Not graded
      quality
      D
      maintenance
      A universal MCP server for registering internal, external, and OpenAPI-based APIs as MCP tools. It exposes them to MCP clients via Streamable HTTP and provides admin portal, RBAC/session auth, credential injection, and audit logging.
      -

    Appeared in Searches