MCP Server that provides a tool to evaluate Common Expression Language (CEL) expressions
Single tool 'evaluate' has a clear verb-noun name and basic description. Input schema is present with typed parameters (expression: string, context: object). However, the description is minimal (67 chars, below the 194-char baseline), lacks WHEN/WHY guidance, and omits error recovery hints. Output schema is documented but returns a generic string result rather than structured CEL value details. Parameter descriptions are present but sparse. No mention of CEL syntax constraints, error cases, or common pitfalls. Tool is read-only (good), but lacks idempotent/destructive annotations. Composition is sound (single responsibility), but error handling is generic ('Evaluation failed') without actionable recovery guidance.
Evaluates a Common Expression Language (CEL) expression.
Tool description is too brief (67 chars vs 194-char baseline). Lacks WHEN to use, prerequisites, and error recovery hints. LLMs cannot determine when to select this tool over alternatives or how to handle failures.
Output schema returns a generic string 'result' field. Should return structured CEL value with type information (e.g., {value: <any>, type: 'int'|'string'|'bool'|'list'|'map'}) to enable downstream tool chaining and type-aware reasoning.
Parameter 'context' is typed as object but lacks description of expected structure, valid key names, or value types. LLMs cannot infer whether context should be {a: 1, b: 2} or {variables: {a: 1}} or other formats.
Error messages are generic ('Evaluation failed: ...') without actionable recovery guidance. Should indicate whether error is retryable, user-fixable (e.g., syntax error in expression), or fatal.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | <=2025-11-25 | v2 |
No tool annotations present. Should declare readOnlyHint=true (tool is read-only, safe to retry) and idempotentHint=true (same expression + context always produces same result) to guide agent planning.