diff --git a/CLAUDE.md b/CLAUDE.md index 890259a433..ef4775a736 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -47,7 +47,7 @@ For full test matrix, see `CONTRIBUTING.md` → "Running Tests". For deep archit | Services | `open-sse/services/` | Combo routing, rate limits, caching, etc | | Database | `src/lib/db/` | SQLite domain modules (45+ files, 55 migrations) | | Domain/Policy | `src/domain/` | Policy engine, cost rules, fallback logic | -| MCP Server | `open-sse/mcp-server/` | 37 tools (30 base + 3 memory + 4 skills), 3 transports, ~13 scopes | +| MCP Server | `open-sse/mcp-server/` | 43 tools (30 base + 3 memory + 4 skills + 6 notion), 3 transports, ~13 scopes | | A2A Server | `src/lib/a2a/` | JSON-RPC 2.0 agent protocol | | Skills | `src/lib/skills/` | Extensible skill framework | | Memory | `src/lib/memory/` | Persistent conversational memory | diff --git a/docs/diagrams/README.md b/docs/diagrams/README.md index 8dd414d746..78d2bc48aa 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-37.mmd](./mcp-tools-37.mmd) | [SVG](./exported/mcp-tools-37.svg) | docs/frameworks/MCP-SERVER.md | +| [mcp-tools-43.mmd](./mcp-tools-43.mmd) | [SVG](./exported/mcp-tools-43.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-37.svg b/docs/diagrams/exported/mcp-tools-37.svg deleted file mode 100644 index 2877bf0caf..0000000000 --- a/docs/diagrams/exported/mcp-tools-37.svg +++ /dev/null @@ -1 +0,0 @@ -

MCP Server
37 tools total

Core (30)

Memory (3)

Skills (4)

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

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

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/mcp-tools-37.mmd b/docs/diagrams/mcp-tools-43.mmd similarity index 74% rename from docs/diagrams/mcp-tools-37.mmd rename to docs/diagrams/mcp-tools-43.mmd index bd0afb082c..df92e73896 100644 --- a/docs/diagrams/mcp-tools-37.mmd +++ b/docs/diagrams/mcp-tools-43.mmd @@ -1,10 +1,11 @@ %% MCP Server tool inventory by category %% Reflects: open-sse/mcp-server/tools/* and docs/MCP-SERVER.md -%% v3.8.0 +%% v3.8.8 flowchart LR - MCP["MCP Server
37 tools total"] --> Core["Core (30)"] + 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"] @@ -21,3 +22,10 @@ flowchart LR 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/frameworks/MCP-SERVER.md b/docs/frameworks/MCP-SERVER.md index 62cde24e4b..3e5790fb91 100644 --- a/docs/frameworks/MCP-SERVER.md +++ b/docs/frameworks/MCP-SERVER.md @@ -10,9 +10,9 @@ lastUpdated: 2026-05-30 > > 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`. -![MCP tool inventory by category](../diagrams/exported/mcp-tools-37.svg) +![MCP tool inventory (43 tools by category)](../diagrams/exported/mcp-tools-43.svg) -> Source: [diagrams/mcp-tools-37.mmd](../diagrams/mcp-tools-37.mmd). ⚠️ The rendered diagram still shows 37 tools — it predates the 6 `notionTools` (total of record is **43**, per the source-of-truth breakdown above). Regenerate `mcp-tools-43.{mmd,svg}` to refresh. +> Source: [diagrams/mcp-tools-43.mmd](../diagrams/mcp-tools-43.mmd) (regenerate via `npm run docs:render-diagrams`). ## Installation