Skip to content

docs: add MCP tools for approvals/change requests#18818

Open
inkeep[bot] wants to merge 2 commits into
masterfrom
docs-writer-ai-update-2026-07-22T18-01-39-237Z-x3l190
Open

docs: add MCP tools for approvals/change requests#18818
inkeep[bot] wants to merge 2 commits into
masterfrom
docs-writer-ai-update-2026-07-22T18-01-39-237Z-x3l190

Conversation

@inkeep

@inkeep inkeep Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Changes

This PR adds documentation for the new MCP tools that allow managing change request approvals from AI coding assistants.

Related PR: PostHog/posthog#72606

What's documented

PR #72606 added new MCP tools for approving and rejecting change requests:

  • change-requests-list - List pending change requests with actionability fields
  • change-request-get - Get details of a specific change request
  • change-requests-approve (prepare/execute) - Approve a change request with typed confirmation
  • change-requests-reject (prepare/execute) - Reject a change request with reason and typed confirmation

Files updated

  1. contents/docs/settings/approvals.mdx - Added a new "Managing approvals with MCP" section explaining how to:

    • View pending change requests that need your action
    • Review and act on requests from your AI coding assistant
    • Understand the typed confirmation requirement
  2. contents/docs/model-context-protocol/use-cases.mdx - Added a new "Manage change request approvals" subsection with example prompts for:

    • Listing pending approvals
    • Viewing request details
    • Approving requests
    • Rejecting requests with reasons

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 Bot added 2 commits July 22, 2026 18:03
Document new MCP tools for managing change requests from AI coding
assistants (change-requests-list, change-request-get,
change-requests-approve, change-requests-reject). Added before
Common use cases section.
@inkeep
inkeep Bot requested a review from yasen-posthog July 22, 2026 18:05
@github-actions github-actions Bot added the docs Improvements or additions to product documentation, "Docs" label Jul 22, 2026
@github-actions

github-actions Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Jul 22, 2026 06:20PM

@github-actions

Copy link
Copy Markdown
Contributor

Vale prose linter → found 4 errors, 31 warnings, 1 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/model-context-protocol/use-cases.mdx — 2 errors, 13 warnings, 0 suggestions
Line Severity Message Rule
16:92 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
16:158 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
56:5 warning 'Explore product analytics' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
56:13 warning Capitalize 'Product Analytics' for PostHog's product. Use 'product analytics' for the general industry concept. PostHogBase.ProductNames
75:44 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
75:81 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
98:12 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
98:30 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
100:49 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
100:97 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
100:161 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
140:5 warning 'Run SQL and HogQL queries' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
157:32 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
284:109 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
311:32 warning Capitalize 'Experimentation' for PostHog's product. Use 'experimentation' for the general industry concept. PostHogBase.ProductNames
contents/docs/settings/approvals.mdx — 2 errors, 18 warnings, 1 suggestions
Line Severity Message Rule
44:168 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
46:13 warning 'approvers' is a possible misspelling. PostHogBase.Spelling
51:83 warning 'approvers' is a possible misspelling. PostHogBase.Spelling
52:29 warning 'Approvers' is a possible misspelling. PostHogBase.Spelling
66:19 warning 'Gateable' is a possible misspelling. PostHogBase.Spelling
68:3 warning Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept. PostHogBase.ProductNames
91:5 warning 'Approvers' is a possible misspelling. PostHogBase.Spelling
95:116 warning 'approvers' is a possible misspelling. PostHogBase.Spelling
111:5 warning 'Approvers' is a possible misspelling. PostHogBase.Spelling
113:19 warning 'approvers' is a possible misspelling. PostHogBase.Spelling
150:34 warning 'actioned' is a possible misspelling. PostHogBase.Spelling
187:1 warning Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept. PostHogBase.ProductNames
189:70 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
189:150 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
189:280 warning 'approvers' is a possible misspelling. PostHogBase.Spelling
240:8 warning 'approvers' is a possible misspelling. PostHogBase.Spelling
256:8 warning 'approvers' is a possible misspelling. PostHogBase.Spelling
266:31 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
272:8 warning 'approvers' is a possible misspelling. PostHogBase.Spelling
283:5 warning 'Approvers' is a possible misspelling. PostHogBase.Spelling
284:5 warning 'Requesters' is a possible misspelling. PostHogBase.Spelling

@github-actions

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

6.75 MiB (+0.3 KiB / +0.0%)

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

Entrypoint Eager size Budget Modules
app 16.23 MiB (+6.9 KiB / +0.0%) report-only 1982
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 897.3 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 747.2 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/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
./src/hooks/useCustomers.tsx + 54 modules 355.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.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
./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 + 120 modules 278.6 KiB
./src/components/SearchUI/index.tsx + 87 modules 272.1 KiB
./node_modules/.pnpm/framer-motion@10.18.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/dom/motion.mjs + 109 modules 253.9 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 for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

@github-actions

Copy link
Copy Markdown
Contributor

Hey @yasen-posthog! 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

docs Improvements or additions to product documentation, "Docs"

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

0 participants