MCP server that exposes mathematical operations (Add, Sub) and integrates with Rig AI framework for agent-based LLM interactions
Server provides 2 basic arithmetic tools (Add, Sub) with minimal but present input schemas and descriptions. Both tools have correct parameter types (number) and basic descriptions. However, the tool design violates single-responsibility and composition patterns: the tools perform trivial operations that would never be used in a real agent workflow. No output schema documentation. No error handling guidance. Descriptions are adequate but generic (under 50 chars). No parameter constraints or ranges. Tools lack the depth and maturity expected of production-grade utilities.
Adds two numbers together.
Subtract 2nd number from 1st
Tool names lack action verbs. 'Add' and 'Sub' do not follow verb_noun convention (e.g., 'add_numbers', 'subtract_numbers'). Generic names reduce clarity for LLM tool selection.
No output schema documented. Tools return ToolResponseContent with text content, but the structure and expected return type are not declared for the agent. LLMs cannot infer downstream chaining or structure.
No error handling or recovery guidance. Tools have no documented error cases, validation, or actionable recovery hints. If parameters are invalid (e.g., non-numeric), the LLM receives no guidance.
Descriptions are minimal and generic (under 50 chars). Both 'Adds two numbers together' and 'Subtract 2nd number from 1st' lack context on when to use these tools or what they return. No dependency hints.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-21 | F | 47 | <=2025-11-25 | v2 |
| 2026-03-09 | D | 51 | - | v1 |
No parameter constraints or ranges documented. Numeric parameters 'a' and 'b' have no min/max bounds, no overflow warnings, and no guidance on precision or scale. Unbounded numbers invite invalid LLM inputs.
Tool design lacks practical utility. Arithmetic addition and subtraction are toy operations unsuitable for real agent workflows. No indication of intended use case or domain context.