MCP Server for Zaim API integration with OAuth 1.0a authentication. Provides tools for managing personal finance data including household budgets, money records, and account information.
Server has 14 well-structured tools with complete JSON schemas and Zod validation. All tools have descriptions (avg ~80 chars, within baseline 34-392). Naming follows verb_noun convention (get_, create_, update_, delete_). However, descriptions are terse and lack context about when to use each tool, dependencies, or recovery guidance. Parameter descriptions are present but minimal. No tool annotations (readOnlyHint/destructiveHint) despite clear risk levels. Output schemas are not documented, LLMs cannot predict response structure. Error handling exists (McpError with ErrorCode) but lacks actionable recovery guidance.
Zaim APIの認証状態をチェックし、アクセストークンの有効性を確認します
Zaimに収入記録を作成します
Zaimに支出記録を作成します
Zaimに振替記録を作成します(口座間の資金移動)
Zaimの家計簿記録を削除します。削除は永続的で復元できません。
Zaimで利用可能な通貨一覧を取得します
Zaimのデフォルトカテゴリ一覧を取得します(支出または収入)
Output schemas not documented. LLMs cannot predict response structure or plan downstream tool calls. zaim_get_money_records, zaim_create_payment, zaim_update_money_record, and others return JSON but no schema is visible in tool definitions.
Tool annotations missing. zaim_delete_money_record is DESTRUCTIVE and zaim_update_money_record is REVERSIBLE, but no destructiveHint or idempotentHint annotations present. LLMs cannot infer safety implications.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2025-06-18+ | v2 |
Zaimのデフォルトジャンル一覧を取得します(支出または収入)
Zaim家計簿の支出・収入・振替記録を取得します。日付範囲、カテゴリ、モードでフィルタリング可能です。
Zaimユーザーの口座一覧を取得します
Zaimユーザーのカスタムカテゴリ一覧を取得します
Zaimユーザーのカスタムジャンル一覧を取得します
Zaimユーザーの詳細情報(プロフィール、統計情報等)を取得します
Zaimの既存の家計簿記録を更新します
Descriptions lack context and recovery guidance. zaim_create_payment, zaim_create_income, zaim_create_transfer describe WHAT but not WHEN to use, dependencies (e.g. 'get categories first'), or error recovery. Avg description ~50 chars for write tools vs baseline 194 chars.
Error handling lacks actionable recovery. McpError is thrown with ErrorCode.InvalidParams but no guidance on what to do next (e.g. 'Try zaim_get_user_categories() to see valid category_id values'). Agents cannot self-correct.
No pagination or result limits documented. zaim_get_money_records accepts limit (default 20, max 100) but no documentation of total count, next_cursor, or guidance on when to paginate. zaim_get_user_categories, zaim_get_user_genres, zaim_get_user_accounts have no limit parameters.