Skip to content

docs(mcp-analytics): remove beta tags for GA (release day, merge 2026-11-10) - #21880

Draft
lucasheriques wants to merge 5 commits into
masterfrom
lucas/mcp-analytics-ga-beta-tags
Draft

docs(mcp-analytics): remove beta tags for GA (release day, merge 2026-11-10)#21880
lucasheriques wants to merge 5 commits into
masterfrom
lucas/mcp-analytics-ga-beta-tags

Conversation

@lucasheriques

@lucasheriques lucasheriques commented Nov 3, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Why

MCP Analytics goes GA on 2026-11-10 (PostHog/marketing#407). This is the release-day "Remove all beta tags" change, staged as one merge. Don't merge before 2026-11-10.

What

Commit Change Drop it if
docs(mcp-analytics): drop product beta markers for GA Start-here "in beta" callout, "Open beta" callouts on the API, MCP and web app surface pages, web app card badge, docs sidebar badge, status: 'beta' in src/data/tools.ts, product page and product analytics copy, stale early-access comment No decision, always ships
... drop the Python beta label Removes the "Beta SDK" callout. Python becomes "Supported" in the install table Python keeps a beta label
... drop the TypeScript beta label Replaces "Beta SDK" with a pre-1.0 versioning note, since @posthog/mcp is 0.25.x. TypeScript becomes "Supported" TypeScript keeps a beta label. If 1.0 ships first, delete the note instead. Also covers the tutorial's "official (beta) SDK"
... drop the Go beta label Keeps the callout pointing at Limits, without "beta". Go becomes "Supported" Go keeps a beta label
docs(blog): drop "currently in beta"... how-ai-agents-behave.mdx says MCP Analytics is "currently in beta!" You'd rather not edit a dated post

Ruby and Rust stay Experimental. The Ruby gem still prints its own "experimental and not officially supported" warning, so the docs can't drop the label by themselves. The Ruby edit sits on the lucas/mcp-analytics-ga-ruby-label branch (commit 379e233f7c). Cherry-pick it here only after a posthog-ruby release removes EXPERIMENTAL_NOTICE.

Each SDK commit also edits one cell of the install table's Support row. Dropping the Python or TypeScript commit therefore conflicts on that one line (Go, the last SDK commit, drops cleanly). The conflict is deliberate. A table cell can't sit on a line of its own, and a summary commit that sets every cell would let a dropped SDK keep "Supported" silently. When you drop a commit, resolve the conflict by setting that SDK's cell back to Beta.

Left alone on purpose: src/components/Home/Board/index.tsx sets badge: 'BETA' for MCP Analytics, but nothing renders that board (Home/Hero.js has no importers).

The app side is a separate PR in PostHog/posthog. It drops the beta tag from the product manifest.

How tested

  • grep -rniE "beta|early.access|experimental" over contents/docs/mcp-analytics, the tutorial, tools.ts and the MCP product data now matches only the Ruby and Rust labels.
  • prettier@2 --write on the changed TS files produced no diff.
  • Pre-PR gate: two adversarial reviewers (Opus, Sonnet). They found the tutorial line in the wrong commit (moved to TypeScript) and the blog post (now its own commit). Both confirmed the MDX is balanced, no CalloutBox import is left unused, the Go #limits anchor exists, and nothing depends on the removed status.
  • Cloudflare preview https://938acd10.posthog-preview.pages.dev: the overview, start-here, the three surface pages, the Python page, the tutorial and the blog post render with no "beta". The install table shows Supported x3 and Experimental x2. The TypeScript and Go callouts render, and Docs > Analytics > MCP Analytics has no badge.

@github-actions github-actions Bot added the docs Improvements or additions to product documentation, "Docs" label Nov 3, 2026
@github-actions

github-actions Bot commented Nov 3, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Nov 03, 2026 01:53AM

Changed pages

Page Source
How AI agents behave: lessons from 63M MCP tool calls contents/blog/how-ai-agents-behave.mdx
MCP Analytics contents/docs/mcp-analytics/index.mdx
Install MCP Analytics contents/docs/mcp-analytics/installation/index.mdx
Go MCP Analytics installation contents/docs/mcp-analytics/installation/go.mdx
Python MCP Analytics installation contents/docs/mcp-analytics/installation/python.mdx
TypeScript MCP Analytics installation contents/docs/mcp-analytics/installation/typescript.mdx
Getting started with MCP Analytics contents/docs/mcp-analytics/start-here.mdx
MCP Analytics API contents/docs/mcp-analytics/surfaces/api.mdx
Query MCP Analytics over PostHog MCP contents/docs/mcp-analytics/surfaces/mcp.mdx
MCP Analytics in PostHog Web contents/docs/mcp-analytics/surfaces/web-app.mdx
How to set up MCP analytics and error tracking contents/tutorials/mcp-analytics.mdx

@github-actions

github-actions Bot commented Nov 3, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Vale prose linter → found 2 errors, 65 warnings, 2 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/blog/how-ai-agents-behave.mdx — 2 errors, 16 warnings, 0 suggestions
Line Severity Message Rule
16:166 warning 'doomscroll' is a possible misspelling. PostHogBase.Spelling
22:19 error 'to' is repeated! Vale.Repetition
22:184 warning 'leaderboard' is a possible misspelling. PostHogBase.Spelling
32:9 warning 'timeframe' is a possible misspelling. PostHogBase.Spelling
32:168 warning 'Cowork' is a possible misspelling. PostHogBase.Spelling
32:226 warning Use 'AI' instead of 'ai'. Vale.Terms
32:265 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
58:24 warning Capitalize 'Product Analytics' for PostHog's product. Use 'product analytics' for the general industry concept. PostHogBase.ProductNames
88:50 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
90:2 warning Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept. PostHogBase.ProductNames
96:131 warning 'Cowork' is a possible misspelling. PostHogBase.Spelling
118:4 warning '0.5% of calls cost 18% of the tokens' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
132:165 warning Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept. PostHogBase.ProductNames
136:111 warning 'erroring' is a possible misspelling. PostHogBase.Spelling
138:96 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
140:34 warning 'leaderboard' is a possible misspelling. PostHogBase.Spelling
146:239 warning Capitalize 'Product Analytics' for PostHog's product. Use 'product analytics' for the general industry concept. PostHogBase.ProductNames
148:228 warning Use the Oxford comma before 'and' or 'or' in a list of three or more items. PostHogBase.OxfordComma
contents/docs/mcp-analytics/index.mdx — 0 errors, 2 warnings, 0 suggestions
Line Severity Message Rule
15:41 warning 'leaderboard' is a possible misspelling. PostHogBase.Spelling
27:13 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
contents/docs/mcp-analytics/installation/go.mdx — 0 errors, 10 warnings, 0 suggestions
Line Severity Message Rule
15:115 warning Use 'SDK' instead of 'sdk'. Vale.Terms
17:192 warning Use 'SDK' instead of 'sdk'. Vale.Terms
86:67 warning Use 'SDK' instead of 'sdk'. Vale.Terms
113:5 warning 'Streamable' is a possible misspelling. PostHogBase.Spelling
114:88 warning Use 'SDK' instead of 'sdk'. Vale.Terms
126:179 warning Use 'SDK' instead of 'sdk'. Vale.Terms
139:82 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
139:90 warning 'stderr' is a possible misspelling. PostHogBase.Spelling
191:37 warning Use 'SDK' instead of 'sdk'. Vale.Terms
253:54 warning Use 'SDK' instead of 'sdk'. Vale.Terms
contents/docs/mcp-analytics/installation/python.mdx — 0 errors, 10 warnings, 0 suggestions
Line Severity Message Rule
11:129 warning Use 'X' instead of 'x'. Vale.Terms
12:46 warning Use 'X' instead of 'x'. Vale.Terms
13:4 warning 'jlowin's' is a possible misspelling. PostHogBase.Spelling
97:18 warning 'jlowin's' is a possible misspelling. PostHogBase.Spelling
97:101 warning 'fastmcp' is a possible misspelling. PostHogBase.Spelling
97:111 warning Use 'X' instead of 'x'. Vale.Terms
105:137 warning Use 'X' instead of 'x'. Vale.Terms
149:32 warning Use 'X' instead of 'x'. Vale.Terms
166:180 warning Use 'X' instead of 'x'. Vale.Terms
237:260 warning Use 'AI' instead of 'ai'. Vale.Terms
contents/docs/mcp-analytics/installation/typescript.mdx — 0 errors, 4 warnings, 0 suggestions
Line Severity Message Rule
3:15 warning 'nodejs' is a possible misspelling. PostHogBase.Spelling
87:154 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
173:129 warning Use 'MCP' instead of 'mcp'. Vale.Terms
252:57 warning 'Zod' is a possible misspelling. PostHogBase.Spelling
contents/docs/mcp-analytics/start-here.mdx — 0 errors, 0 warnings, 2 suggestions
Line Severity Message Rule
265:15 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
320:152 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
contents/docs/mcp-analytics/surfaces/api.mdx — 0 errors, 2 warnings, 0 suggestions
Line Severity Message Rule
7:72 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
24:137 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
contents/docs/mcp-analytics/surfaces/web-app.mdx — 0 errors, 2 warnings, 0 suggestions
Line Severity Message Rule
56:104 warning Capitalize 'Product Analytics' for PostHog's product. Use 'product analytics' for the general industry concept. PostHogBase.ProductNames
75:35 warning 'erroring' is a possible misspelling. PostHogBase.Spelling
contents/tutorials/mcp-analytics.mdx — 0 errors, 19 warnings, 0 suggestions
Line Severity Message Rule
2:40 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
10:5 warning Capitalize 'Product Analytics' for PostHog's product. Use 'product analytics' for the general industry concept. PostHogBase.ProductNames
23:72 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
34:1 warning 'The quick way: the ************ SDK' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
89:79 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
122:16 warning Don't put a comma after 'e.g.,'. Write 'i.e.' or 'e.g.' with no comma after it. PostHogBase.LatinAbbreviationComma
126:125 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
142:184 warning Use the Oxford comma before 'and' or 'or' in a list of three or more items. PostHogBase.OxfordComma
142:204 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
146:69 warning Capitalize 'Product Analytics' for PostHog's product. Use 'product analytics' for the general industry concept. PostHogBase.ProductNames
146:91 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
250:95 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
337:4 warning '5. PostHog product analytics and error tracking' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
337:15 warning Capitalize 'Product Analytics' for PostHog's product. Use 'product analytics' for the general industry concept. PostHogBase.ProductNames
337:37 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
341:214 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
629:11 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
641:32 warning 'Arda' is a possible misspelling. PostHogBase.Spelling
641:37 warning 'Eren' is a possible misspelling. PostHogBase.Spelling

@lucasheriques lucasheriques mentioned this pull request Nov 3, 2026
Draft
@github-actions

github-actions Bot commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

10.38 MiB (+0.1 KiB / +0.0%)

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint Eager size Budget Modules
✅ app 20.90 MiB (+2.2 KiB / +0.0%) report-only 2119
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 1472.7 KiB
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 839.2 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/x-ray.mjs 481.2 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/trenchcoat.mjs 450.8 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+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/im-the-driver.mjs 385.8 KiB
./src/hooks/useCustomers.tsx + 61 modules 381.8 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/tourist.mjs 364.6 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
./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
./src/components/ProductComparisonTable/index.tsx + 130 modules 314.3 KiB
./node_modules/.pnpm/framer-motion@14.0.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/components/motion/proxy.mjs + 126 modules 287.2 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/doll-house.mjs 284.1 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.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 for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

@lucasheriques
docs(mcp-analytics): drop product beta markers for GA
932562e 
MCP Analytics goes GA on 2026-11-10 (PostHog/marketing#407). Removes every
product-level beta marker that needs no SDK decision: the start-here "in
beta" callout, the "Open beta" callouts on the API, MCP and web app surface
pages, the web app surface card badge, the docs sidebar badge, the tool's
`status: 'beta'`, and the product page and product analytics copy. Also drops the stale comment claiming the scene is
gated behind an early access feature (no such gate exists in the app).

SDK-level labels (TypeScript, Python, Go, Ruby) are in their own commits.
@lucasheriques
docs(mcp-analytics): drop the Python beta label for GA
56dec1e 
posthog-python already classifies itself Production/Stable and ships
posthog.mcp in the main package, so the docs-only "Beta SDK" callout is the
last beta marker. Marks Python "Supported" in the installation table.

Drop this commit if Python should keep a beta label at GA.
@lucasheriques
docs(mcp-analytics): drop the TypeScript beta label for GA
c2dc18f 
Replaces the "Beta SDK" callout with a plain pre-1.0 versioning note:
@posthog/mcp is 0.25.x, so "minor releases may break" stays true until v1
ships. Same edit in the tutorial. Marks TypeScript "Supported" in the
installation table.

If @posthog/mcp ships 1.0 before GA, delete the note instead. Drop this
commit if TypeScript should keep its beta label.
@lucasheriques
docs(mcp-analytics): drop the Go beta label for GA
c1f92ca 
Keeps the callout pointing at Limits but drops "beta" from it: Go ships as
supported with documented gaps (no $mcp_tools_list or $mcp_initialize, no
resource or prompt events, no task handling). Marks Go "Supported" in the
installation table.

Drop this commit if Go should keep a beta label at GA.
@lucasheriques
docs(blog): drop "currently in beta" from the AI agents post
67de531 
MCP Analytics goes GA on 2026-11-10, so "currently in beta!" becomes
false on release day.
@lucasheriques
lucasheriques force-pushed the lucas/mcp-analytics-ga-beta-tags branch from e836b92 to 67de531 Compare November 3, 2026 01:36

This branch has not been deployed

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

Reviewers

No reviews

Assignees

No one assigned

Labels

docs Improvements or additions to product documentation, "Docs"

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@lucasheriques