Claude Platform Docs

MCP Tunnels

List Tunnels
Deprecated
GET/v1/organizations/tunnels
Requires anthropic-beta: mcp-tunnels-2026-05-19. How to send beta headers

Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.

Get Tunnel
Deprecated
GET/v1/organizations/tunnels/{tunnel_id}
Requires anthropic-beta: mcp-tunnels-2026-05-19. How to send beta headers

Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.

Archive Tunnel
Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/archive
Requires anthropic-beta: mcp-tunnels-2026-05-19. How to send beta headers

Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.

Reveal Tunnel Token
Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/reveal_token
Requires anthropic-beta: mcp-tunnels-2026-05-19. How to send beta headers

Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.

Rotate Tunnel Token
Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/rotate_token
Requires anthropic-beta: mcp-tunnels-2026-05-19. How to send beta headers

Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.

Models
BetaOrganizationTunnel object{ type: "tunnel", id, archived_at, 4 more }
type: "tunnel"

Object type. Always tunnel for Tunnels.

defaulttunnel
id: string

ID of the Tunnel.

archived_at: string or null

RFC 3339 datetime string indicating when the Tunnel was archived, or null if it is not archived.

formatdate-time
created_at: string

RFC 3339 datetime string indicating when the Tunnel was created.

formatdate-time
display_name: string or null

Human-readable name for the Tunnel (1–255 characters), or null if unset.

domain: string

Anthropic-assigned hostname for the Tunnel. MCP server URLs whose host is a subdomain of this value are routed through the Tunnel. Globally unique and never reused, even after the Tunnel is archived.

workspace_id: string or null

ID of the Workspace this Tunnel belongs to. May be null for a Tunnel in the default Workspace. A Tunnel never moves to another Workspace.

BetaOrganizationTunnelToken object{ type: "tunnel_token", id, tunnel_token }
type: "tunnel_token"

Object type. Always tunnel_token for Tunnel Tokens.

defaulttunnel_token
id: string

Stable identifier for the current token value. Changes when the token is rotated.

tunnel_token: string

The tunnel's connection token.

MCP TunnelsTunnel Certificates

Create Tunnel Certificate
Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/certificates
Requires anthropic-beta: mcp-tunnels-2026-05-19. How to send beta headers

Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.

List Tunnel Certificates
Deprecated
GET/v1/organizations/tunnels/{tunnel_id}/certificates
Requires anthropic-beta: mcp-tunnels-2026-05-19. How to send beta headers

Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.

Get Tunnel Certificate
Deprecated
GET/v1/organizations/tunnels/{tunnel_id}/certificates/{certificate_id}
Requires anthropic-beta: mcp-tunnels-2026-05-19. How to send beta headers

Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.

Archive Tunnel Certificate
Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/certificates/{certificate_id}/archive
Requires anthropic-beta: mcp-tunnels-2026-05-19. How to send beta headers

Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.