Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

4.7 KB
Raw Blame
# MCP tool definitions. Tools are opt-in: an operation is exposed only when it has an entry here.
# List operations without an entry: pnpm --filter=@posthog/mcp run scaffold-yaml -- --candidates --product proxy-records
# Add one: pnpm --filter=@posthog/mcp run scaffold-yaml -- --add <operationId> --product proxy-records
# To keep an operation off on purpose, set enabled: false and give a disabled_reason.
category: Reverse proxy
feature: reverse_proxy
url_prefix: /settings/organization-proxy
ui_apps: {}
tools:
    proxy-create:
        operation: proxy_records_create
        enabled: true
        scopes:
            - organization:write
        annotations:
            readOnly: false
            destructive: false
            idempotent: false
        title: Create reverse proxy
        description: >
            Create a new managed reverse proxy for a custom domain. Provide the domain (e.g. 'e.example.com') that will
            proxy requests to PostHog. The response includes the CNAME target — the user must add a CNAME DNS record
            pointing their domain to this target. Once DNS propagates, the proxy is automatically verified and an SSL
            certificate is issued. The proxy starts in 'waiting' status until DNS is verified.
        exclude_params:
            - target_cname
            - status
            - message
            - created_at
            - updated_at
            - created_by
    proxy-delete:
        operation: proxy_records_destroy
        enabled: true
        scopes:
            - organization:write
        annotations:
            readOnly: false
            destructive: true
            idempotent: true
        title: Delete reverse proxy
        description: >
            Delete a managed reverse proxy. For proxies still being set up (waiting, erroring, timed_out), the record is
            removed immediately. For active proxies, a cleanup workflow is started to remove the provisioned
            infrastructure.
    proxy-diagnose:
        operation: proxy_records_diagnose_create
        enabled: true
        scopes:
            - organization:write
        annotations:
            readOnly: true
            destructive: false
            idempotent: false
        title: Diagnose reverse proxy
        description: >
            Run a deep diagnostic on a reverse proxy that's stuck or erroring. Inspects the customer's CNAME, the
            certificate provider's hostname state, CAA records walked up the DNS tree (the most common stuck-validation
            cause), HTTP-01 challenge reachability, a live event probe, and certificate expiry. Returns a structured
            report with each check's status and concrete remediation steps — including the exact DNS records the
            customer should add when CAA blocks issuance. Use this when proxy-get returns an erroring or timed_out
            status, or whenever a user asks why their proxy isn't working.
    proxy-get:
        operation: proxy_records_retrieve
        enabled: true
        scopes:
            - organization:read
        annotations:
            readOnly: true
            destructive: false
            idempotent: true
        title: Get reverse proxy details
        description: >
            Get full details of a specific reverse proxy by ID. Returns the domain, CNAME target (the DNS record value
            the user needs to configure), current provisioning status, and any error or warning messages. Use this to
            debug why a proxy isn't working or to check DNS verification status.
    proxy-list:
        operation: proxy_records_list
        enabled: true
        scopes:
            - organization:read
        annotations:
            readOnly: true
            destructive: false
            idempotent: true
        list: true
        title: List reverse proxies
        description: >
            List all managed reverse proxies configured for the current organization. Returns each proxy's domain, CNAME
            target, provisioning status, and the maximum number of proxies allowed by the current plan. Use this to
            check whether a reverse proxy is set up before recommending one.
    proxy-retry:
        operation: proxy_records_retry_create
        enabled: true
        scopes:
            - organization:write
        annotations:
            readOnly: false
            destructive: false
            idempotent: false
        title: Retry reverse proxy provisioning
        description: >
            Retry provisioning a reverse proxy that has failed. Only works for proxies in 'erroring' or 'timed_out'
            status. Resets the proxy to 'waiting' and restarts the DNS verification and certificate provisioning
            workflow.