# ngsrv

> ngsrv exposes local services on public HTTPS URLs. CLI (ngsrv), npx (@ngsrv/cli), and MCP (ngsrv-mcp) for Cursor and Claude. Agent tokens (12h), --json output, declarative YAML, custom domains, edge security policies on every plan.

ngsrv is a developer tool for exposing local services on the public internet.

## Cursor MCP

- Public URLs for coding agents in Cursor and Claude — same tunnel platform as the CLI.
- Cursor docs: https://ngsrv.com/docs/ai-agents
- Install: npx ngsrv-mcp@latest in ~/.cursor/mcp.json
- MCP tools: tunnel.start, tunnel.list, tunnel.stop, token.provision, docs.install
- Cursor mcp.json: { "mcpServers": { "ngsrv": { "command": "npx", "args": ["-y", "ngsrv-mcp@latest"] } } }
- Agent tokens: 12h TTL, skip Free interstitial, max 20 per team
- Registry (optional): https://smithery.ai/servers/ngsrv/ngsrv
- Compare vs LivePort: https://ngsrv.com/compare/ngsrv-vs-liveport

ngsrv is a tunnel platform with declarative YAML, edge security on every plan (IP, geo, header auth, time, rate limit, WAF), custom domains, and Kubernetes sidecar metrics. Free tier shows a visitor warning page for browser traffic; agent tokens skip it.

## Key pages

- Home: https://ngsrv.com/
- Get a public URL for localhost: https://ngsrv.com/localhost-public-url
- Pricing: https://ngsrv.com/pricing
- About: https://ngsrv.com/about
- Public FAQ: https://ngsrv.com/faq
- Quickstart: https://ngsrv.com/docs/quickstart
- Documentation index: https://ngsrv.com/docs
- Local development guide: https://ngsrv.com/docs/local-development
- Framework integrations: https://ngsrv.com/docs/frameworks
- DevOps & CI/CD: https://ngsrv.com/docs/devops
- Billing & plans: https://ngsrv.com/docs/billing-plans
- Guides index: https://ngsrv.com/guides
- Security on every plan: https://ngsrv.com/guides/security-without-enterprise-upsell
- How to protect with IP allowlist: https://ngsrv.com/guides/how-to-protect-tunnel-ip-allowlist
- How to protect with geo restrictions: https://ngsrv.com/guides/how-to-protect-tunnel-geo-restrictions
- How to protect with header auth: https://ngsrv.com/guides/how-to-protect-tunnel-header-auth
- How to protect with time-based access: https://ngsrv.com/guides/how-to-protect-tunnel-time-based-access
- How to protect with rate limiting: https://ngsrv.com/guides/how-to-protect-tunnel-rate-limiting
- How to protect with WAF: https://ngsrv.com/guides/how-to-protect-tunnel-waf
- How to protect with mTLS (PAYG+): https://ngsrv.com/guides/how-to-protect-tunnel-mtls

## Use cases

- Expose localhost on any port: https://ngsrv.com/use-cases/expose-localhost
- Test webhooks locally (Stripe, GitHub, Shopify): https://ngsrv.com/use-cases/test-webhooks
- Share a local website with a client: https://ngsrv.com/use-cases/share-local-preview-with-client

## Comparisons

- ngsrv vs ngrok: https://ngsrv.com/compare/ngsrv-vs-ngrok
- ngsrv vs localtunnel: https://ngsrv.com/compare/ngsrv-vs-localtunnel
- ngsrv vs Cloudflare Tunnel: https://ngsrv.com/compare/ngsrv-vs-cloudflared
- ngsrv vs localhost.run: https://ngsrv.com/compare/ngsrv-vs-localhost-run
- ngsrv vs Serveo: https://ngsrv.com/compare/ngsrv-vs-serveo
- ngsrv vs bore: https://ngsrv.com/compare/ngsrv-vs-bore
- ngsrv vs Tailscale Funnel: https://ngsrv.com/compare/ngsrv-vs-tailscale-funnel
- ngsrv vs untun: https://ngsrv.com/compare/ngsrv-vs-untun

## Blog — localhost ports

- How to expose localhost:3000: https://ngsrv.com/blog/how-to-expose-localhost-3000
- How to expose localhost:4200: https://ngsrv.com/blog/how-to-expose-localhost-4200
- How to expose localhost:5173: https://ngsrv.com/blog/how-to-expose-localhost-5173
- How to expose localhost:5000: https://ngsrv.com/blog/how-to-expose-localhost-5000
- How to expose localhost:8000: https://ngsrv.com/blog/how-to-expose-localhost-8000
- How to expose localhost:8080: https://ngsrv.com/blog/how-to-expose-localhost-8080
- How to expose localhost:4242: https://ngsrv.com/blog/how-to-expose-localhost-4242
- How to test webhooks locally: https://ngsrv.com/blog/how-to-test-webhooks-locally

## Blog — frameworks

- Share a Next.js dev server online: https://ngsrv.com/blog/how-to-share-nextjs-dev-server-online
- Share a Vite dev server online: https://ngsrv.com/blog/how-to-share-vite-dev-server-online
- Share a Django dev server online: https://ngsrv.com/blog/how-to-share-django-dev-server-online
- Share a Flask dev server online: https://ngsrv.com/blog/how-to-share-flask-dev-server-online
- Share a Rails dev server online: https://ngsrv.com/blog/how-to-share-rails-dev-server-online
- Share an Express dev server online: https://ngsrv.com/blog/how-to-share-express-dev-server-online
- Share a Laravel dev server online: https://ngsrv.com/blog/how-to-share-laravel-dev-server-online
- Share a FastAPI dev server online: https://ngsrv.com/blog/how-to-share-fastapi-dev-server-online
- Share a Spring Boot dev server online: https://ngsrv.com/blog/how-to-share-spring-boot-dev-server-online
- Share a Remix dev server online: https://ngsrv.com/blog/how-to-share-remix-dev-server-online

## CLI reference

- HTTP tunnels: https://ngsrv.com/docs/cli/http
- TCP tunnels: https://ngsrv.com/docs/cli/tcp
- Serve static files: https://ngsrv.com/docs/cli/serve
- Custom domains: https://ngsrv.com/docs/cli/domains
- Configuration files (ngsrv.yml): https://ngsrv.com/docs/cli/config
- Authentication & version: https://ngsrv.com/docs/cli/auth
- Operations (probes, metrics, exit codes): https://ngsrv.com/docs/cli/ops
- Multi-tunnel run: https://ngsrv.com/docs/cli/run

## Common commands

Expose a local website on port 3000:

    ngsrv http 3000

Expose an Angular / Vite / Next.js dev server on port 4200:

    ngsrv http 4200

Expose a webhook receiver on port 4242 with a reserved subdomain:

    ngsrv http 4242 --subdomain hooks

Run multiple declarative tunnels from a YAML file:

    ngsrv run

Install (macOS / Linux):

    curl -fsSL https://get.ngsrv.com | bash

Install (macOS, Homebrew):

    brew install ngsrv/tap/ngsrv

Install (Windows, PowerShell):

    irm https://get.ngsrv.com/windows | iex

## Positioning

A tunnel you'd commit to git. Less infrastructure wrestling. More shipping.