Filesystem: tool descriptions scored

tools/list taken: 2026-09-30 (UTC)
From: npm @modelcontextprotocol/server-filesystem@0.2.0
Homepage: github.com
Scoring rules: v2

Scores, issues and names only

This page shows how Filesystem'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/filesystem

Average score: 51.2 / 100Cloudy
Tools: 14
Near-identical descriptions: 1

Across the server

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

1 of 1 pairs shown, highest description similarity first.
Tool	Tool	Description similarity	Name similarity
list_directory	list_directory_with_sizes	0.86	0.50

Tools

create_directory

38 / 100Rain

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 3 / 25
Return value: 8 / 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: path.param_no_description
Minor
String arguments with no constraint or example: path.loose_string_param

list_directory

38 / 100Rain

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 3 / 25
Return value: 8 / 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: path.param_no_description
Minor
Its description is nearly the same as list_directory_with_sizes's (similarity 0.86); only the names and schemas tell them apart. Say in this description when to use list_directory_with_sizes instead.confusable_pair
Minor
String arguments with no constraint or example: path.loose_string_param

write_file

38 / 100Rain

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 3 / 25
Return value: 8 / 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: path, content.param_no_description
Minor
String arguments with no constraint or example: path, content.loose_string_param

move_file

43 / 100Cloudy

Purpose: 20 / 20
When to use: 5 / 20
Arguments: 3 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Arguments without a description: source, destination.param_no_description
Minor
String arguments with no constraint or example: source, destination.loose_string_param

read_media_file

45 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 3 / 25
Return value: 15 / 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: path.param_no_description
Minor
String arguments with no constraint or example: path.loose_string_param

get_file_info

48 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 3 / 25
Return value: 15 / 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
Major
Arguments without a description: path.param_no_description
Minor
String arguments with no constraint or example: path.loose_string_param

list_directory_with_sizes

48 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 13 / 25
Return value: 8 / 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 list_directory's (similarity 0.86); only the names and schemas tell them apart. Say in this description when to use list_directory instead.confusable_pair
Minor
Arguments without a description: path.param_no_description
Minor
String arguments with no constraint or example: path.loose_string_param

edit_file

51 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 12 / 25
Return value: 15 / 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: path, edits.param_no_description
Minor
String arguments with no constraint or example: path.loose_string_param

directory_tree

55 / 100Cloudy

Purpose: 20 / 20
When to use: 5 / 20
Arguments: 3 / 25
Return value: 15 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
Arguments without a description: path, excludePatterns.param_no_description
Minor
String arguments with no constraint or example: path.loose_string_param

read_file

58 / 100Cloudy

Purpose: 17 / 20
When to use: 10 / 20
Arguments: 13 / 25
Return value: 8 / 15
Constraints and side effects: 10 / 10
Examples: 0 / 10

Minor
Arguments without a description: path.param_no_description
Minor
String arguments with no constraint or example: path.loose_string_param
Minor
The description mentions none of its 3 or more arguments.params_not_in_description
Minor
The description says the tool is deprecated. Name the replacement, and consider taking the tool out of tools/list: models avoid it when asked for what it does.deprecated

read_text_file

61 / 100Cloudy

Purpose: 20 / 20
When to use: 5 / 20
Arguments: 13 / 25
Return value: 8 / 15
Constraints and side effects: 10 / 10
Examples: 5 / 10

Minor
Arguments without a description: path.param_no_description
Minor
String arguments with no constraint or example: path.loose_string_param

search_files

62 / 100Cloudy

Purpose: 17 / 20
When to use: 15 / 20
Arguments: 3 / 25
Return value: 15 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
Arguments without a description: path, pattern, excludePatterns.param_no_description
Minor
String arguments with no constraint or example: path, pattern.loose_string_param

read_multiple_files

63 / 100Cloudy

Purpose: 20 / 20
When to use: 5 / 20
Arguments: 23 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

No issues.

list_allowed_directories

69 / 100Cloudy

Purpose: 17 / 20
When to use: 5 / 20
Arguments: 25 / 25
Return value: 15 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

No issues.

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