Skip to main content
Glama
ngsrv-mcp
by ngsrv
README.md
# @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`:

```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](https://ngsrv.com/login) → API Tokens → Create agent token.

## 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](https://smithery.ai/servers/ngsrv/ngsrv):

```bash
smithery mcp add ngsrv/ngsrv
```

## Docs

- [Cursor MCP setup](https://ngsrv.com/docs/ai-agents)
- [Support](https://ngsrv.com/faq)

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