Skip to content
ngrok Agent Skills

ngrok Agent Skills

ngrok's official skill pack: expose localhost, secure endpoints, receive verified webhooks and run an MCP gateway from your coding agent.

GitHub Docs

Install

Install with the skills CLI

One command for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and dozens of other agents. Needs Node.js; the skill is fetched straight from ngrok/skills.

$ npx skills add ngrok/skills

Run it in a terminal. The CLI finds the agents installed on your machine, asks which ones to add the skill to, and whether to install it into the folder you ran it from or for all your projects. It also lists the skills in the repository so you can pick ngrok Agent Skills.

Other ways to install

  1. Open the skill on GitHub and download the folder that holds its SKILL.md.
  2. Put it at ~/.claude/skills/ngrok-agent-skills/, where Claude Code picks it up in every project.

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/ngrok-agent-skills/SKILL.md works too.

Using another agent? Its personal skills folder
Codex
~/.agents/skills/
Cursor
~/.cursor/skills/
GitHub Copilot
~/.copilot/skills/
Gemini CLI
~/.gemini/skills/
Windsurf
~/.codeium/windsurf/skills/
OpenCode
~/.config/opencode/skills/

About

  • Expose local HTTP or TCP services with a public URL
  • Auth, rate limiting and IP rules without app code
  • Webhook receiving with edge signature verification (70+ providers)
  • MCP gateway for servers under development
  • Per-sandbox isolated endpoints
  • Plugin for Claude Code, Cursor, ChatGPT and Codex

A first-party skill pack from ngrok that teaches an AI coding agent how to use ngrok properly instead of guessing at CLI flags. It bundles seven task skills plus two reference skills, all in the open Agent Skills format.

Task skills

  • expose-localhost gives a local service a public URL over HTTP, or raw TCP for SSH, RDP and databases.
  • secure-endpoint puts authentication, rate limiting, IP rules or a custom response in front of an endpoint without changing application code.
  • receive-webhooks receives webhooks from Stripe, GitHub and 70+ other providers with signature verification at ngrok's edge.
  • run-mcp-gateway exposes an MCP server under development so Claude, OpenAI or another provider can reach it, each with its own credential.
  • provision-sandbox-access creates an isolated endpoint per sandbox, container or customer, programmatically.
  • troubleshoot-ngrok diagnoses ngrok error codes.
  • ngrok-setup gets you authenticated and pointed at the right surface (CLI, SDK, API or infrastructure-as-code).

Two reference skills, ngrok-engine (endpoint types and the Traffic Policy rule language) and ngrok-surfaces (CLI, SDKs, REST API, Terraform, Kubernetes Operator), load automatically when needed.

MIT-licensed. Requires the ngrok CLI installed and authenticated; creating Vaults and Secrets from the command line also needs an ngrok API key. Works as a plain skill pack or as a plugin for Claude Code, Cursor, ChatGPT and Codex.

SKILL.md

The instructions your agent loads, as published by ngrok.

SKILL.md

ngrok Agent Skills

A collection of skills for AI coding agents, covering how to expose local services, route and secure traffic, receive webhooks, and more.

Skills follow the Agent Skills format, so this repo works as a standalone skill pack and as a plugin for Claude Code, Cursor, ChatGPT, and Codex.

Installation

Any Agent Skills-compatible agent:

npx skills add ngrok/skills

Or install as a plugin:

  • Claude Code (adds /ngrok:* slash commands):
  /plugin marketplace add ngrok/skills
  /plugin install ngrok@ngrok
  • Cursor: Customize → Plugins → Add marketplace → From GitHub Repository → ngrok/skills.
  • ChatGPT and Codex: run the command below, then restart and install ngrok from the Plugins Directory.
  codex plugin marketplace add ngrok/skills
Skills
SkillCoversUse when
expose-localhostGive a local service a public URL — HTTP, or raw TCP for SSH, RDP, and databases"Expose my local server", "Make my app publicly accessible", "SSH into a box with no public IP"
secure-endpointAuth, rate limiting, IP rules, or a custom response in front of an endpoint, without touching application code"Require Google login on my ngrok URL", "Only allow my office IP range", "Put up a maintenance page"
receive-webhooksReceive webhooks from Stripe, GitHub, and 70+ other providers, with signature verification at the edge"Test Stripe webhooks locally", "One endpoint for webhooks from several providers"
run-mcp-gatewayExpose an MCP server under development so Claude, OpenAI, or another provider can connect to it, each with its own credential"Let Claude connect to my local MCP server"
provision-sandbox-accessGive every sandbox, container, customer device, or tenant its own isolated endpoint, provisioned programmatically from a controlplane"Each sandbox needs its own SSH access", "One endpoint per customer"
troubleshoot-ngrokDiagnose ngrok errors"What does ERR_NGROK_3200 mean?", "Works on localhost, 400 through the ngrok URL"
ngrok-setupGet authenticated and pointed at the right surface — CLI, SDK, API, or infrastructure-as-code"Set up ngrok", "ngrok says I'm not authenticated"
Supporting References

Two skills are reference material rather than tasks. The skills above load them automatically — you do not invoke them directly, but they're installed as part of the set.

SkillCovers
ngrok-engineEndpoint types (agent, cloud, internal), HTTP vs TCP, and Traffic Policy — the rule language, plus a reference for all 26 traffic policy actions
ngrok-surfacesHow to apply configuration on each surface: agent CLI and ngrok.yml, the Go/JavaScript/Python/Rust SDKs, the REST API, Terraform, and the Kubernetes Operator
Usage

Skills are automatically available once installed. The agent uses them when a relevant task is detected.

Examples:

Expose my app on port 3000 to the internet
Share my local server with Google OAuth so only people at @mycompany.com can access it
Receive Stripe webhooks and deliver them to a service that isn't publicly reachable

In Claude Code, you can also invoke a skill directly:

/ngrok:expose-localhost

Each skill contains:

  • SKILL.md — instructions for the agent
  • references/ — supporting documentation (optional)
License

MIT

Install

Harden a Twilio integration against credential leaks and fraud — API keys instead of auth tokens, webhook signature validation, geo-permissions, SMS pumping prevention and zero-downtime credential rotation.

Browse all skills →