月食・スーパームーン
get_moon_events月食(皆既・部分・半影、日本での見え方と時刻)とスーパームーンの一覧。year(1926〜2080)か、start と end(366日まで)で指定。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | YYYY-MM-DD(1926-01-01〜2080-12-31) | |
| year | No | ||
| start | No | YYYY-MM-DD(1926-01-01〜2080-12-31) |
get_moon_events月食(皆既・部分・半影、日本での見え方と時刻)とスーパームーンの一覧。year(1926〜2080)か、start と end(366日まで)で指定。
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | YYYY-MM-DD(1926-01-01〜2080-12-31) | |
| year | No | ||
| start | No | YYYY-MM-DD(1926-01-01〜2080-12-31) |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
アノテーションが readOnlyHint=true、openWorldHint=false、destructiveHint=false を宣言しており、安全性の説明はアノテーションに任せられる。その上で、対象期間(1926〜2080)や日付範囲の上限366日、返される内容(食の種類・日本での見え方・時刻・スーパームーン)といった振る舞いの文脈を記述しており、追加価値がある。
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?
2文のみで、対象(月食・スーパームーン)を先頭に、次に指定方法を置く構成で無駄がない。すべての文が情報を提供している。
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?
出力スキーマはないが、説明が返却内容(食の種類・日本での見え方・時刻・スーパームーン)を伝えている。ただし、必須引数が0個であるにもかかわらず引数無しで呼んだ場合の挙動(全期間か、エラーか)が説明されておらず、わずかな不足がある。
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?
スキーマの説明カバレッジは67%で、year パラメータにはスキーマ上の説明がないが、説明文が同じ範囲(1926〜2080)を補っている。さらに、スキーマにはない「start と end は366日まで」という制約と「year か start/end のいずれか」という排他的な指定方法を示しており、スキーマ以上の意味を加えている。
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?
具体的な動詞と対象(月食一覧とスーパームーン一覧)を示し、皆既・部分・半影といった対象範囲や日本での見え方・時刻まで明示している。ただし、類似する get_moon_phases という兄弟ツールとの違いを明示的に述べていないため、4点とする。
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?
「year で指定するか、start と end で指定する(366日まで)」と指定方法の分岐は示しているが、どちらをいつ使うべきか、また get_moon_phases など他のツールを選ぶ条件は示されていない。引数が0個の場合はどうなるかも不明であり、暗黙の使用法にとどまる。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.