Skip to content

docs: add chart display and formatting settings for MCP insight tools#17173

Open
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-06-01T16-30-04-641Z-y7cb5d
Open

docs: add chart display and formatting settings for MCP insight tools#17173
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-06-01T16-30-04-641Z-y7cb5d

Conversation

@inkeep
Copy link
Copy Markdown
Contributor

@inkeep inkeep Bot commented Jun 1, 2026

Summary

Documents the new chart display and formatting settings now available in the MCP insight-create-from-query and insight-update tools for SQL-backed (DataVisualization) insights.

Changes

Updates contents/docs/product-analytics/build-insights-mcp.mdx with a new "Customize chart display" section covering:

Per-series display settings (settings.display for Y-axis columns):

  • yAxisPosition – left or right axis placement
  • displayType – override chart type per-series (auto/line/bar/area) to mix visualizations
  • trendLine – enable linear trend line overlay
  • label – custom legend/tooltip label
  • color – hex color for the series

Number formatting (settings.formatting):

  • style – none/number/short/percent
  • prefix / suffix – e.g. $ or ms
  • decimalPlaces – precision control

Chart-level:

  • showValuesOnSeries – toggle value labels on data points

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.

Document the per-series display settings (displayType, trendLine, label,
color, yAxisPosition), number formatting (prefix, suffix, style,
decimalPlaces), and chart-level showValuesOnSeries that are now available
on the insight-create and insight-update MCP tools for SQL-backed insights.

Ref: PostHog/posthog#60868
@inkeep inkeep Bot requested a review from sampennington June 1, 2026 16:35
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 1, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Jun 01, 2026 04:51PM

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 1, 2026

Vale prose linter → found 3 errors, 1 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/product-analytics/build-insights-mcp.mdx — 3 errors, 1 warnings, 0 suggestions
Line Severity Message Rule
47:24 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
57:23 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
62:65 warning 'prepended' is a possible misspelling. PostHogBase.Spelling
66:26 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 1, 2026

Hey @sampennington! 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