Claude Platform Docs

Tunnels

Create Tunnel
beta.tunnels.create(TunnelCreateParams**kwargs) -> BetaTunnel
POST/v1/tunnels
Get Tunnel
beta.tunnels.retrieve(strtunnel_id, TunnelRetrieveParams**kwargs) -> BetaTunnel
GET/v1/tunnels/{tunnel_id}
List Tunnels
beta.tunnels.list(TunnelListParams**kwargs) -> SyncPageCursor[BetaTunnel]
GET/v1/tunnels
Archive Tunnel
beta.tunnels.archive(strtunnel_id, TunnelArchiveParams**kwargs) -> BetaTunnel
POST/v1/tunnels/{tunnel_id}/archive
Reveal Tunnel Token
beta.tunnels.reveal_token(strtunnel_id, TunnelRevealTokenParams**kwargs) -> BetaTunnelToken
POST/v1/tunnels/{tunnel_id}/reveal_token
Rotate Tunnel Token
beta.tunnels.rotate_token(strtunnel_id, TunnelRotateTokenParams**kwargs) -> BetaTunnelToken
POST/v1/tunnels/{tunnel_id}/rotate_token
Models
class BetaTunnel: …

An MCP tunnel.

id: str

Unique identifier for the tunnel, prefixed with tnl_.

archived_at: Optional[datetime]

A timestamp in RFC 3339 format

formatdate-time
created_at: datetime

A timestamp in RFC 3339 format

formatdate-time
display_name: Optional[str]

Human-readable name for the tunnel (1-255 characters). Null if unset.

domain: str

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: Literal["tunnel"]
class BetaTunnelToken: …

A tunnel's connector token.

id: str

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

tunnel_token: str

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

type: Literal["tunnel_token"]

TunnelsCertificates

Create Tunnel Certificate
beta.tunnels.certificates.create(strtunnel_id, CertificateCreateParams**kwargs) -> BetaTunnelCertificate
POST/v1/tunnels/{tunnel_id}/certificates
Get Tunnel Certificate
beta.tunnels.certificates.retrieve(strcertificate_id, CertificateRetrieveParams**kwargs) -> BetaTunnelCertificate
GET/v1/tunnels/{tunnel_id}/certificates/{certificate_id}
List Tunnel Certificates
beta.tunnels.certificates.list(strtunnel_id, CertificateListParams**kwargs) -> SyncPageCursor[BetaTunnelCertificate]
GET/v1/tunnels/{tunnel_id}/certificates
Archive Tunnel Certificate
beta.tunnels.certificates.archive(strcertificate_id, CertificateArchiveParams**kwargs) -> BetaTunnelCertificate
POST/v1/tunnels/{tunnel_id}/certificates/{certificate_id}/archive