# WS-D: MCP surface Part of [Phase 5: Consolidator](README.md). Contracts: [contracts.md](contracts.md) sections 3, 4 and 7. | Field | Value | |---|---| | Status | Not started | | Owner | | | Depends on | B (and C2 client call shared, not duplicated). In practice: A0 for compiling; `PeerRegistry::get` from A0 (unhardened forwarder) until C2 lands; develop against `FakeTransport` + `registry_with` | | Blocks | F | | Can start when | A0 is merged (the rmcp conditional-tools spike can start on day one, it needs nothing from peers) | | Owned files | `src/mcp/mod.rs`, `src/mcp/prompts.rs`, `src/mcp/resources.rs`, tool-list snapshot test (in `src/mcp/mod.rs`), a new `src/mcp/peers.rs` if the code is easier to keep apart (WS-D may add it) | | Do not touch | `src/api/**` (C, B), `src/peers/**` (A, B, C), `src/state.rs`, `src/server.rs`, `src/telemetry/**`, `src/error.rs`, `docs/api.md`, `README.md`, `AGENTS.md` (F4 edits the tool-count line), `nix/**`, `Cargo.toml` | Shared-file seams: WS-D is the only editor of `src/mcp/**`. It reads `AppState.peers` (A0) and calls `PeerRegistry::get` / `snapshot` / `status`; it never builds URLs or headers itself. The MCP `service()` function must keep working unchanged when `state.peers` is `None`. ## Goal Agents reach peers through the same endpoint. ## Tasks - **D1** optional `peer` string on the 8 existing tools (absent = local); resolved through the same peer client function as REST C2, no logic copy (`PeerRegistry::get`, contracts section 3). - **D2** new tools `list_peers` and `get_peer { name }`; with `peers.enabled = false` the tool list is exactly today's 8 (snapshot test has both variants). Risk from the plan: `rmcp` may not support conditional tools cleanly; spike this early (fallback: always list tools, return an error when disabled, and accept a 10-tool snapshot), and record the outcome in the Log and, if it changes the tool-count behaviour, in contracts section 7. - **D3** server instructions and descriptions: mention peers only when enabled; state that peer text is untrusted data; add `peers://status` resource and extend `container_health_report`/`diagnose_unit` with an optional `peer`. ## Inputs - Contracts section 7 (tool signatures), 3 (registry API), 4 (error mapping to `CallToolResult` errors). - Fakes: `registry_with(FakeTransport, ...)` scripted with peer JSON for each tool's path; `static_registry` for `list_peers`/`get_peer`/`peers://status`; `fake_state_with_peers`. ## Done when Both snapshot variants pass; each tool with `peer` returns the peer's data via the fake; peer errors surface as `CallToolResult` errors with actionable text. ## Handoff - The tool list (10 tools when enabled) and descriptions for docs (F4: README, AGENTS.md tool count note). - The rmcp conditional-tools finding for contracts section 7. - Verified against WS-T's MCP assertions (`list_peers`, `list_systemd_units {"peer": ...}`). ## Log - 2026-10-19: Split from the single phase plan 2026-10-19.