diff --git a/docs/diagrams/README.md b/docs/diagrams/README.md index 78d2bc48aa..437fb8da32 100644 --- a/docs/diagrams/README.md +++ b/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 | diff --git a/docs/diagrams/exported/mcp-tools-43.svg b/docs/diagrams/exported/mcp-tools-43.svg deleted file mode 100644 index dbeeac8496..0000000000 --- a/docs/diagrams/exported/mcp-tools-43.svg +++ /dev/null @@ -1 +0,0 @@ -

MCP Server
43 tools total

Core (30)

Memory (3)

Skills (4)

Notion (6)

Essential (8)
get_health, list_combos,
switch_combo, check_quota,
route_request, cost_report,
list_models_catalog,
get_combo_metrics

Search (1)
web_search

Advanced (11)
simulate_route, set_budget_guard,
set_routing_strategy,
set_resilience_profile,
test_combo, get_provider_metrics,
best_combo_for_task, explain_route,
get_session_snapshot,
db_health_check, sync_pricing

Cache (2)

Compression (5)

1Proxy / Tunnels (3)

memory_search

memory_save

memory_delete

skill_invoke

skill_list

skill_diagnose

skill_uninstall

notion_search

notion_get_page

notion_query_database

notion_get_database

notion_list_block_children

notion_append_blocks

 \ No newline at end of file diff --git a/docs/diagrams/exported/mcp-tools-87.svg b/docs/diagrams/exported/mcp-tools-87.svg new file mode 100644 index 0000000000..5c3882f07b --- /dev/null +++ b/docs/diagrams/exported/mcp-tools-87.svg @@ -0,0 +1 @@ +

MCP Server
87 tools total

Core (33)
routing, cache, compression,
quota, proxy, tunnels, search

Memory (3)
memory_search, memory_save,
memory_delete

Skills (4)
skill_invoke, skill_list,
skill_diagnose, skill_uninstall

Agent-Skills (3)
cli-registry discovery

Gamification (8)

Plugins (8)

Notion (6)
search, get_page, query_database,
get_database, list_block_children,
append_blocks

Obsidian (22)
vault read/write, search,
frontmatter, daily notes, …

 \ No newline at end of file diff --git a/docs/diagrams/mcp-tools-43.mmd b/docs/diagrams/mcp-tools-43.mmd deleted file mode 100644 index df92e73896..0000000000 --- a/docs/diagrams/mcp-tools-43.mmd +++ /dev/null @@ -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
43 tools total"] --> Core["Core (30)"] - MCP --> Mem["Memory (3)"] - MCP --> Skl["Skills (4)"] - MCP --> Notion["Notion (6)"] - - Core --> Essential["Essential (8)
get_health, list_combos,
switch_combo, check_quota,
route_request, cost_report,
list_models_catalog,
get_combo_metrics"] - Core --> Search["Search (1)
web_search"] - Core --> Advanced["Advanced (11)
simulate_route, set_budget_guard,
set_routing_strategy,
set_resilience_profile,
test_combo, get_provider_metrics,
best_combo_for_task, explain_route,
get_session_snapshot,
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"] diff --git a/docs/diagrams/mcp-tools-87.mmd b/docs/diagrams/mcp-tools-87.mmd new file mode 100644 index 0000000000..fc3217c40d --- /dev/null +++ b/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
87 tools total"] + MCP --> Core["Core (33)
routing, cache, compression,
quota, proxy, tunnels, search"] + MCP --> Mem["Memory (3)
memory_search, memory_save,
memory_delete"] + MCP --> Skl["Skills (4)
skill_invoke, skill_list,
skill_diagnose, skill_uninstall"] + MCP --> ASkl["Agent-Skills (3)
cli-registry discovery"] + MCP --> Gam["Gamification (8)"] + MCP --> Plg["Plugins (8)"] + MCP --> Notion["Notion (6)
search, get_page, query_database,
get_database, list_block_children,
append_blocks"] + MCP --> Obs["Obsidian (22)
vault read/write, search,
frontmatter, daily notes, …"] diff --git a/docs/frameworks/MCP-SERVER.md b/docs/frameworks/MCP-SERVER.md index 6d78d5e48d..03a3f674e8 100644 --- a/docs/frameworks/MCP-SERVER.md +++ b/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: