Skip to content

docs(mcp): Add MCP v2 documentation with SQL-based tools#14978

Open
inkeep[bot] wants to merge 1 commit intomasterfrom
docs-writer-ai-update-2026-02-12T11-35-51-072Z
Open

docs(mcp): Add MCP v2 documentation with SQL-based tools#14978
inkeep[bot] wants to merge 1 commit intomasterfrom
docs-writer-ai-update-2026-02-12T11-35-51-072Z

Conversation

@inkeep
Copy link
Contributor

@inkeep inkeep bot commented Feb 12, 2026

Summary

This PR updates the Model Context Protocol (MCP) documentation to cover the new v2 features introduced in PostHog/posthog#46947.

Changes

New "MCP versions" section

Explains the differences between v1 and v2:

  • v1 (default) - Purpose-built tools for common tasks like creating feature flags, running experiments, and querying analytics
  • v2 - SQL-based data retrieval for advanced users who want to run custom HogQL queries

Includes configuration examples showing how to enable v2:

  • URL parameter: ?v=2
  • Header: x-posthog-mcp-version: 2

New "V2 tools" subsection

Documents the three new SQL-based tools:

  • execute-sql - Execute SQL/HogQL queries directly against PostHog data
  • read-data-schema - Explore events, properties, and property values in the project
  • read-data-warehouse-schema - Retrieve data warehouse schemas and table lists

New example prompt

Added an "SQL queries (v2)" example prompt demonstrating custom SQL query capabilities.

Related PR

- Add MCP versions section explaining v1 vs v2
- Document how to enable v2 via URL parameter or header
- Add V2 tools subsection with execute-sql, read-data-schema, and read-data-warehouse-schema
- Add SQL queries example prompt for v2
@inkeep inkeep bot requested a review from a team February 12, 2026 11:37
@vercel
Copy link

vercel bot commented Feb 12, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
posthog Ready Ready Preview Feb 12, 2026 11:50am

Request Review

@skoob13
Copy link
Contributor

skoob13 commented Feb 12, 2026

Too early to document

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant