Skip to content

docs(mcp-analytics): document the initialize and tools list event options - #21684

Merged
gesh merged 2 commits into
masterfrom
gesh/mcp-optional-overhead-events
Oct 29, 2026
Merged

gesh merged 2 commits into
masterfrom
gesh/mcp-optional-overhead-events

Conversation

@gesh

@gesh gesh commented Oct 28, 2026

Copy link
Copy Markdown
Member

Changes

The MCP Analytics SDKs can now turn off $mcp_initialize and $mcp_tools_list. Both events are on by default. Many clients reconnect often, so these two events can outnumber $mcp_tool_call.

  • TypeScript and Python installation pages: the Configuration tables get two rows each.
    • TypeScript: sendInitializeEvent and sendToolsListEvent.
    • Python: send_initialize_event and send_tools_list_event.
    • The initialize row tells the reader that MCP onboarding and the default dashboard's users and sessions tiles show no data with the option off.
  • Events reference: the $mcp_initialize and $mcp_tools_list rows now name the option that stops each event.

SDK changes:

This PR stays a draft until both SDKs release the tools list option.

Checklist

  • I've read the docs and/or content style guides.
  • Words are spelled using American English
  • Use relative URLs for internal links
  • I've checked the pages added or changed in the Vercel preview build
  • If I moved a page, I added a redirect in vercel.json

🤖 Generated with Claude Code

@github-actions github-actions Bot added docs Improvements or additions to product documentation, "Docs" content PR only touches files under contents/ labels Oct 28, 2026
@github-actions

github-actions Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Oct 29, 2026 07:56AM

Changed pages

Page Source
Event and property reference contents/docs/mcp-analytics/events.mdx
Python MCP Analytics installation contents/docs/mcp-analytics/installation/python.mdx
TypeScript MCP Analytics installation contents/docs/mcp-analytics/installation/typescript.mdx

@github-actions

github-actions Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

Vale prose linter → found 0 errors, 27 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/docs/mcp-analytics/events.mdx — 0 errors, 13 warnings, 2 suggestions
Line Severity Message Rule
47:458 warning 'params' is a possible misspelling. PostHogBase.Spelling
47:486 warning Use 'SDK' instead of 'sdk'. Vale.Terms
50:262 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
51:186 warning 'accessors' is a possible misspelling. PostHogBase.Spelling
72:33 warning 'sessionless' is a possible misspelling. PostHogBase.Spelling
80:141 warning Use 'AI' instead of 'ai'. Vale.Terms
80:145 warning 'Cowork' is a possible misspelling. PostHogBase.Spelling
84:103 warning Use 'AI' instead of 'ai'. Vale.Terms
84:273 warning Use 'AI' instead of 'ai'. Vale.Terms
100:236 warning Capitalize 'Error Tracking' for PostHog's product. Use 'Error tracking' for the general industry concept. PostHogBase.ProductNames
113:87 warning 'symbolicate' is a possible misspelling. PostHogBase.Spelling
139:79 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
149:73 warning 'groupType' is a possible misspelling. PostHogBase.Spelling
149:86 warning 'groupKey' is a possible misspelling. PostHogBase.Spelling
163:57 warning 'typesafe' is a possible misspelling. PostHogBase.Spelling
contents/docs/mcp-analytics/installation/python.mdx — 0 errors, 10 warnings, 0 suggestions
Line Severity Message Rule
17:129 warning Use 'X' instead of 'x'. Vale.Terms
18:46 warning Use 'X' instead of 'x'. Vale.Terms
19:4 warning 'jlowin's' is a possible misspelling. PostHogBase.Spelling
103:18 warning 'jlowin's' is a possible misspelling. PostHogBase.Spelling
103:101 warning 'fastmcp' is a possible misspelling. PostHogBase.Spelling
103:111 warning Use 'X' instead of 'x'. Vale.Terms
111:137 warning Use 'X' instead of 'x'. Vale.Terms
155:32 warning Use 'X' instead of 'x'. Vale.Terms
172:180 warning Use 'X' instead of 'x'. Vale.Terms
243: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

@posthog posthog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PostHog Review · Standard · reviewed 3e7a9cd: 1 Should fix.

This is the only automatic review while this pull request is a draft. Comment @posthog review to review new changes sooner. Otherwise, a review of the new changes runs when you mark it ready for review.

See this review and its findings in PostHog Review. Comment @posthog review --deep for a Deep review. A Deep review takes longer and looks deeper than a Standard review.

Comment thread contents/docs/mcp-analytics/events.mdx Resolved
gesh and others added 2 commits October 29, 2026 09:42
…ions

Add sendInitializeEvent and sendToolsListEvent to the TypeScript
Configuration table, and send_initialize_event and send_tools_list_event
to the Python one. Both are on by default. The events reference now says
that each option stops its event.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The $mcp_initialize and $mcp_tools_list rows showed only the TypeScript
option names. Python readers need send_initialize_event=False and
send_tools_list_event=False, so the rows now show both.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@gesh
gesh force-pushed the gesh/mcp-optional-overhead-events branch from 0376ed6 to b2a486a Compare October 29, 2026 07:42
@gesh
gesh marked this pull request as ready for review October 29, 2026 07:45
@github-actions

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

10.52 MiB (no change)

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

Entrypoint Eager size Budget Modules
✅ app 20.39 MiB (no change) report-only 2112
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 1455.4 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.8 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.2 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).

@gesh
gesh merged commit 76f6b6e into master Oct 29, 2026
23 checks passed
@gesh
gesh deleted the gesh/mcp-optional-overhead-events branch October 29, 2026 09:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content PR only touches files under contents/ docs Improvements or additions to product documentation, "Docs"

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant