ngsrv

Cursor MCP

Optional: expose ngsrv tunnels from Cursor and other MCP clients.

ngsrv is a developer tunnel tool first — CLI, YAML, webhooks, custom domains. ngsrv-mcp adds MCP tools so coding agents can call tunnel.start without leaving the editor.

Cursor config

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ngsrv": {
      "command": "npx",
      "args": ["-y", "ngsrv-mcp@latest"],
      "env": {
        "NGSRV_API_TOKEN": "optional — omit for 12h device trial"
      }
    }
  }
}

First tunnel.start call starts a free 12-hour trial. No credit card. Agent tunnels skip the Free-tier visitor warning page.

MCP tools

  • tunnel.start — port → public HTTPS URL
  • tunnel.list / tunnel.stop
  • token.provision
  • docs.install

Agent tokens (dashboard)

Signed-in: Dashboard → API Tokens → Create agent token. 12-hour TTL, up to 20 per team. Skips visitor warning on Free.

CLI (scripts, not Cursor)

ngsrv agent-token --trial
ngsrv http 3000 --json --no-tui

Registry install (optional)

Some MCP clients support Smithery for install and updates:

smithery mcp add ngsrv/ngsrv

smithery.ai/servers/ngsrv/ngsrv

Compare

ngsrv vs LivePort · ngsrv vs ngrok