mcp

This MCP server implements the Model Context Protocol integration for PostHog and has been moved into the PostHog monorepo. The repository indicates that the MCP server is distributed via the PostHog wizard tooling, and that you can add or configure MCP support in development environments (Cursor, Claude, Claude Code, VS Code, and Zed) using the wizard command. The available tooling is centered around enabling MCP interactions within PostHog’s ecosystem, allowing agents and clients to query and reason about PostHog models and contexts through the MCP interface. To begin, install the MCP server through the wizard command and follow the prompts to integrate it with your development environment, after which you can use the standard MCP endpoints and capabilities exposed by the server in your workspace.

Once installed, you should be able to interact with the MCP server’s capabilities via the client tools provided by the PostHog wizard integration, which typically includes model-context queries, context-aware decision making, and agent-style interactions that leverage the MCP protocol. If you are working in a supported IDE or environment, the wizard will guide you through enabling the MCP features and connecting to the server. For more details, refer to the documentation linked in the repository (Documentation: posthog model context protocol) and the monorepo location for the MCP service.

Prerequisites:

• Node.js and npm (or core npx tooling) installed on your system
• Internet access to fetch the MCP server package
• Access to the PostHog wizard tooling (or the monorepo where MCP lives) for integration

Installation steps:

1. Ensure Node.js and npm are installed. Verify with: node -v npm -v
2. Use the wizard to add the MCP server to your environment (this aligns with the recommended quick install): npx @posthog/wizard@latest mcp add
3. Follow the interactive prompts from the wizard to complete MCP integration with your IDE/ENV. If you are working directly with the monorepo, clone the repository and navigate to services/mcp to run the server locally as documented there.
4. If you are managing dependencies manually, you can install the MCP tooling via npx or your preferred package manager as indicated by the wizard prompts, then start the MCP service according to the monorepo guidance.

Note: The MCP server has been moved into the PostHog monorepo. For authoritative setup instructions and paths, refer to the monorepo location: https://github.com/PostHog/posthog/tree/master/services/mcp.

Tips and considerations:

• The MCP server is now part of the PostHog monorepo; use the wizard integration for the recommended setup in Cursor, Claude, Claude Code, VS Code, and Zed.
• The official documentation for Model Context Protocol is available at the provided link in the README; consult it for supported MCP capabilities and protocol details.
• If you encounter connectivity or integration issues, ensure your environment variables are correctly set (see placeholder env vars in common MCP configurations) and verify that the wizard is pulling the latest MCP tooling.
• Since the MCP server is distributed via the wizard/monorepo tooling, you may not need to install a separate npm package; rely on the wizard flow to configure and run the server in your workspace.