Tools & MCP Platform — microservices¶

Generated from the architecture model

This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.

Every logical service keeps its own design page and model entry; deployment granularity says how it is shipped at first (decision D23). Modules of a host are deployed inside that host until an extraction decision is recorded.

flowchart TB
    subgraph ToolExecutorHost["ToolExecutorHost (host)"]
        McpServerRegistryService["McpServerRegistryService"]
        ToolAdapterService["ToolAdapterService"]
    end
    McpConnectorService[("McpConnectorService<br/>external")]
    classDef later stroke-dasharray: 4 4;

Hold "Alt" / "Option" to enable pan & zoom

Service	Context	Granularity	Host	Status	Page
McpConnectorService	BC-08	external / canonical	—	unmodelled	—
McpServerRegistryService	BC-08	module of host	ToolExecutorHost	target	design
ToolAdapterService	BC-08	module of host	ToolExecutorHost	target	design
ToolExecutorHost	BC-08	standalone host	—	target	design

McpConnectorService¶

ConnectSoft.Extensions.ModelContextProtocol


Bounded context	BC-08 Tool Execution
Granularity	external / canonical · ref `ext-mcp-library`
Former catalog group	Integration Platform (external)
Status	unmodelled
Design page	not written yet

McpServerRegistryService¶

Registry of MCP servers, their tools, authentication and governance policy (D44).


Bounded context	BC-08 Tool Execution
Granularity	module of host · host `ToolExecutorHost`
Former catalog group	(added 2026-10-09) (module)
Status	target
Modelled	1 aggregates · 6 REST + 2 gRPC · 3 events · 2 workers · 4 tables
Design page	planes/capability-tools/tools/services/mcp-server-registry-service/index.md

ToolAdapterService¶

Governed tool executor (GW-05): descriptor validation, permission, policy, class raising, approval binding, credential and sandbox brokering, execution, sanitization, receipts (BC-08).


Bounded context	BC-08 Tool Execution
Granularity	module of host · host `ToolExecutorHost`
Former catalog group	Agent Mesh (module)
Status	target
Modelled	2 aggregates · 6 REST + 3 gRPC · 7 events · 3 workers · 3 tables
Design page	planes/capability-tools/tools/services/tool-adapter-service/index.md

ToolExecutorHost¶

Governed tool executor and MCP hosting.


Bounded context	BC-08 Tool Execution
Granularity	standalone host
Former catalog group	(host added 2026-10-09) (module)
Status	target
Modelled	0 aggregates · 2 REST + 0 gRPC · 0 events · 0 workers · 0 tables
Design page	planes/capability-tools/tools/services/tool-executor-host/index.md