# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Anthropic Tunnels API version: 1.0.0 extends: openapi/anthropic-tunnels-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 10 - target: $.paths['/v1/tunnels/{tunnel_id}/archive?beta=true'].post update: x-apievangelist-phrasing: intent: Archive a tunnel permanently effect: destructive questions: - How do I permanently decommission an MCP tunnel? - Does archiving a tunnel also archive its certificates? instructions: - text: Archive tunnel {tunnel_id}. slots: tunnel_id: path.tunnel_id - text: Decommission MCP tunnel {tunnel_id} for good. slots: tunnel_id: path.tunnel_id method: generated generated: '2026-09-26' - target: $.paths['/v1/tunnels/{tunnel_id}/certificates/{certificate_id}/archive?beta=true'].post update: x-apievangelist-phrasing: intent: Stop trusting a tunnel CA certificate effect: destructive questions: - How do I remove one CA certificate from the set Anthropic trusts for my tunnel? - Is the certificate record kept after I archive it? instructions: - text: Archive certificate {certificate_id} on tunnel {tunnel_id}. slots: certificate_id: path.certificate_id tunnel_id: path.tunnel_id - text: Stop trusting CA cert {certificate_id} for tunnel {tunnel_id}. slots: certificate_id: path.certificate_id tunnel_id: path.tunnel_id method: generated generated: '2026-09-26' - target: $.paths['/v1/tunnels/{tunnel_id}/certificates/{certificate_id}?beta=true'].get update: x-apievangelist-phrasing: intent: Retrieve a tunnel certificate effect: read questions: - Can I look up one CA certificate registered on a tunnel? - Is a given tunnel certificate still active? instructions: - text: Show certificate {certificate_id} on tunnel {tunnel_id}. slots: certificate_id: path.certificate_id tunnel_id: path.tunnel_id - text: Fetch CA cert {certificate_id} of tunnel {tunnel_id}. slots: certificate_id: path.certificate_id tunnel_id: path.tunnel_id method: generated generated: '2026-09-26' - target: $.paths['/v1/tunnels/{tunnel_id}/certificates?beta=true'].get update: x-apievangelist-phrasing: intent: List a tunnel's certificates effect: read questions: - Which CA certificates are registered on my tunnel? - Can I see archived certificates on a tunnel too? instructions: - text: List the certificates on tunnel {tunnel_id}. slots: tunnel_id: path.tunnel_id - text: 'List tunnel {tunnel_id}''s certs with archived included: {include_archived}.' slots: tunnel_id: path.tunnel_id include_archived: query.include_archived method: generated generated: '2026-09-26' - target: $.paths['/v1/tunnels/{tunnel_id}/certificates?beta=true'].post update: x-apievangelist-phrasing: intent: Register a CA certificate on a tunnel effect: write questions: - How do I let Anthropic verify my MCP gateway's server certificate? - What's the size limit for a CA certificate PEM on a tunnel? instructions: - text: Register CA certificate {ca_certificate_pem} on tunnel {tunnel_id}. slots: ca_certificate_pem: requestBody.ca_certificate_pem tunnel_id: path.tunnel_id - text: 'Trust this PEM CA for tunnel {tunnel_id}: {ca_certificate_pem}.' slots: tunnel_id: path.tunnel_id ca_certificate_pem: requestBody.ca_certificate_pem method: generated generated: '2026-09-26' - target: $.paths['/v1/tunnels/{tunnel_id}/reveal_token?beta=true'].post update: x-apievangelist-phrasing: intent: Reveal a tunnel's connector token effect: read questions: - Where do I get the connector token my tunnel client needs? - Does Anthropic store the tunnel connector token? instructions: - text: Reveal the connector token for tunnel {tunnel_id}. slots: tunnel_id: path.tunnel_id - text: Show tunnel {tunnel_id}'s token so I can configure the connector. slots: tunnel_id: path.tunnel_id method: generated generated: '2026-09-26' - target: $.paths['/v1/tunnels/{tunnel_id}/rotate_token?beta=true'].post update: x-apievangelist-phrasing: intent: Rotate a tunnel's connector token effect: destructive questions: - What should I do if my tunnel's connector token leaked? - Can I record why I rotated a tunnel token for audit? instructions: - text: Rotate the connector token on tunnel {tunnel_id}. slots: tunnel_id: path.tunnel_id - text: Rotate tunnel {tunnel_id}'s token with reason {reason}. slots: tunnel_id: path.tunnel_id reason: requestBody.reason method: generated generated: '2026-09-26' - target: $.paths['/v1/tunnels/{tunnel_id}?beta=true'].get update: x-apievangelist-phrasing: intent: Retrieve a tunnel effect: read questions: - What hostname was allocated to one of my tunnels? - Can I check whether a tunnel has been archived? instructions: - text: Show tunnel {tunnel_id}. slots: tunnel_id: path.tunnel_id - text: Get the hostname and status of tunnel {tunnel_id}. slots: tunnel_id: path.tunnel_id method: generated generated: '2026-09-26' - target: $.paths['/v1/tunnels?beta=true'].get update: x-apievangelist-phrasing: intent: List tunnels effect: read questions: - Which MCP tunnels do I have? - Are archived tunnels left out of the list by default? instructions: - text: List my tunnels. - text: 'List tunnels including archived ones: {include_archived}.' slots: include_archived: query.include_archived method: generated generated: '2026-09-26' - target: $.paths['/v1/tunnels?beta=true'].post update: x-apievangelist-phrasing: intent: Create an MCP tunnel effect: write questions: - How do I expose a private MCP server to Claude through a tunnel? - Is creating a tunnel idempotent? instructions: - text: Create a new tunnel. - text: Create a tunnel named {display_name}. slots: display_name: requestBody.display_name method: generated generated: '2026-09-26'