A financial assistance server providing tools for emergency fund calculation, investment simulation, savings analysis, expense extraction, and financial product recommendations. Built with FastAPI and integrated with LangGraph agents.
This server has fundamental definition quality gaps. Tool names lack action verbs (e.g., 'extract_expense' is acceptable but 'ping' is deprecated). Descriptions are present but generic and lack LLM-optimization guidance. Input schemas are visible in Pydantic models but lack proper JSON Schema documentation in the tool registration layer. No output schemas are documented. Error handling is minimal, most errors return generic HTTP 500 responses without recovery guidance. The server appears to be a FastAPI HTTP service, not a proper MCP server with tool registration via the MCP protocol. Tool definitions are inferred from route handlers rather than explicitly registered with the MCP server.
Analyzes savings capacity by calculating the difference between income and expenses
Calculates emergency fund by multiplying monthly expenses by number of months (default 6 months)
Extracts expense value in Brazilian Real (R$) from user text using regex pattern matching
Retrieves the current IPCA (Índice de Preços ao Consumidor Amplo - inflation index) from the Brazilian Central Bank API
Retrieves the current SELIC (Banco Central do Brasil reference rate) from the Brazilian Central Bank API
Health check endpoint that returns server status
Tool definitions are inferred from FastAPI routes, not explicitly registered via MCP protocol. No evidence of MCP server initialization, tool registration with schemas, or MCP-compliant transport.
No output schemas documented. Tools return unstructured JSON (e.g., {"result": value}) without declaring expected fields, types, or structure for downstream tool chaining.
Error handling returns generic HTTP 500 with minimal context. No recovery guidance, error classification, or actionable messages for LLM retry logic.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 38 | <=2025-11-25 | v2 |
Simulates investment growth using compound interest formula: principal * ((1 + rate) ^ years)
Suggests financial products based on user investment profile (conservador, moderado, or arrojado)
Tool descriptions are generic and lack LLM-optimization. Most are 40 - 50 chars, below the 50-char minimum for actionable guidance. Missing WHEN to use, prerequisites, and dependencies.
'ping' is a deprecated MCP pattern (removed in 2026-07-28 spec). Health checks should be implicit or use a dedicated monitoring endpoint outside the tool set.