Forecall
Failure recordsDocs
All scored servers

PubMed: tool descriptions scored

tools/list taken
(UTC)
From
smithery.ai/servers/pubmed
Scoring rules
v2

Scores, issues and names only

This page shows how PubMed'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.

This copy comes from Smithery's registry, which keeps each tool's name, description and input schema, but no output schema, annotations or instructions. Points for return values and for marking destructive tools can come out lower than the server's own tools/list would give.

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

servers/pubmed
Average score
51.7 / 100Cloudy
Tools
7
Near-identical descriptions
1

Across the server

  • Major
    7 tools repeat the same note (123 words). Say it once in the server's instructions, and let each description say what only that tool does. The note does not count toward the tools' scores.repeated_note

Tools whose descriptions are nearly the same

1 of 1 pairs shown, highest description similarity first.
ToolToolDescription similarityName similarity
get_article_metadataget_full_text_article0.810.40

Tools

find_related_articles

39 / 100Rain

Purpose
6 / 20
When to use
0 / 20
Arguments
20 / 25
Return value
8 / 15
Constraints and side effects
0 / 10
Examples
5 / 10
  • Major
    The description only restates the name (7 words).restates_name
  • 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
    No `required` list, so every argument is optional.no_required
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    No constraints, side effects, auth or rate limits described, and no annotations.no_constraints

get_copyright_status

39 / 100Rain

Purpose
6 / 20
When to use
0 / 20
Arguments
20 / 25
Return value
8 / 15
Constraints and side effects
0 / 10
Examples
5 / 10
  • Major
    The description only restates the name (7 words).restates_name
  • 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
    No `required` list, so every argument is optional.no_required
  • Minor
    No constraints, side effects, auth or rate limits described, and no annotations.no_constraints

lookup_article_by_citation

41 / 100Cloudy

Purpose
13 / 20
When to use
0 / 20
Arguments
15 / 25
Return value
8 / 15
Constraints and side effects
0 / 10
Examples
5 / 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
    No `required` list, so every argument is optional.no_required
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description
  • Minor
    No constraints, side effects, auth or rate limits described, and no annotations.no_constraints

convert_article_ids

46 / 100Cloudy

Purpose
13 / 20
When to use
0 / 20
Arguments
20 / 25
Return value
8 / 15
Constraints and side effects
0 / 10
Examples
5 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    No `required` list, so every argument is optional.no_required
  • Minor
    No constraints, side effects, auth or rate limits described, and no annotations.no_constraints

search_articles

47 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
17 / 25
Return value
8 / 15
Constraints and side effects
0 / 10
Examples
5 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Minor
    No `required` list, so every argument is optional.no_required
  • Minor
    No constraints, side effects, auth or rate limits described, and no annotations.no_constraints

get_article_metadata

75 / 100Clear

Purpose
20 / 20
When to use
15 / 20
Arguments
20 / 25
Return value
15 / 15
Constraints and side effects
0 / 10
Examples
5 / 10
  • Minor
    Its description is nearly the same as get_full_text_article's (similarity 0.81); only the names and schemas tell them apart. Say in this description when to use get_full_text_article instead.confusable_pair
  • Minor
    No `required` list, so every argument is optional.no_required
  • Minor
    No constraints, side effects, auth or rate limits described, and no annotations.no_constraints

get_full_text_article

75 / 100Clear

Purpose
20 / 20
When to use
15 / 20
Arguments
20 / 25
Return value
15 / 15
Constraints and side effects
0 / 10
Examples
5 / 10
  • Minor
    Its description is nearly the same as get_article_metadata's (similarity 0.81); only the names and schemas tell them apart. Say in this description when to use get_article_metadata instead.confusable_pair
  • Minor
    No `required` list, so every argument is optional.no_required
  • Minor
    No constraints, side effects, auth or rate limits described, and no annotations.no_constraints

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