Notion: ツールの説明文の採点結果

tools/list の取得日: 2026-09-30 (UTC)
出どころ: npm @notionhq/notion-mcp-server@1.0.0
ホームページ: github.com
採点の規則: v2

載せているのは点数、指摘、名前だけです

このページには、Notion のツールの説明文の点数と指摘、ツールと引数の名前を載せています。説明文はサーバーのものなので、出どころのページでお読みください。

公開の URL があるサーバーは、いまの状態を採点できます: URL から採点する

servers/notion

平均点: 33.0 / 100雨
ツールの数: 24
説明がほぼ同じ組: 57

サーバー全体

軽微
説明がほぼ同じ組は全部で 57 組あります（上位 12 組を表示）。confusable_pair_total
軽微
サーバーに instructions がありません。何のためのサーバーで、いつ使うかを、そこに 1 回だけ書いてください。Claude Code と Gemini CLI は、ツールの説明より先に instructions を読みます。instructions_missing

説明文がほぼ同じツールの組

57 組のうち 12 組を、説明の類似度が高い順に表示しています。
ツール	ツール	説明の類似度	名前の類似度
API-get-block-children	API-retrieve-a-block	0.88	0.33
API-retrieve-page-markdown	API-update-page-markdown	0.79	0.60
API-get-block-children	API-patch-block-children	0.78	0.60
API-retrieve-a-page	API-retrieve-a-page-property	0.78	0.80
API-query-data-source	API-retrieve-a-data-source	0.78	0.50
API-query-data-source	API-update-a-data-source	0.78	0.50
API-query-data-source	API-create-a-data-source	0.78	0.50
API-retrieve-a-data-source	API-update-a-data-source	0.78	0.67
API-retrieve-a-data-source	API-create-a-data-source	0.78	0.67
API-update-a-data-source	API-create-a-data-source	0.78	0.67
API-retrieve-a-block	API-update-a-block	0.75	0.60
API-retrieve-a-block	API-delete-a-block	0.75	0.60

ツール

API-query-data-source

20 / 100雨

目的: 6 / 20
使いどころ: 0 / 20
引数: 7 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
説明文が名前の言い換えになっています（9 語）。restates_name
要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
要対応
説明のない引数: filter、sorts、start_cursor、page_size、archived、in_trashparam_no_description
軽微
API-retrieve-a-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-retrieve-a-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
API-update-a-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-update-a-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
API-create-a-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-create-a-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
制約も例もない文字列の引数: start_cursorloose_string_param
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
真偽値の引数 archived の意味が分かりにくくなっています。vague_boolean
軽微
真偽値の引数 in_trash の意味が分かりにくくなっています。vague_boolean
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: data_source_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-create-a-comment

24 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 7 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
説明文が短すぎます（7 語）。too_short
要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
要対応
説明のない引数: parent、rich_text、rich_text[].textparam_no_description
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: parent。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-update-a-data-source

24 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 7 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
要対応
説明のない引数: title、description、propertiesparam_no_description
軽微
API-query-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-query-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
API-retrieve-a-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-retrieve-a-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
API-create-a-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-create-a-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: data_source_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-create-a-data-source

25 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 8 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
要対応
説明のない引数: parent、properties、titleparam_no_description
軽微
API-query-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-query-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
API-retrieve-a-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-retrieve-a-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
API-update-a-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-update-a-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: parent。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-get-user

25 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 8 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
説明文が短すぎます（6 語）。too_short
要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
要対応
説明のない引数: user_idparam_no_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: user_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-list-data-source-templates

25 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 8 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
要対応
説明のない引数: start_cursor、page_sizeparam_no_description
軽微
制約も例もない文字列の引数: start_cursorloose_string_param
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: data_source_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-patch-page

25 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 8 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
要対応
説明のない引数: properties、archived、icon、coverparam_no_description
軽微
真偽値の引数 archived の意味が分かりにくくなっています。vague_boolean
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: page_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-move-page

29 / 100雨

目的: 6 / 20
使いどころ: 0 / 20
引数: 16 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
説明文が名前の言い換えになっています（8 語）。restates_name
要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
説明のない引数: parentparam_no_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: page_id、parent。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-update-a-block

30 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 13 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
API-retrieve-a-block と説明文がほぼ同じです（類似度 0.75）。違いは名前とスキーマにしかありません。この説明文に、API-retrieve-a-block を使うのはどんなときかを書いてください。confusable_pair
軽微
説明のない引数: typeparam_no_description
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-post-page

34 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 17 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
説明のない引数: parent、propertiesparam_no_description
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: parent。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-post-search

34 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 12 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 5 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
説明のない引数: sort、filterparam_no_description
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
何が返るかが書かれていません。no_return_info

API-delete-a-block

35 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 18 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
API-retrieve-a-block と説明文がほぼ同じです（類似度 0.75）。違いは名前とスキーマにしかありません。この説明文に、API-retrieve-a-block を使うのはどんなときかを書いてください。confusable_pair
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-get-block-children

35 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 18 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
API-retrieve-a-block と説明文がほぼ同じです（類似度 0.88）。違いは名前とスキーマにしかありません。この説明文に、API-retrieve-a-block を使うのはどんなときかを書いてください。confusable_pair
軽微
API-patch-block-children と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-patch-block-children を使うのはどんなときかを書いてください。confusable_pair
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-get-users

35 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 18 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
説明文が短すぎます（6 語）。too_short
要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
何が返るかが書かれていません。no_return_info

API-patch-block-children

35 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 18 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
API-get-block-children と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-get-block-children を使うのはどんなときかを書いてください。confusable_pair
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-retrieve-a-block

35 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 18 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
API-get-block-children と説明文がほぼ同じです（類似度 0.88）。違いは名前とスキーマにしかありません。この説明文に、API-get-block-children を使うのはどんなときかを書いてください。confusable_pair
軽微
API-update-a-block と説明文がほぼ同じです（類似度 0.75）。違いは名前とスキーマにしかありません。この説明文に、API-update-a-block を使うのはどんなときかを書いてください。confusable_pair
軽微
API-delete-a-block と説明文がほぼ同じです（類似度 0.75）。違いは名前とスキーマにしかありません。この説明文に、API-delete-a-block を使うのはどんなときかを書いてください。confusable_pair
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-retrieve-a-comment

35 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 18 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
説明文が短すぎます（7 語）。too_short
要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-retrieve-a-data-source

35 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 18 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
API-query-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-query-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
API-update-a-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-update-a-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
API-create-a-data-source と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-create-a-data-source を使うのはどんなときかを書いてください。confusable_pair
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: data_source_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-retrieve-a-database

35 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 18 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: database_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-retrieve-a-page-property

35 / 100雨

目的: 10 / 20
使いどころ: 0 / 20
引数: 18 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
API-retrieve-a-page と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-retrieve-a-page を使うのはどんなときかを書いてください。confusable_pair
軽微
制約も例もない文字列の引数: start_cursorloose_string_param
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: page_id、property_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-retrieve-a-page

40 / 100曇り

目的: 10 / 20
使いどころ: 0 / 20
引数: 18 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 5 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
API-retrieve-a-page-property と説明文がほぼ同じです（類似度 0.78）。違いは名前とスキーマにしかありません。この説明文に、API-retrieve-a-page-property を使うのはどんなときかを書いてください。confusable_pair
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: page_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-get-self

42 / 100曇り

目的: 10 / 20
使いどころ: 0 / 20
引数: 25 / 25
戻り値: 0 / 15
制約と副作用: 7 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
何が返るかが書かれていません。no_return_info

API-retrieve-page-markdown

50 / 100曇り

目的: 17 / 20
使いどころ: 0 / 20
引数: 23 / 25
戻り値: 0 / 15
制約と副作用: 10 / 10
例: 0 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
軽微
API-update-page-markdown と説明文がほぼ同じです（類似度 0.79）。違いは名前とスキーマにしかありません。この説明文に、API-update-page-markdown を使うのはどんなときかを書いてください。confusable_pair
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: page_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

API-update-page-markdown

50 / 100曇り

目的: 17 / 20
使いどころ: 0 / 20
引数: 13 / 25
戻り値: 0 / 15
制約と副作用: 10 / 10
例: 10 / 10

要対応
いつ使うか、いつ使わないかが書かれていません。no_usage_context
要対応
説明のない引数: replace_content、update_content、insert_content、replace_content_rangeparam_no_description
軽微
API-retrieve-page-markdown と説明文がほぼ同じです（類似度 0.79）。違いは名前とスキーマにしかありません。この説明文に、API-retrieve-page-markdown を使うのはどんなときかを書いてください。confusable_pair
軽微
引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。params_not_in_description
軽微
何が返るかが書かれていません。no_return_info
軽微
必須の id 系の引数に、値をどこから得るかが書かれていません: page_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。id_source_missing

静的な採点で分からないこと

この点数は、説明文とスキーマの文字だけを読んで付けています。書かれているかどうかを示すもので、モデルがどう動くかではありません。browser_close のように、短くても名前で意味が明らかなツールは、実際にはモデルが正しく使えていても低く出ます。私たちの計測でも、名前とスキーマが違えば、いまのモデルは 1 行の説明文からでも 1 手で正しいツールを選びました。文字からは分からないこと（数手にわたる動き、書き足した一文が助けになるか誤らせるか）は、Pro と Team のプランの評価で測れます。

ご自身のサーバーの掲載をやめてほしい場合は、support@forecall.dev までご連絡ください。7 日以内に外します。

採点したサーバーの一覧