productmetrics

PostHog product analytics as MCP tools, talking to the PostHog REST API. productmetrics is a clean-room rebuild of the core surface of the PostHog MCP server, under a new name: fresh code, no copied branding. The original is PostHog's hosted remote MCP (OAuth); hosted OAuth is NOT reproduced — this rebuild is a personal-API-key REST client for the same API.

Tools (core subset, 12)

list_projects, get_project, list_insights, get_insight, query_insight, run_hogql_query, list_feature_flags, get_feature_flag, create_feature_flag, update_feature_flag, list_experiments, get_experiment.

Not in this subset: events and persons, actions and cohorts, annotations, dashboards, data warehouse, error tracking, surveys, session recordings, subscriptions, and organization admin tools.

Related MCP server: posthog-mcp

Setup

Create a personal API key in PostHog and set it:

export POSTHOG_API_KEY=phx_...
export POSTHOG_PROJECT_ID=12345   # optional default project

Optionally override the host with POSTHOG_HOST (for example the EU host) or the full base with POSTHOG_API_BASE_URL (default https://app.posthog.com/api). Without the key, every tool call fails with an error naming the missing variable. Pass project_id per call or rely on the POSTHOG_PROJECT_ID fallback.

CLI

npx @reneturcios/productmetrics list_projects '{}'
npx @reneturcios/productmetrics mcp        # stdio MCP server

Each tool name is a subcommand taking one JSON object argument.

MCP client config

{
  "mcpServers": {
    "productmetrics": {
      "command": "npx",
      "args": ["-y", "@reneturcios/productmetrics", "mcp"],
      "env": { "POSTHOG_API_KEY": "phx_..." }
    }
  }
}

Docker

docker run -i -e POSTHOG_API_KEY ghcr.io/cloudcorprecords/productmetrics

Development

npm install
npm run build
npm test

License

MIT