Skip to content

Commit 2f4827c

Browse files
akoclaude
andcommitted
docs(mcp): record Concord's full 44-tool inventory
The Concord section detailed only the ~6 wired/tested tools. Replace the brief "candidate gap-closers" note with the complete 44-tool inventory (captured 2026-06-15 via a fresh tools/list), grouped by category with read/write and wired-status flags. Two behaviors now recorded: - tools/list is context-curated — after concord__set_task_context it returns a curated subset; the full 44 require a fresh list with no task context. - no Maia / agent-invoke tool exists (the concord__* tools are agent self- management helpers, not a way to run Maia) — answers a recurring question and belongs on the per-version re-probe radar. Flags the highest-value unwired gap-closers (the rename_* family vs PED's set /name, and manage_navigation) that could fill PED limits the matrix marks unsupported, pending identity-preservation vetting per ADR-0002. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent d5c209c commit 2f4827c

1 file changed

Lines changed: 70 additions & 6 deletions

File tree

docs/03-development/PED_MCP_CAPABILITIES.md

Lines changed: 70 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -448,12 +448,76 @@ Studio Pro). `get_app_status` is read-only and returns valid data but reflects r
448448
port state (can be a stale runtime). Net: only `delete_document` and
449449
`check_model` are dependable today.
450450

451-
Candidate gap-closers not yet wired: `delete_model_element` (entity/attribute/
452-
association — but PED already deletes these, so low priority; snake_case args
453-
`{element_type, entity_name}`), `check_project_errors` (full-project validation —
454-
currently stubbed in Concord), `refresh_project`. Concord identity captured
455-
2026-06-08: `concord-mcp` (proto
456-
`2025-03-26`), 44 tools, on port 7783 (directly container-reachable; no socat).
451+
### Full tool inventory (44 tools, captured 2026-06-15)
452+
453+
Concord identity: `concord-mcp` (proto `2025-03-26`), port 7783 (directly
454+
container-reachable; no socat). **Two behaviors to know:**
455+
456+
- **`tools/list` is context-curated.** After `concord__set_task_context`, a
457+
subsequent `tools/list` returns only a *curated subset* relevant to the declared
458+
task. The full 44 below come from a fresh `tools/list` with no task context set.
459+
Always re-probe without a task context to see everything.
460+
- **No Maia / agent-invoke tool.** Like PED, Concord exposes *tools an agent uses*,
461+
not a "run the Maia agent" entrypoint. The `concord__*` tools are agent **self-
462+
management** helpers (calibration, friction journal, tool discovery), not Maia.
463+
464+
Wired/tested status: ✅ dependable · ⚠️ UI-automation, unreliable (see above) ·
465+
○ present, not yet wired/vetted. `R` = readOnlyHint.
466+
467+
| Category | Tool | R/W | Status / note |
468+
|----------|------|-----|---------------|
469+
| Domain model | `rename_entity` | W | ○ in-place, identity-preserving rename (PED only does `set /name`) |
470+
| Domain model | `rename_attribute` | W | ○ identity-preserving |
471+
| Domain model | `rename_association` | W | ○ identity-preserving |
472+
| Domain model | `rename_module` | W | ○ identity-preserving |
473+
| Domain model | `rename_document` | W | ○ identity-preserving |
474+
| Domain model | `set_documentation` | W | ○ set element documentation |
475+
| Domain model | `arrange_domain_model` | W | ○ auto-layout entities/associations |
476+
| Domain model | `delete_model_element` | W | ○ delete entity/attribute/association (PED already removes these via array op) |
477+
| Constants/enums | `rename_enumeration_value` | W | ○ identity-preserving |
478+
| Microflows | `modify_microflow_activity` | W | ○ mutate an activity by 1-based position |
479+
| Microflows | `insert_before_activity` | W | ○ sequence an activity |
480+
| Microflows | `set_microflow_url` | W ||
481+
| Pages | `delete_document` | W | ✅ real `DROP` of standalone docs (wired) |
482+
| Pages | `exclude_document` | W ||
483+
| Pages | `generate_overview_pages` | W | ○ CRUD list + new-edit pages |
484+
| Navigation | `manage_navigation` | W | ○ menu structure, home page, role gating (PED has no nav path) |
485+
| Project settings | `read_configurations` | R ||
486+
| Project settings | `set_configuration` | W ||
487+
| Project settings | `read_runtime_settings` | R ||
488+
| Project settings | `set_runtime_settings` | W ||
489+
| Project settings | `get_active_run_configuration` | R | ○ which run config will run |
490+
| Validation/diag | `check_model` | R | ✅ domain-model consistency check (wired, `--mcp-check`) |
491+
| Validation/diag | `check_project_errors` | R | ○ full-project "Check All Errors" — reported stubbed in Concord |
492+
| Validation/diag | `analyze_project_patterns` | R | ○ architectural pattern/anti-pattern scan |
493+
| Validation/diag | `get_last_error` | R ||
494+
| Validation/diag | `get_studio_pro_logs` | R ||
495+
| Security (read) | `audit_security` | R | ○ full security audit (intended) |
496+
| Security (read) | `read_entity_access_rules` | R ||
497+
| Security (read) | `read_microflow_security` | R ||
498+
| Security (read) | `read_security_info` | R | ○ project security overview |
499+
| App runtime | `get_app_status` | R | ✅ valid data, but raw port probe (can be a stale runtime) |
500+
| App runtime | `run_app` | W | ⚠️ UI automation — `command_sent`, no effect |
501+
| App runtime | `stop_app` | W | ⚠️ UI automation — `command_sent`, app stays running |
502+
| App runtime | `save_all` | W | ⚠️ UI automation — does not persist and **hangs Studio Pro**; save manually |
503+
| Project | `refresh_project` | W | ○ force re-scan of project dir for external file changes |
504+
| Concord meta | `concord__session_context` | R | ○ session-start briefing (call once) |
505+
| Concord meta | `concord__set_task_context` | W | ○ declares task → curates subsequent `tools/list` |
506+
| Concord meta | `concord__find_tool` | R | ○ free-text "which tool for this task" |
507+
| Concord meta | `concord__verify` | R | ○ verify a high-level workflow (e.g. `entity_created`) actually applied |
508+
| Concord meta | `concord__diagnose_project` | R | ○ parallel project-state probes (SP running? .mpr locked?) |
509+
| Concord meta | `concord__calibration_summary` | R | ○ C4 calibration journal summary |
510+
| Concord meta | `concord__record_calibration` | W | ○ append (claimed, actual) calibration entry |
511+
| Concord meta | `concord__silence_friction` | W | ○ suppress friction-wire emission for a tool |
512+
| Concord meta | `concord__tried_approaches` | R | ○ prior friction occurrences for a pattern/tool |
513+
514+
**Highest-value unwired gap-closers** (would fill PED limits the matrix currently
515+
marks unsupported, pending probe + identity-preservation vetting per
516+
[ADR-0002](../13-decisions/0002-backend-abstraction.md) and the "don't fake
517+
identity ops" rule): the `rename_*` family (true renames vs PED's `set /name`) and
518+
`manage_navigation` (no PED nav write path). `check_project_errors` and
519+
`refresh_project` are also candidates. `delete_model_element` is low priority (PED
520+
already removes entities/associations).
457521

458522
## Onboarding a new Studio Pro version
459523

0 commit comments

Comments
 (0)