docs(insiders): auto-generate per-flag tool change list

Adds a generated section to docs/insiders-features.md that lists every
tool added or modified by each entry in InsidersFeatureFlags. The
section is computed by diffing the default-flagged inventory against
the per-flag inventory at doc-generation time, so any new tool gated
behind an insiders flag — or any flag-gated schema change — shows up
without manual edits.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: SamMorrowDrums

cmd/github-mcp-server/generate_docs.go

@@ -43,6 +43,7 @@ func generateAllDocs() error {
 		// File to edit, function to generate its docs
 		{"README.md", generateReadmeDocs},
 		{"docs/remote-server.md", generateRemoteServerDocs},
+		{"docs/insiders-features.md", generateInsidersFeaturesDocs},
 		{"docs/tool-renaming.md", generateDeprecatedAliasesDocs},
 	} {
 		if err := doc.fn(doc.path); err != nil {

docs/insiders-features.md

@@ -20,6 +20,30 @@ For configuration examples, see the [Server Configuration Guide](./server-config
 
 ---
 
+## Tools added or changed by Insiders Mode
+
+The following table is generated from the Go source — it lists every tool that becomes available, or changes shape, when an Insiders feature flag is enabled. Each section is keyed by the underlying flag so contributors can see which flag is responsible for what.
+
+<!-- START AUTOMATED INSIDERS TOOLS -->
+### `remote_mcp_ui_apps`
+
+| Tool | Change |
+|------|--------|
+| `create_pull_request` | Adds MCP Apps UI metadata for interactive rendering |
+| `get_me` | Adds MCP Apps UI metadata for interactive rendering |
+| `issue_write` | Adds MCP Apps UI metadata for interactive rendering |
+
+
+### `remote_mcp_issue_fields`
+
+| Tool | Change |
+|------|--------|
+| `list_issue_fields` | New tool |
+| `list_issues` | Schema changes (input or output) under this flag |
+<!-- END AUTOMATED INSIDERS TOOLS -->
+
+---
+
 ## MCP Apps
 
 [MCP Apps](https://modelcontextprotocol.io/docs/extensions/apps) is an extension to the Model Context Protocol that enables servers to deliver interactive user interfaces to end users. Instead of returning plain text that the LLM must interpret and relay, tools can render forms, profiles, and dashboards right in the chat using MCP Apps.