docs(mcp): correct MCP tool-inventory diagram source + text to 87 tools (#3909)

* docs(mcp): correct the MCP tool-inventory diagram source + text to 87 tools

The mcp-tools diagram source was frozen at v3.8.8 (43 tools = 30 core + 3 memory +
4 skills + 6 notion) — missing the agent-skills, gamification, plugins and obsidian
modules, and Core had grown 30 → 33. Corrected to the real breakdown verified against
open-sse/mcp-server (TOTAL_MCP_TOOL_COUNT):

  33 core + 3 memory + 4 skills + 3 agent-skills + 8 gamification + 8 plugins
  + 6 notion + 22 obsidian = 87

- renamed mcp-tools-43.{mmd,svg} → mcp-tools-87.{mmd,svg}
- rewrote the .mmd source with the 8 real categories
- fixed MCP-SERVER.md: source-of-truth line, image alt, and the inventory caption
- fixed docs/diagrams/README.md index entry

check:doc-links PASS (links resolve).

⚠️ The committed mcp-tools-87.svg is the OLD render (still draws 43 tools): the SVG
must be regenerated with `npm run docs:render-diagrams` in an environment with a
working headless Chromium. It could NOT be rendered in this sandbox — Chromium is
missing system libraries (libnss3 / libatk / libcups / libxcb, no apt access). The
.mmd source and all surrounding text are correct, so a single render call finalizes
the image.

* docs(mcp): render mcp-tools-87.svg (87-tool inventory diagram)

docs/diagrams/README.md

@@ -16,7 +16,7 @@ Mermaid sources (`.mmd`) and exported SVGs for OmniRoute v3.8.0 architecture flo
 | [auto-combo-9factor.mmd](./auto-combo-9factor.mmd) | [SVG](./exported/auto-combo-9factor.svg) | docs/routing/AUTO-COMBO.md                                                     |
 | [resilience-3layers.mmd](./resilience-3layers.mmd) | [SVG](./exported/resilience-3layers.svg) | docs/architecture/RESILIENCE_GUIDE.md, CLAUDE.md                               |
 | [i18n-flow.mmd](./i18n-flow.mmd)                   | [SVG](./exported/i18n-flow.svg)          | docs/guides/I18N.md                                                            |
-| [mcp-tools-43.mmd](./mcp-tools-43.mmd)             | [SVG](./exported/mcp-tools-43.svg)       | docs/frameworks/MCP-SERVER.md                                                  |
+| [mcp-tools-87.mmd](./mcp-tools-87.mmd)             | [SVG](./exported/mcp-tools-87.svg)       | docs/frameworks/MCP-SERVER.md                                                  |
 | [cloud-agent-flow.mmd](./cloud-agent-flow.mmd)     | [SVG](./exported/cloud-agent-flow.svg)   | docs/frameworks/CLOUD_AGENT.md                                                 |
 | [authz-pipeline.mmd](./authz-pipeline.mmd)         | [SVG](./exported/authz-pipeline.svg)     | docs/architecture/AUTHZ_GUIDE.md                                               |
 | [db-schema-overview.mmd](./db-schema-overview.mmd) | [SVG](./exported/db-schema-overview.svg) | docs/architecture/CODEBASE_DOCUMENTATION.md                                    |

docs/diagrams/mcp-tools-43.mmd

@@ -1,31 +0,0 @@
-%% MCP Server tool inventory by category
-%% Reflects: open-sse/mcp-server/tools/* and docs/MCP-SERVER.md
-%% v3.8.8
-flowchart LR
-  MCP["MCP Server<br/>43 tools total"] --> Core["Core (30)"]
-  MCP --> Mem["Memory (3)"]
-  MCP --> Skl["Skills (4)"]
-  MCP --> Notion["Notion (6)"]
-
-  Core --> Essential["Essential (8)<br/>get_health, list_combos,<br/>switch_combo, check_quota,<br/>route_request, cost_report,<br/>list_models_catalog,<br/>get_combo_metrics"]
-  Core --> Search["Search (1)<br/>web_search"]
-  Core --> Advanced["Advanced (11)<br/>simulate_route, set_budget_guard,<br/>set_routing_strategy,<br/>set_resilience_profile,<br/>test_combo, get_provider_metrics,<br/>best_combo_for_task, explain_route,<br/>get_session_snapshot,<br/>db_health_check, sync_pricing"]
-  Core --> Cache["Cache (2)"]
-  Core --> Compression["Compression (5)"]
-  Core --> Tunnels["1Proxy / Tunnels (3)"]
-
-  Mem --> M1["memory_search"]
-  Mem --> M2["memory_save"]
-  Mem --> M3["memory_delete"]
-
-  Skl --> S1["skill_invoke"]
-  Skl --> S2["skill_list"]
-  Skl --> S3["skill_diagnose"]
-  Skl --> S4["skill_uninstall"]
-
-  Notion --> N1["notion_search"]
-  Notion --> N2["notion_get_page"]
-  Notion --> N3["notion_query_database"]
-  Notion --> N4["notion_get_database"]
-  Notion --> N5["notion_list_block_children"]
-  Notion --> N6["notion_append_blocks"]

docs/diagrams/mcp-tools-87.mmd

@@ -0,0 +1,15 @@
+%% MCP Server tool inventory by category
+%% Reflects: open-sse/mcp-server/ — TOTAL_MCP_TOOL_COUNT in server.ts
+%% (MCP_TOOLS 33 + memory 3 + skill 4 + agentSkill 3 + gamification 8 + plugin 8 + notion 6 + obsidian 22 = 87)
+%% Regenerate the SVG with: npm run docs:render-diagrams
+%% v3.8.26
+flowchart LR
+  MCP["MCP Server<br/>87 tools total"]
+  MCP --> Core["Core (33)<br/>routing, cache, compression,<br/>quota, proxy, tunnels, search"]
+  MCP --> Mem["Memory (3)<br/>memory_search, memory_save,<br/>memory_delete"]
+  MCP --> Skl["Skills (4)<br/>skill_invoke, skill_list,<br/>skill_diagnose, skill_uninstall"]
+  MCP --> ASkl["Agent-Skills (3)<br/>cli-registry discovery"]
+  MCP --> Gam["Gamification (8)"]
+  MCP --> Plg["Plugins (8)"]
+  MCP --> Notion["Notion (6)<br/>search, get_page, query_database,<br/>get_database, list_block_children,<br/>append_blocks"]
+  MCP --> Obs["Obsidian (22)<br/>vault read/write, search,<br/>frontmatter, daily notes, …"]

docs/frameworks/MCP-SERVER.md

@@ -8,11 +8,11 @@ lastUpdated: 2026-05-30
 
 > Model Context Protocol server with 87 tools across routing, cache, compression, memory, skills, proxy, and context source operations.
 >
-> Source of truth: `open-sse/mcp-server/schemas/tools.ts` (30 tools) + `open-sse/mcp-server/tools/memoryTools.ts` (3 tools) + `open-sse/mcp-server/tools/skillTools.ts` (4 tools) + `open-sse/mcp-server/tools/notionTools.ts` (6 tools). Tool registration and scope wiring lives in `open-sse/mcp-server/server.ts`.
+> Source of truth: `open-sse/mcp-server/schemas/tools.ts` (33 base) + `memoryTools.ts` (3) + `skillTools.ts` (4) + `agentSkillTools.ts` (3) + `gamificationTools.ts` (8) + `pluginTools.ts` (8) + `notionTools.ts` (6) + `obsidianTools.ts` (22) = **87** (`TOTAL_MCP_TOOL_COUNT`). Tool registration and scope wiring lives in `open-sse/mcp-server/server.ts`.
 
-![MCP tool inventory (43 tools by category)](../diagrams/exported/mcp-tools-43.svg)
+![MCP tool inventory (87 tools by category)](../diagrams/exported/mcp-tools-87.svg)
 
-> Source: [diagrams/mcp-tools-43.mmd](../diagrams/mcp-tools-43.mmd) (regenerate via `npm run docs:render-diagrams`).
+> Source: [diagrams/mcp-tools-87.mmd](../diagrams/mcp-tools-87.mmd) (regenerate via `npm run docs:render-diagrams`).
 
 ## Installation
 
@@ -217,7 +217,7 @@ See [AGENT-SKILLS.md](./AGENT-SKILLS.md) for the full catalog and how external a
 
 ## Related Frameworks (v3.8.0)
 
-The MCP tool inventory above (43 tools = 30 core + 3 memory + 4 skills + 6 notion) is intentionally
+The MCP tool inventory above (87 tools = 33 core + 3 memory + 4 skills + 3 agent-skills + 8 gamification + 8 plugins + 6 notion + 22 obsidian) is intentionally
 scoped to runtime routing/cache/compression/memory/skills/proxy/context-source operations. Two adjacent
 frameworks ship alongside the MCP server in v3.8.0 and are documented separately: