MCP tool for currency conversion using exchangerate-api.com
Single tool with adequate schema and basic description. Input schema is present with typed parameters (amount: number, from_currency: string, to_currency: string) and descriptions for each. Tool description exists (89 chars) but is generic and lacks guidance on when to use it vs alternatives. No output schema documented in the tool definition itself, output structure is only visible in code comments and JSDoc, not in the MCP tool registration. Error handling returns structured objects but lacks recovery guidance (e.g., 'Try with a different currency code'). No parameter constraints (enums for currency codes, min/max for amount). Tool does one thing well but lacks LLM-optimization patterns.
MCP Tool to convert an amount from one currency to another using the exchangerate-api.com service.
No output schema documented in tool definition. Output structure (original_amount, from_currency, to_currency, converted_amount, exchange_rate, last_updated_utc) is only visible in JSDoc comments and code, not in the MCP tool registration metadata. LLMs cannot plan downstream operations without knowing what fields to expect.
Currency code parameters lack enum constraints. 'from_currency' and 'to_currency' accept free-form strings, inviting hallucinated invalid codes like 'USDA' or 'EURX'. Should declare valid ISO 4217 codes as an enum or provide a discovery tool (list_supported_currencies).
Amount parameter lacks numeric constraints. No minimum (0?), maximum, or decimal precision guidance. LLMs could pass negative amounts, zero, or absurdly large values. Description should state: 'Positive number, up to 2 decimal places.'
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | 2026-07-28+ | v2 |
Error messages lack recovery guidance. When API returns 'unknown-code', the tool returns {'error': 'Unsupported or invalid base currency code...'} but does not suggest next steps (e.g., 'Call list_supported_currencies() to see valid codes'). Agents cannot self-correct.
Tool description is generic and does not explain when to use it or what it returns. Current: 'MCP Tool to convert an amount from one currency to another using the exchangerate-api.com service.' Should include: 'Returns converted amount, exchange rate, and last update timestamp. Supports ISO 4217 currency codes.'