Fetch monthly balance sheet transition data for a given office and fiscal year. Compare changes across months, with optional tax and sub-account inclusion.
貸借対照表の推移表（月別）を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | 推移表の種類（例: monthly） | |
| end_month | No | ||
| fiscal_year | No | ||
| include_tax | No | ||
| office_code | No | 対象事業者の事業者番号（XXXX-XXXX）。APIキー認証では必須。MF_OFFICE_CODE を設定していれば省略可 | |
| start_month | No | ||
| with_sub_accounts | No |
Changes observed during successful MCP inspections.
v0.1.0Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
アノテーションが一切ないため、説明が行動特性を伝える唯一の手段だが、「取得します」という読み取り操作であること以外の情報がない。認証要件、レスポンス形式、制約、副作用の有無などが開示されていない。
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
一文で無駄がなく、簡潔である。ただし必要情報が欠けているため「簡潔すぎる」状態だが、冗長さはなく構造自体は適切。
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
アノテーションも出力スキーマもなく、7つのパラメータのうち5つが未説明である状況で、この説明はエージェントが正しく呼び出すには不十分。月次範囲の指定方法や税込み・補助科目フラグの扱いなどが不明。
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
スキーマ説明カバレッジが29%と低く、typeとoffice_code以外のパラメータは未説明。説明文の「月別」がstart_monthやend_monthを連想させる程度で、fiscal_year、include_tax、with_sub_accountsなどの意味を補完していない。
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
「貸借対照表の推移表（月別）を取得します」という明確な動詞と対象リソースを示しており、何をするツールかは分かる。ただし、兄弟ツールであるgetReportsTrialBalanceBalanceSheetやgetReportsTransitionProfitLossとの違いは明示されていない。
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
いつ使うべきか、いつ使うべきでないか、代替ツールとの使い分けについての情報が一切ない。試算表ベースの貸借対照表や損益計算書の推移表との選択基準も説明されていない。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.