MCP server

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.

expose-mcp

> 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.

Terminal
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.

Terminal
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.

.vscode/mcp.json
{
  "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.

Terminal
amp mcp add expose https://expose.dev/mcp

Then start Amp. It opens your browser so you can sign in to Expose.

Connector URL
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.

App URL
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.completed on a tunnel and hear about failing requests as they come in. How MCP Events work.
  • No opening or replaying. Tunnels still start with expose share on 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.

More for your agent