A Rails-based MCP server with authentication, payment processing, and tool usage tracking
This is a Rails-based MCP server using the fastmcp gem that exposes two tools with significant quality gaps. MeTool has a simple, clear purpose but minimal schema documentation. FinancialCalculatorTool has better parameter definitions but lacks critical output schema documentation. Neither tool has descriptions longer than a few words, and neither documents output structure for LLM planning. The server uses a custom authentication model (Devise/Doorkeeper) and payment infrastructure (Stripe, UserToolUsage tracking) that is architecturally sound but not reflected in the tool definitions themselves. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) are present. The codebase shows sophisticated backend logic (refund handling, price customization per tool) but tool definitions remain bare-bones.
Calculate mortgage payments and other financial metrics
Get the current logged in user
MeTool has zero input schema documentation. Schema is an empty object {} with no formal definition visible in the code.
MeTool description is only 28 characters ('Get the current logged in user').
Neither tool documents output schema. MeTool returns JSON with 'id' and 'email' fields, but this is not formally declared. LLMs cannot plan downstream calls or know what fields to extract.
FinancialCalculatorTool's parameter descriptions mention 'e.g. 5.25' for interest_rate as an example.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 36 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 0 | - | v1 |
FinancialCalculatorTool accepts 'interest_rate' as an integer but the description says 'e.g. 5.25', implying a decimal. Type/description mismatch will cause LLM errors.
No tool annotations present. Neither tool declares readOnlyHint (both are read-only), destructiveHint, or idempotentHint. This is current-spec guidance (2026-07-28) that helps LLMs reason about safety and retryability.
FinancialCalculatorTool's error handling returns { error: 'User has no active subscription' } but does not guide the LLM on recovery. Should suggest: 'User has no active subscription. Call purchase_subscription() first.' per pattern:recovery-guide.
MeTool naming: 'MeTool' is not a verb_noun pattern. Should be 'get_current_user' or 'get_me'. Tool names starting with verbs let LLMs infer intent from the name alone.