docs(mcp): explain fresh low-level server schemas

[gesh]

Changes

• Explain tool resolution for fresh low-level MCP servers in TypeScript and Python.
• Add the resolver options to both SDK configuration tables.

Why

Strict schemas can reject SDK-added arguments when each request creates a new low-level server.

Depends on PostHog/posthog-js#5165, PostHog/posthog-python#1009, and PostHog/sdk-specs#98.

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

---

Created with PostHog Desktop

[github-actions]

Deploy preview

Status	Details	Updated (UTC)
🔴 Failed	View logs	Oct 05, 2026 01:44PM

Push a fix or re-run the workflow to try again.

Common culprits

• MDX issues - unescaped </> characters, unclosed tags, or malformed JSX
• External API timeouts - GitHub, Strapi, or Ashby occasionally hiccup

[github-actions]

Vale prose linter → found 0 errors, 12 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/mcp-analytics/installation/python.mdx — 0 errors, 7 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
153:32	warning	Use 'X' instead of 'x'.	Vale.Terms
163:180	warning	Use 'X' instead of 'x'.	Vale.Terms
234:260	warning	Use 'AI' instead of 'ai'.	Vale.Terms

contents/docs/mcp-analytics/installation/typescript.mdx — 0 errors, 5 warnings, 0 suggestions

Line	Severity	Message	Rule
3:15	warning	'nodejs' is a possible misspelling.	PostHogBase.Spelling
85:133	warning	Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept.	PostHogBase.ProductNames
141:95	warning	'OAuth' is a possible misspelling.	PostHogBase.Spelling
171:129	warning	Use 'MCP' instead of 'mcp'.	Vale.Terms
250:57	warning	'Zod' is a possible misspelling.	PostHogBase.Spelling

[github-actions]

Bundle report

Total JS (gzip)

9.62 MiB (-0.0 KiB / -0.0%)

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

Entrypoint	Eager size	Budget	Modules
✅ app	19.22 MiB (+0.1 KiB / +0.0%)	report-only	2083

Largest modules in the app closure

Module	Size
./src/data/mcp-tools.json	1286.9 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	801.4 KiB
./src/components/Stickers/Stickers.tsx	696.4 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/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/x-ray.mjs	480.8 KiB
./node_modules/.pnpm/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/trenchcoat.mjs	447.5 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.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/im-the-driver.mjs	385.7 KiB
./src/hooks/useCustomers.tsx + 56 modules	375.9 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 + 127 modules	310.3 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js	281.9 KiB
./node_modules/.pnpm/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/doll-house.mjs	281.7 KiB
./node_modules/.pnpm/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/director.mjs	275.6 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).