Tunnels

Create Tunnel

beta.tunnels.create(**kwargs) -> BetaTunnel

POST/v1/tunnels

Get Tunnel

beta.tunnels.retrieve(tunnel_id, **kwargs) -> BetaTunnel

GET/v1/tunnels/{tunnel_id}

List Tunnels

beta.tunnels.list(**kwargs) -> PageCursor<BetaTunnel>

GET/v1/tunnels

Archive Tunnel

beta.tunnels.archive(tunnel_id, **kwargs) -> BetaTunnel

POST/v1/tunnels/{tunnel_id}/archive

Reveal Tunnel Token

beta.tunnels.reveal_token(tunnel_id, **kwargs) -> BetaTunnelToken

POST/v1/tunnels/{tunnel_id}/reveal_token

Rotate Tunnel Token

beta.tunnels.rotate_token(tunnel_id, **kwargs) -> BetaTunnelToken

POST/v1/tunnels/{tunnel_id}/rotate_token

Models

class BetaTunnel { id, archived_at, created_at, 3 more }

An MCP tunnel.

id: String

Unique identifier for the tunnel, prefixed with tnl_.

archived_at: Time

A timestamp in RFC 3339 format

formatdate-time

created_at: Time

A timestamp in RFC 3339 format

formatdate-time

display_name: String

Human-readable name for the tunnel (1-255 characters). 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.

type: :tunnel

class BetaTunnelToken { id, tunnel_token, type }

A tunnel's connector token.

id: String

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

tunnel_token: String

The connector token used to run the tunnel. Treat as a credential.

type: :tunnel_token

TunnelsCertificates

Create Tunnel Certificate

beta.tunnels.certificates.create(tunnel_id, **kwargs) -> BetaTunnelCertificate

POST/v1/tunnels/{tunnel_id}/certificates

Get Tunnel Certificate

beta.tunnels.certificates.retrieve(certificate_id, **kwargs) -> BetaTunnelCertificate

GET/v1/tunnels/{tunnel_id}/certificates/{certificate_id}

List Tunnel Certificates

beta.tunnels.certificates.list(tunnel_id, **kwargs) -> PageCursor<BetaTunnelCertificate>

GET/v1/tunnels/{tunnel_id}/certificates

Archive Tunnel Certificate

beta.tunnels.certificates.archive(certificate_id, **kwargs) -> BetaTunnelCertificate

POST/v1/tunnels/{tunnel_id}/certificates/{certificate_id}/archive