Add Expose to your coding agent
Connect Claude Code, Codex, VS Code, Amp, Claude and ChatGPT to your Expose account. Your agent sees your open tunnels and the requests that reached them, so it can tell you why a webhook failed without you copying anything out of the dashboard. It can also manage your reserved subdomains and custom domains, and close your tunnels.
> Did the Stripe webhook reach my app?
↳ expose.list_tunnels()
✓ shop.sharedwithexpose.com → shop.test
↳ expose.list_requests(tunnel="shop…", path="/stripe")
✓ 3 × POST /stripe/webhook, the last one 500
> Why did it fail?
↳ expose.get_request(tunnel="shop…", request_id="…")
✓ Signature check failed: STRIPE_WEBHOOK_SECRET isn't set
> Add it to .env and check the next one.
↳ expose.list_requests(tunnel="shop…", limit=1)
✓ POST /stripe/webhook 200 in 84 ms
> ▍
Connect your agent
Read https://ws.expose.dev/mcp/setup.md and follow it to connect the Expose MCP server.
Paste it into your coding agent. It reads our setup guide, adds the server and asks you to sign in.
claude mcp add --transport http --scope user expose https://expose.dev/mcp
claude mcp login expose
The second command opens your browser so you can sign in to Expose.
codex mcp add expose --url https://expose.dev/mcp
codex mcp login expose
The second command opens your browser so you can sign in to Expose. If add already opens it, sign in there and skip login.
{
"servers": {
"expose": {
"type": "http",
"url": "https://expose.dev/mcp"
}
}
}
Start the server from the file and allow the sign-in when VS Code asks. GitHub Copilot's agent mode can then use the tools.
amp mcp add expose https://expose.dev/mcp
Then start Amp. It opens your browser so you can sign in to Expose.
https://expose.dev/mcp
In Claude on the web or desktop, open Settings → Connectors, add a custom connector with this URL and click Connect to sign in to Expose.
https://expose.dev/mcp
In ChatGPT, turn on developer mode under Settings → Apps → Advanced settings, then create an app with this URL and OAuth. ChatGPT shows your tunnels in an interactive view.
Other apps that support OAuth client metadata documents, such as Zed, Goose and OpenCode, connect with the MCP URL. Cursor, Gemini CLI and Cline can't sign in to Expose yet.
MCP URL
Copy this URL into any client that adds MCP servers by URL. You sign in to Expose with OAuth the first time a tool needs your account.
https://expose.dev/mcp
What your agent can do
- Your permissions, nothing more. The agent can reserve and release subdomains, manage custom domains and close your own tunnels, with your plan's limits. It can only release or remove what you reserved or added yourself, and your client asks you before each change.
- Events, not polling. ChatGPT can subscribe to
request.completedon a tunnel and hear about failing requests as they come in. How MCP Events work. - No opening or replaying. Tunnels still start with
expose shareon your machine. - Recent requests, also of closed tunnels. The last 50 requests of an open tunnel in full for 30 minutes. For tunnels opened with Expose 4, method, path, status and sizes for 24 hours (72 on Pro and Team), with query values masked, or the whole requests with body capture turned on in your profile.
- No secrets. Authorization headers, cookies, signatures, secret query values and visitor IP addresses are removed before a request is stored.
- Disconnect any time. Remove any agent on your profile page.
Tools
- expose.list_tunnels
- Your open tunnels across all regions and teams, with their public URLs and local targets.
- expose.show_tunnels
- The same tunnels in an interactive view, in ChatGPT and other clients with MCP Apps.
- expose.list_requests
- The latest requests of a tunnel with method, path, status and duration. Filters by method, status or path.
- expose.get_request
- Headers and the first 8 KiB of the body of one request and its response.
- expose.close_tunnel
- Closes one of your own open HTTP tunnels, without the client reconnecting.
- expose.list_domains
- Your teams' reserved subdomains and custom domains, with the DNS records still to create and what is left of your limits.
- expose.reserve_subdomain
- Reserves a subdomain on an Expose server for your team.
- expose.release_subdomain
- Releases a subdomain you reserved.
- expose.add_custom_domain
- Adds a custom domain to your team and returns the CNAME record to create.
- expose.verify_custom_domain
- Checks the CNAME record of a custom domain and activates the domain.
- expose.set_custom_404_page
- Sets or removes the 404 page of a custom domain you added.
- expose.remove_custom_domain
- Removes a custom domain you added.
- expose.get_profile
- The Expose account you signed in with.
Try a prompt
Share a site with expose share, then ask your agent.
- Webhooks Did the last Stripe webhook reach my app, and what did my app answer?
- Debug My tunnel returned 500s in the last few minutes. Find out why and fix it.
- Compare The iOS app gets a 401 from my API through Expose, the browser doesn't. Compare the two requests.
- Tunnels Which of my tunnels points at localhost:3000, and what is its public URL?
- Domains Reserve the subdomain acme-demo on eu-1 and tell me how to share my site on it.