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.

2.0 KB
Raw Blame
export {
    USER_AGENT,
    type GetUserAgentOptions,
    getUserAgent,
    POSTHOG_US_BASE_URL,
    POSTHOG_EU_BASE_URL,
    toCloudRegion,
    getBaseUrlForRegion,
    getCustomApiBaseUrl,
    getPublicBaseUrl,
    isCloudApi,
    isLocalApi,
    MCP_DOCS_URL,
    OAUTH_SCOPES_HIDDEN,
    OAUTH_SCOPES_SUPPORTED,
} from './oauth-constants'

import { resolveAuthorizationServerUrl } from './oauth-constants'

export const getAuthorizationServerUrl = (): string => resolveAuthorizationServerUrl()

export const MCP_SERVER_NAME = 'PostHog'
export const MCP_SERVER_VERSION = '1.0.0'
export const MCP_ANALYTICS_SOURCE = 'posthog_mcp_analytics'

// Claude Code truncates a server's `instructions` payload at this many characters — silently,
// mid-token, with nothing the model can act on. The compact single-exec payload is sized to
// fit, and the tool-domain index absorbs whatever budget the fixed sections leave.
export const MCP_INSTRUCTIONS_CHAR_BUDGET = 2048

// Response policy, not a token limit: client limits and tokenization vary.
export const MCP_TOOL_OUTPUT_CHAR_BUDGET = 80_000

// Ceiling for the tool-domain index inside the claude.ai exec command reference. That reference
// lives in the `command` description, whose serialized schema claude.ai silently drops past
// ~16,384 chars, and the index is the only part of it that grows with the tool catalog — one new
// tool can split a family into sub-family roots and add hundreds of characters. Bounding it here
// makes `toCompact` trade sub-family precision to stay inside the cap, which costs far less than
// a dropped exec tool.
export const MCP_CLAUDE_TOOL_DOMAINS_CHAR_BUDGET = 1536

// Gates reaching third-party MCP servers connected through the MCP gateway. Same flag as
// the gateway's own UI in the main app, so a team gets the tools when it gets the gateway.
export const MCP_GATEWAY_FLAG = 'mcp-gateway'

// claude.ai silently drops a tool whose serialized `inputSchema` reaches this many characters.
export const CLAUDE_REGISTRY_INPUT_SCHEMA_CHAR_LIMIT = 16_384