Bridge to CATIA Magic (Cameo Systems Modeler) for SysML/UML model creation, querying, and manipulation via the CameoMCPBridge plugin.
Three tools present with descriptions, but critical gaps in schema definition and parameter documentation. All tools are READ_ONLY status checks with empty input schemas ({}), making them trivial from a definition perspective. Descriptions are present (100-150 chars each) but lack actionable guidance on when to use each tool vs. the others. No input parameters means no parameter descriptions to evaluate. Output schemas are not documented in the visible code. Tool names follow verb_noun pattern (cameo_status, cameo_get_capabilities, cameo_probe_bridge) but lack clarity on distinctions, all three appear to probe bridge health, creating potential LLM confusion about which to call first.
Get machine-readable plugin capabilities and version-lockstep metadata. Use this to confirm which bridge contract the installed Java plugin exposes before relying on newer query or diagram semantics. Returns: JSON with endpoint groups, versions, and client compatibility fields.
Probe common local bridge endpoints and report the preferred health paths. Use this when a caller is unsure whether the bridge is exposed at `/status` or `/api/v1/status`, or wants a concise machine-readable reachability check before attempting model work.
Check if CATIA Magic is running and the CameoMCPBridge plugin is responsive. Returns: JSON with plugin status, capability metadata, and client compatibility annotations. If `compatibility.clientCompatible` is false, rebuild and redeploy the plugin before attempting write operations.
No input schemas visible for any tool. Cannot verify parameter types, descriptions, or constraints.
No output schemas documented. Tool descriptions mention 'Returns JSON with...' but the actual response structure (field names, types, nesting) is not defined in visible code. LLMs cannot plan downstream calls or extract specific fields.
Three tools all probe bridge health/status with overlapping purpose. Descriptions do not clearly explain when to call cameo_status vs cameo_get_capabilities vs cameo_probe_bridge. LLMs will struggle to select the right one.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Descriptions reference internal concepts ('compatibility.clientCompatible', 'endpoint groups', 'bridge contract') without explaining what they mean to an LLM or user. Descriptions should state WHAT, WHEN, and WHY in plain language.
No error handling guidance. Descriptions do not explain what to do if the bridge is unreachable, incompatible, or returns an error. LLMs need recovery paths.