Forecall
Failure recordsDocs
All scored servers

Notion: tool descriptions scored

tools/list taken
(UTC)
From
npm @notionhq/notion-mcp-server@1.0.0
Homepage
github.com
Scoring rules
v2

Scores, issues and names only

This page shows how Notion's tool descriptions scored, the issues found and the names of its tools and parameters. The descriptions are the server's own: read them where the copy came from.

A server with a public URL can be scored as it is today: score from a URL

servers/notion
Average score
33.0 / 100Rain
Tools
24
Near-identical descriptions
57

Across the server

  • Minor
    57 pairs with nearly the same description in all; the top 12 are shown.confusable_pair_total
  • Minor
    The server has no instructions. Say there, once, what the server is for and when to use it: Claude Code and Gemini CLI read the instructions before the tool descriptions.instructions_missing

Tools whose descriptions are nearly the same

12 of 57 pairs shown, highest description similarity first.
ToolToolDescription similarityName similarity
API-get-block-childrenAPI-retrieve-a-block0.880.33
API-retrieve-page-markdownAPI-update-page-markdown0.790.60
API-get-block-childrenAPI-patch-block-children0.780.60
API-retrieve-a-pageAPI-retrieve-a-page-property0.780.80
API-query-data-sourceAPI-retrieve-a-data-source0.780.50
API-query-data-sourceAPI-update-a-data-source0.780.50
API-query-data-sourceAPI-create-a-data-source0.780.50
API-retrieve-a-data-sourceAPI-update-a-data-source0.780.67
API-retrieve-a-data-sourceAPI-create-a-data-source0.780.67
API-update-a-data-sourceAPI-create-a-data-source0.780.67
API-retrieve-a-blockAPI-update-a-block0.750.60
API-retrieve-a-blockAPI-delete-a-block0.750.60

Tools

API-query-data-source

20 / 100Rain

Purpose
6 / 20
When to use
0 / 20
Arguments
7 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    The description only restates the name (9 words).restates_name
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: filter, sorts, start_cursor, page_size, archived, in_trash.param_no_description
  • Minor
    Its description is nearly the same as API-retrieve-a-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-retrieve-a-data-source instead.confusable_pair
  • Minor
    Its description is nearly the same as API-update-a-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-update-a-data-source instead.confusable_pair
  • Minor
    Its description is nearly the same as API-create-a-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-create-a-data-source instead.confusable_pair
  • Minor
    String arguments with no constraint or example: start_cursor.loose_string_param
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    The meaning of the boolean argument archived is unclear.vague_boolean
  • Minor
    The meaning of the boolean argument in_trash is unclear.vague_boolean
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: data_source_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-create-a-comment

24 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
7 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    The description is too short (7 words).too_short
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: parent, rich_text, rich_text[].text.param_no_description
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: parent. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-update-a-data-source

24 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
7 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: title, description, properties.param_no_description
  • Minor
    Its description is nearly the same as API-query-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-query-data-source instead.confusable_pair
  • Minor
    Its description is nearly the same as API-retrieve-a-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-retrieve-a-data-source instead.confusable_pair
  • Minor
    Its description is nearly the same as API-create-a-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-create-a-data-source instead.confusable_pair
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: data_source_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-create-a-data-source

25 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
8 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: parent, properties, title.param_no_description
  • Minor
    Its description is nearly the same as API-query-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-query-data-source instead.confusable_pair
  • Minor
    Its description is nearly the same as API-retrieve-a-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-retrieve-a-data-source instead.confusable_pair
  • Minor
    Its description is nearly the same as API-update-a-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-update-a-data-source instead.confusable_pair
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: parent. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-get-user

25 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
8 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    The description is too short (6 words).too_short
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: user_id.param_no_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: user_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-list-data-source-templates

25 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
8 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: start_cursor, page_size.param_no_description
  • Minor
    String arguments with no constraint or example: start_cursor.loose_string_param
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: data_source_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-patch-page

25 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
8 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: properties, archived, icon, cover.param_no_description
  • Minor
    The meaning of the boolean argument archived is unclear.vague_boolean
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: page_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-move-page

29 / 100Rain

Purpose
6 / 20
When to use
0 / 20
Arguments
16 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    The description only restates the name (8 words).restates_name
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Arguments without a description: parent.param_no_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: page_id, parent. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-update-a-block

30 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
13 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Its description is nearly the same as API-retrieve-a-block's (similarity 0.75); only the names and schemas tell them apart. Say in this description when to use API-retrieve-a-block instead.confusable_pair
  • Minor
    Arguments without a description: type.param_no_description
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: block_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-post-page

34 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
17 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Arguments without a description: parent, properties.param_no_description
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: parent. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-post-search

34 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
12 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
5 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Arguments without a description: sort, filter.param_no_description
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    Says nothing about what it returns.no_return_info

API-delete-a-block

35 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
18 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Its description is nearly the same as API-retrieve-a-block's (similarity 0.75); only the names and schemas tell them apart. Say in this description when to use API-retrieve-a-block instead.confusable_pair
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: block_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-get-block-children

35 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
18 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Its description is nearly the same as API-retrieve-a-block's (similarity 0.88); only the names and schemas tell them apart. Say in this description when to use API-retrieve-a-block instead.confusable_pair
  • Minor
    Its description is nearly the same as API-patch-block-children's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-patch-block-children instead.confusable_pair
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: block_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-get-users

35 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
18 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    The description is too short (6 words).too_short
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Says nothing about what it returns.no_return_info

API-patch-block-children

35 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
18 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Its description is nearly the same as API-get-block-children's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-get-block-children instead.confusable_pair
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: block_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-retrieve-a-block

35 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
18 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Its description is nearly the same as API-get-block-children's (similarity 0.88); only the names and schemas tell them apart. Say in this description when to use API-get-block-children instead.confusable_pair
  • Minor
    Its description is nearly the same as API-update-a-block's (similarity 0.75); only the names and schemas tell them apart. Say in this description when to use API-update-a-block instead.confusable_pair
  • Minor
    Its description is nearly the same as API-delete-a-block's (similarity 0.75); only the names and schemas tell them apart. Say in this description when to use API-delete-a-block instead.confusable_pair
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: block_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-retrieve-a-comment

35 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
18 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    The description is too short (7 words).too_short
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: block_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-retrieve-a-data-source

35 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
18 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Its description is nearly the same as API-query-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-query-data-source instead.confusable_pair
  • Minor
    Its description is nearly the same as API-update-a-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-update-a-data-source instead.confusable_pair
  • Minor
    Its description is nearly the same as API-create-a-data-source's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-create-a-data-source instead.confusable_pair
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: data_source_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-retrieve-a-database

35 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
18 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: database_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-retrieve-a-page-property

35 / 100Rain

Purpose
10 / 20
When to use
0 / 20
Arguments
18 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Its description is nearly the same as API-retrieve-a-page's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-retrieve-a-page instead.confusable_pair
  • Minor
    String arguments with no constraint or example: start_cursor.loose_string_param
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: page_id, property_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-retrieve-a-page

40 / 100Cloudy

Purpose
10 / 20
When to use
0 / 20
Arguments
18 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
5 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Its description is nearly the same as API-retrieve-a-page-property's (similarity 0.78); only the names and schemas tell them apart. Say in this description when to use API-retrieve-a-page-property instead.confusable_pair
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: page_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-get-self

42 / 100Cloudy

Purpose
10 / 20
When to use
0 / 20
Arguments
25 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Says nothing about what it returns.no_return_info

API-retrieve-page-markdown

50 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
23 / 25
Return value
0 / 15
Constraints and side effects
10 / 10
Examples
0 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    Its description is nearly the same as API-update-page-markdown's (similarity 0.79); only the names and schemas tell them apart. Say in this description when to use API-update-page-markdown instead.confusable_pair
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: page_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

API-update-page-markdown

50 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
13 / 25
Return value
0 / 15
Constraints and side effects
10 / 10
Examples
10 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: replace_content, update_content, insert_content, replace_content_range.param_no_description
  • Minor
    Its description is nearly the same as API-retrieve-page-markdown's (similarity 0.79); only the names and schemas tell them apart. Say in this description when to use API-retrieve-page-markdown instead.confusable_pair
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: page_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

What static scoring cannot tell

This score reads only the text of each description and schema: it says what is written, not what a model will do. Short tools whose names already say what they do, such as browser_close, score low here even when models use them well, and in our measurements current models chose the right tool in one step even from one-line descriptions, as long as the names and schemas differed. What the text cannot show, such as what happens over several steps and whether an added sentence helps or misleads, is what an evaluation measures, on the Pro and Team plans.

Is your server listed here and you would rather it were not? Email support@forecall.dev, and we will take it off within 7 days.

All scored servers