Critical gaps across all dimensions. Examined src/satisfactory_mcp/server.py: tool definitions lack visible input schemas, parameter descriptions, and output documentation. No tool has a description visible in the source code excerpt. Tool names follow verb_noun convention (e.g., 'search_items', 'list_factories') but lack supporting schema definitions. The 57 tools are registered but their parameter constraints, types, and return structures are not documented in the provided code. Without access to the full implementation, schemas cannot be verified. STDIO transport limits remote usability.
No tool descriptions visible in source code. All 57 tools lack descriptions required by pattern:tool-description. LLMs cannot determine when to select tools without descriptions.
Input schemas not visible in provided source excerpt. Cannot verify parameter types, constraints, or descriptions. Pattern:constrained-input and pattern:tool require explicit schema definitions.
No output schemas documented. Tools return data but LLMs cannot plan downstream calls without knowing response structure. Pattern:response-shaper requires documented return types.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 30 | 2025-06-18+ | v2 |
Generic tool names reduce clarity. 'factory_query', 'bom', 'stock', 'storage' lack action verbs or clear intent. 'factory_query' could mean search, filter, or retrieve, ambiguous for LLM selection.
No error handling guidance visible. Tools lack recovery hints (pattern:recovery-guide) or error classification (pattern:error-classification). LLMs cannot self-correct on failures.