docs(mcp): Document connectionId parameter for direct Postgres/DuckDB queries#16661
Open
inkeep[bot] wants to merge 1 commit intomasterfrom
Open
docs(mcp): Document connectionId parameter for direct Postgres/DuckDB queries#16661inkeep[bot] wants to merge 1 commit intomasterfrom
inkeep[bot] wants to merge 1 commit intomasterfrom
Conversation
…ces via MCP Reflects PostHog/posthog#56720 which exposes connectionId on query-run, query-validate, and hogql-schema MCP tools for Postgres/DuckDB direct queries.
Contributor
Deploy preview
|
Contributor
|
Vale prose linter → found 0 errors, 6 warnings, 0 suggestions in your markdown Full report → Copy the linter results into an LLM to batch-fix issues. Linter being weird? Update the rules!
|
| Line | Severity | Message | Rule |
|---|---|---|---|
| 5:252 | warning | Use the Oxford comma before 'and' or 'or' in a list of three or more items. | PostHogBase.OxfordComma |
| 19:59 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 27:135 | warning | 'subqueries' is a possible misspelling. | PostHogBase.Spelling |
| 48:64 | warning | 'Upserts' is a possible misspelling. | PostHogBase.Spelling |
| 69:121 | warning | 'OAuth' is a possible misspelling. | PostHogBase.Spelling |
| 73:54 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
Contributor
|
Hey @georgemunyoro! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Changes
This PR updates the MCP SQL documentation to reflect the new
connectionIdparameter added in PostHog/posthog#56720, which enables AI agents to query external data sources (Postgres/DuckDB direct-query connections) instead of defaulting to ClickHouse.Updates made:
"How it works" section – Added a new capability bullet for querying external databases directly via Postgres or DuckDB connections without syncing data into PostHog.
SQL tools table – Updated with three changes:
query-rundescription to mention the optionalconnectionIdparameterquery-validatetool documentation (validates queries before running, also supportsconnectionId)hogql-schematool documentation (schema introspection, supportsconnectionIdfor external source schemas)New "Query external data sources directly" section – Explains how to use the
connectionIdparameter across the three HogQL-shaped tools, and how to discover available connection IDs usingexternal-data-sources-list.Example prompts – Added a new "For querying external data sources directly" section with example prompts showing how to list sources, view schemas, and run/validate queries against external connections.
Related PR
This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.