List Tunnels

The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.

Lists tunnels. Results are ordered by creation time, newest first; archived tunnels are excluded unless include_archived is set.

get/v1/tunnels?beta=true

Query parameters

limitinteger

Maximum number of tunnels to return per page. Defaults to 20, maximum 1000.

pagestring

Opaque pagination cursor from a previous list_tunnels response.

include_archivedboolean

Whether to include archived tunnels in the results. Defaults to false.

Headers

x-api-keystring

anthropic-versionstring

anthropic-betastring

Response

Successful response (OK)

next_pagestring nullable required

Pagination cursor for the next page, or null if no more results.

Changes

Changed in 3 of the 68 revisions of this API.25

Aug 17, 2026d2b230555b7f22See the full diff
- ▲
  response property data/items/display_name list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property next_page list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ○
  removed from the // response property allOf list for the response status
  response-property-all-of-removed
- ○
  added subschema #2 to the // response property anyOf list for the response status
  response-property-any-of-added
Jul 17, 20266fbcaa1967b22See the full diff
- ○
  the response property const value tunnel was added for the status
  response-property-const-added
- ○
  removed the tunnel enum value from the // response property for the response status
  response-property-enum-value-removed
Jun 25, 202652cd4fce110f1See the full diff
- ○
  endpoint added
  endpoint-added

Full history