Skip to content

docs(data-warehouse): Add column annotation MCP tools documentation#18136

Open
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-07-02T15-35-49-435Z-9b0wx1
Open

docs(data-warehouse): Add column annotation MCP tools documentation#18136
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-07-02T15-35-49-435Z-9b0wx1

Conversation

@inkeep

@inkeep inkeep Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Changes

This PR documents the new MCP tools for managing column annotations on saved queries (views) added in PostHog/posthog#67725, as well as the existing warehouse table annotation tools that were previously undocumented.

Updates to contents/docs/data-warehouse/run-sql-mcp.mdx:

  1. Updated intro paragraph – Added "annotate tables and columns" and "add semantic descriptions to your data" to describe the new capabilities.

  2. Added bullet to "How it works" – New bullet explaining users can annotate tables and columns so PostHog AI understands their data.

  3. Added new "Column annotation tools" section documenting all 5 enabled annotation tools:

    • saved-query-column-annotations-create – Add/replace descriptions for views (NEW)
    • saved-query-column-annotations-list – List view descriptions (NEW)
    • warehouse-column-annotations-create – Add descriptions for warehouse tables
    • warehouse-column-annotations-list – List warehouse table descriptions
    • warehouse-column-annotations-partial-update – Edit existing warehouse annotations
    • Includes a note that core PostHog tables (events, persons, groups, sessions) cannot be annotated
  4. Added example prompts for column annotations with 4 examples covering both view and warehouse table annotation use cases.


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.

@inkeep inkeep Bot requested a review from thiagosalvatore July 2, 2026 15:38
@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Jul 02, 2026 03:54PM

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
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!

contents/docs/data-warehouse/run-sql-mcp.mdx — 0 errors, 6 warnings, 0 suggestions
Line Severity Message Rule
5:281 warning Use the Oxford comma before 'and' or 'or' in a list of three or more items. PostHogBase.OxfordComma
18: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
40:64 warning 'Upserts' is a possible misspelling. PostHogBase.Spelling
61:121 warning 'OAuth' is a possible misspelling. PostHogBase.Spelling
65:54 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

6.29 MiB (+0.0 KiB / +0.0%)

Eager graph (static-import closure per entrypoint)

Entrypoint Eager size Budget Modules
app 24.21 MiB (+1.7 KiB / +0.0%) report-only 5516
Largest modules in the app closure
Module Size
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css 708.0 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./.cache/caches/gatsby-plugin-mdx/mdx-scopes-dir/31a094f140f119e73085d847ae81b99b.js + 2 modules 581.0 KiB
./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js 481.4 KiB
./node_modules/.pnpm/@codemirror+view@6.38.2/node_modules/@codemirror/view/dist/index.js 458.1 KiB
./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules 395.1 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.cjs.js 364.8 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js 354.8 KiB
./src/hooks/useCustomers.tsx + 54 modules 353.9 KiB
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules 351.4 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 KiB
./src/components/ProductComparisonTable/index.tsx + 116 modules 267.6 KiB
./node_modules/.pnpm/@codesandbox+sandpack-react@2.20.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@codesandbox/sandpack-react/dist/index.mjs 266.6 KiB
./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules 247.4 KiB
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules 239.9 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes.

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Hey @thiagosalvatore! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

  1. Review and approve the PR
  2. Merge the PR
    a. Check the preview env and CI build and merge it yourself
    b. Enable auto-merge if you're confident in the changes

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.

0 participants