{"guide":{"$schema":"https://raw.githubusercontent.com/apideck-libraries/mcp-connect/main/proposals/connection-guide/0.1/schema.json","specVersion":"0.1-draft","id":"https://raw.githubusercontent.com/apideck-libraries/mcp-connect/main/proposals/connection-guide/0.1/catalog/guides/posthog-posthog.json","title":"PostHog MCP Server connection guide","locale":"en","binding":{"serverId":"io.github.PostHog/mcp","connectionId":"posthog-posthog","source":{"format":"mcp-registry-server-json","url":"https://raw.githubusercontent.com/apideck-libraries/mcp-connect/main/proposals/connection-guide/0.1/catalog/sources/posthog-posthog.json","schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","sha256":"dffbe078ccf060ea6b29bca54a2404f2f7f52d4a3f36306e91609e290aa71f47"},"pointer":"/remotes/0"},"inputs":[{"id":"input-1","sourcePointer":"/remotes/0/headers/0/variables/api_key"}],"authentication":{"clientToServer":{"id":"mcp-access","scheme":"api-key","credentialSource":"user","inputRefs":["input-1"],"evidenceRefs":["registry"]},"downstreamStatus":"unknown","serverToApi":[]},"steps":[{"id":"review-setup","kind":"open-url","title":"Review the project’s setup and account requirements","url":"https://github.com/PostHog/posthog","evidenceRefs":["project"]},{"id":"configure-1","kind":"input","title":"Required: api_key","inputRef":"input-1","evidenceRefs":["registry"]},{"id":"review-authentication","kind":"manual","title":"Confirm credentials and permissions before connecting","text":"Review the project documentation for account access, permissions and OAuth or credential requirements. Missing Registry headers do not imply anonymous access. Downstream authentication has not been established by this guide.","evidenceRefs":["registry","project"]},{"id":"initialize","kind":"verify","title":"Initialize the MCP connection after setup","check":"initialize","evidenceRefs":["registry"]}],"evidence":[{"id":"registry","url":"https://registry.modelcontextprotocol.io/v0.1/servers/io.github.PostHog%2Fmcp/versions/1.0.1","reviewedAt":"2026-10-24","kind":"registry-metadata"},{"id":"project","url":"https://github.com/PostHog/posthog","reviewedAt":"2026-10-24","kind":"project-documentation"}],"extensions":{"apideck.com/generation":{"status":"generated-needs-review","repository":"https://github.com/PostHog/posthog","repositoryStars":40392,"rankingObservedAt":"2026-10-24T00:01:33.635683+00:00","rank":8,"downstreamAuthenticationReviewed":false,"declaredInputCount":1,"includedInputCount":1}}},"source":{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","name":"io.github.PostHog/mcp","description":"Official PostHog MCP Server for product analytics, feature flags, experiments, and more.","title":"PostHog MCP Server","repository":{"url":"https://github.com/PostHog/posthog","source":"github","subfolder":"services/mcp"},"version":"1.0.1","remotes":[{"type":"streamable-http","url":"https://mcp.posthog.com/mcp","headers":[{"description":"Bearer token with your PostHog personal API key. Create one at https://us.posthog.com/settings/user-api-keys with the 'MCP Server' preset.","isRequired":true,"value":"Bearer {api_key}","isSecret":true,"variables":{"api_key":{"description":"Your PostHog personal API key","isRequired":true,"isSecret":true}},"name":"Authorization"}]},{"type":"sse","url":"https://mcp.posthog.com/sse","headers":[{"description":"Bearer token with your PostHog personal API key. Create one at https://us.posthog.com/settings/user-api-keys with the 'MCP Server' preset.","isRequired":true,"value":"Bearer {api_key}","isSecret":true,"variables":{"api_key":{"description":"Your PostHog personal API key","isRequired":true,"isSecret":true}},"name":"Authorization"}]}]},"documentationReview":{"reviewedAt":"2026-10-23","domain":"posthog.com","sources":[{"title":"PostHog MCP overview","url":"https://posthog.com/docs/model-context-protocol"},{"title":"PostHog authentication and advanced setup","url":"https://posthog.com/docs/model-context-protocol/faq"}],"findings":["PostHog confirms https://mcp.posthog.com/mcp as its hosted endpoint.","OAuth is the recommended setup. For clients without OAuth, create a personal API key using the MCP Server preset and send it through Authorization: Bearer.","The Registry snapshot only describes the personal-key path. The server routes requests to the account's region and executes tools against the PostHog API; restrict project access and tool permissions as appropriate."],"authentication":"OAuth recommended; scoped personal API key available as a fallback.","scope":"Endpoint, OAuth recommendation and API-key fallback checked. No authenticated analytics query or write action was performed.","name":"PostHog","setupSteps":[{"title":"Add the PostHog server","text":"Add https://mcp.posthog.com/mcp in your MCP client, or use the publisher’s setup wizard.","sourceUrl":"https://posthog.com/docs/model-context-protocol/faq"},{"title":"Sign in through OAuth","text":"Use OAuth, PostHog’s recommended path. If your client does not support it, create a personal API key using the MCP Server preset and send it through Authorization: Bearer.","sourceUrl":"https://posthog.com/docs/model-context-protocol/faq"},{"title":"Choose your project and tools","text":"Use the intended account and project, restrict tools or choose read-only access where appropriate, then initialize the connection in your client.","sourceUrl":"https://posthog.com/docs/model-context-protocol/faq"}]},"upstreamRevision":"9579bfcc3e8b0bd6abbc86c249119d6d9763c5a9"}