PostHog MCP for Windsurf

The PostHog MCP server enables Windsurf to directly interact with your PostHog data – managing feature flags, querying analytics, investigating errors, and more.

Server URL

https://mcp.posthog.com/mcp

The PostHog authentication server automatically routes you to the correct data region (US or EU) based on the account you log in with.

Quick install

The PostHog Wizard can install the MCP server directly into Windsurf:

npx @posthog/wizard mcp add

Manual setup

1. Open Windsurf and navigate to Windsurf Settings > Cascade > MCP Servers
2. Click Manage MCP Servers
3. Click View raw config
4. Update mcp_config.json with the following configuration:

{
  "mcpServers": {
    "posthog": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.posthog.com/mcp"
      ]
    }
  }
}

When you first use the MCP server, you'll be prompted to log in to PostHog to authenticate.

Be mindful of prompt injection – LLMs can be tricked into following untrusted commands, so always review tool calls before executing them.

What's next

• Use cases – 20+ example prompts and multi-step recipes for the most useful MCP workflows
• Tools reference – every tool the MCP server exposes, grouped by category
• FAQ and advanced setup – auth, scoping, filtering, safety, and other operational details