Error 402: "the free plan allows 2 tunnel(s)"

Creating a tunnel returned 402 Payment Required:

{
  "error": "the free plan allows 2 tunnel(s) — upgrade your plan to create more"
}

That is the whole body. Unlike the 429 quota response, there is no separate plan field and no upgrade_url — the message is the only machine-readable thing here, so match on the status code rather than trying to parse fields out of it.

The caps

Plan	Tunnels
Free	2
Pro	5
Scale	20

This counts tunnels, not sessions. If you were expecting to be refused for having too many agents connected, that is a different limit — session_limit — and it has its own, more generous caps.

A deleted tunnel may still be holding your slot

The thing that catches people: deleting a tunnel puts it into a 7-day recovery window rather than removing it immediately. During that window it is still a tunnel, and it still counts.

So “I deleted one and I still cannot create another” is expected behaviour, not a bug. The dashboard’s tunnel list shows recently-deleted tunnels separately — either restore the one you actually wanted, or purge it to free the slot now.

Freeing a slot

Consolidate instead of deleting. You may not need another tunnel at all: one tunnel can front several upstream MCP servers at once, with each one’s tools name-prefixed so they do not collide. Two servers that were going to get a tunnel each can share one. See Multi-upstream aggregation.

Purge a recently-deleted tunnel from the dashboard to reclaim its slot immediately.

Upgrade. Pro raises the cap to 5 and Scale to 20. See Billing & plans.

See also

• Multi-upstream aggregation — several servers, one tunnel
• Billing & plans
• Dashboard reference