ShotPulled: tool descriptions scored com.shotpulled/shotpulled

tools/list taken: 2026-11-02 (UTC)
From: Official MCP Registry
Connected to: https://mcp.shotpulled.com/mcp
Homepage: shotpulled.com
Scoring rules: v2
Removal: support@forecall.dev

Scores, issues and names only

This page shows how ShotPulled (com.shotpulled/shotpulled)'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.

Forecall asked the URL this server lists in the official MCP Registry for its tools/list once, on the date above, without calling any tool. The server may have changed since.

servers/com.shotpulled/shotpulled

Average score: 58.7 / 100Cloudy
Tools: 44
Near-identical descriptions: 5

Across the server

Major
44 tools. Above 40, models choose less accurately.too_many_tools
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

5 of 5 pairs shown, highest description similarity first.
Tool	Tool	Description similarity	Name similarity
list_waters	list_scales	0.89	0.33
list_waters	list_recipes	0.68	0.33
list_scales	list_recipes	0.68	0.33
update_scale	update_water	0.61	0.33
register_grinder	register_machine	0.60	0.33

Tools

grinder_math

28 / 100Rain

Purpose: 10 / 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: grinder_id, from_label, to_label.param_no_description
Minor
String arguments with no constraint or example: from_label, to_label.loose_string_param
Minor
The description mentions none of its 3 or more arguments.params_not_in_description
Minor
Required identifiers whose description does not say where the value comes from: grinder_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

log_recommendation

35 / 100Rain

Purpose: 13 / 20
When to use: 0 / 20
Arguments: 7 / 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: lever, direction, rationale, confidence, cited_rules, based_on_shot.param_no_description
Minor
String arguments with no constraint or example: rationale.loose_string_param
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

suggest_next_step

36 / 100Rain

Purpose: 13 / 20
When to use: 0 / 20
Arguments: 8 / 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: bean_id.param_no_description
Minor
Required identifiers whose description does not say where the value comes from: bean_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

lock_recipe

43 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 8 / 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: from_shot_id, drink_intent.param_no_description
Minor
Required identifiers whose description does not say where the value comes from: from_shot_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

register_water

44 / 100Cloudy

Purpose: 6 / 20
When to use: 0 / 20
Arguments: 18 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 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
String arguments with no constraint or example: notes.loose_string_param
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

update_water

45 / 100Cloudy

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

Major
Arguments without a description: fields, fields.name, fields.type, fields.tds, fields.gh, fields.kh, fields.sodium, fields.calcium, fields.magnesium, fields.notes.param_no_description
Minor
Its description is nearly the same as update_scale's (similarity 0.61); only the names and schemas tell them apart. Say in this description when to use update_scale instead.confusable_pair
Minor
String arguments with no constraint or example: fields.name.loose_string_param
Minor
Required identifiers whose description does not say where the value comes from: water_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

list_recipes

49 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 9 / 25
Return value: 8 / 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
Major
Arguments without a description: bean_id, grinder_id, machine_id.param_no_description
Minor
Its description is nearly the same as list_waters's (similarity 0.68); only the names and schemas tell them apart. Say in this description when to use list_waters instead.confusable_pair
Minor
Its description is nearly the same as list_scales's (similarity 0.68); only the names and schemas tell them apart. Say in this description when to use list_scales instead.confusable_pair
Minor
No `required` list, so every argument is optional.no_required

update_bag

49 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 12 / 25
Return value: 8 / 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: fields, fields.state, fields.cost, fields.currency, fields.storage, fields.frozen_storage, fields.frozen_note, fields.bag_notes, fields.ean, fields.qr_code.param_no_description
Minor
String arguments with no constraint or example: fields.currency, fields.storage, fields.frozen_storage, fields.frozen_note, fields.ean, fields.qr_code.loose_string_param
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

compute_age

51 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 16 / 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
Arguments without a description: bean_id.param_no_description
Minor
Required identifiers whose description does not say where the value comes from: bean_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

get_stats

51 / 100Cloudy

Purpose: 13 / 20
When to use: 0 / 20
Arguments: 23 / 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
Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.id_source_missing

set_equipment_archived

51 / 100Cloudy

Purpose: 13 / 20
When to use: 0 / 20
Arguments: 23 / 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
The description mentions none of its 3 or more arguments.params_not_in_description
Minor
Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.id_source_missing

get_maintenance_guides

52 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 20 / 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
No `required` list, so every argument is optional.no_required

list_shots

52 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 14 / 25
Return value: 8 / 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
Arguments without a description: filters.param_no_description
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

get_kb_version

53 / 100Cloudy

Purpose: 13 / 20
When to use: 0 / 20
Arguments: 25 / 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

get_rule

55 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 18 / 25
Return value: 8 / 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
Required identifiers whose description does not say where the value comes from: rule_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

get_dial_state

57 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 25 / 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

kb_changelog

57 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 25 / 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

set_grinder_position

57 / 100Cloudy

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

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Arguments without a description: grinder_id.param_no_description
Minor
Required identifiers whose description does not say where the value comes from: grinder_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

update_bean

58 / 100Cloudy

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

Major
Arguments without a description: bean_id, fields, fields.name, fields.roast_level, fields.process_type, fields.roaster, fields.origin, fields.variety, fields.bag_notes, fields.rest_window_days_min, fields.rest_window_days_max, fields.state, fields.storage, fields.cost, fields.currency, fields.roast_range, fields.roast_custom, fields.roasting_type, fields.aromatics, fields.cupping_points, fields.url, fields.ean, fields.qr_code, fields.co2e_kg, fields.frozen_storage, fields.frozen_note, fields.arabica_pct, fields.origins[].country, fields.origins[].region, fields.origins[].farm, fields.origins[].farmer, fields.origins[].variety, fields.origins[].processing, fields.origins[].elevation_m, fields.origins[].harvest, fields.origins[].percentage.param_no_description
Minor
String arguments with no constraint or example: fields.name, fields.roaster, fields.origin, fields.variety, fields.storage, fields.currency, fields.roast_range, fields.roast_custom, fields.url, fields.ean, fields.qr_code, fields.frozen_storage, fields.frozen_note, fields.origins[].country, fields.origins[].region, fields.origins[].farm, fields.origins[].farmer, fields.origins[].variety, fields.origins[].processing, fields.origins[].harvest.loose_string_param

list_beans

60 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 8 / 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
No `required` list, so every argument is optional.no_required

list_machines

60 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 8 / 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
No `required` list, so every argument is optional.no_required

list_scales

60 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 8 / 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 list_waters's (similarity 0.89); only the names and schemas tell them apart. Say in this description when to use list_waters instead.confusable_pair
Minor
Its description is nearly the same as list_recipes's (similarity 0.68); only the names and schemas tell them apart. Say in this description when to use list_recipes instead.confusable_pair
Minor
No `required` list, so every argument is optional.no_required

list_waters

60 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 8 / 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 list_scales's (similarity 0.89); only the names and schemas tell them apart. Say in this description when to use list_scales instead.confusable_pair
Minor
Its description is nearly the same as list_recipes's (similarity 0.68); only the names and schemas tell them apart. Say in this description when to use list_recipes instead.confusable_pair
Minor
No `required` list, so every argument is optional.no_required

log_maintenance

60 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 8 / 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
Required identifiers whose description does not say where the value comes from: equipment_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

update_grinder

61 / 100Cloudy

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

Major
Arguments without a description: fields, fields.name, fields.motor_type, fields.burr_type, fields.setting_scheme, fields.direction_convention, fields.min_value, fields.max_value, fields.microns_per_step, fields.notes, fields.photo.param_no_description
Minor
String arguments with no constraint or example: fields.name.loose_string_param
Minor
Required identifiers whose description does not say where the value comes from: grinder_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

update_machine

62 / 100Cloudy

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

Minor
Arguments without a description: fields, fields.name, fields.control_type, fields.basket_size_grams, fields.boiler_type, fields.connected_device, fields.notes, fields.photo.param_no_description
Minor
String arguments with no constraint or example: fields.name.loose_string_param
Minor
Required identifiers whose description does not say where the value comes from: machine_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

update_scale

62 / 100Cloudy

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

Major
Arguments without a description: fields, fields.name, fields.scale_type, fields.resolution_g, fields.capacity_g, fields.width_mm, fields.depth_mm, fields.height_mm, fields.water_resistance, fields.connectivity, fields.flow_rate_display, fields.auto_tare, fields.auto_timer, fields.power, fields.notes.param_no_description
Minor
Its description is nearly the same as update_water's (similarity 0.61); only the names and schemas tell them apart. Say in this description when to use update_water instead.confusable_pair
Minor
String arguments with no constraint or example: fields.name.loose_string_param
Minor
Required identifiers whose description does not say where the value comes from: scale_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

register_program

64 / 100Cloudy

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

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Arguments without a description: machine_id, description.param_no_description
Minor
Required identifiers whose description does not say where the value comes from: machine_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

update_shot

64 / 100Cloudy

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

Major
Arguments without a description: fields.grinder_id, fields.machine_id, fields.program_id, fields.water_id, fields.dose_g, fields.yield_g, fields.time_s, fields.sensory_tags, fields.observations, fields.finish_action, fields.drink_intent, fields.temp_taste, fields.temperature_c, fields.tds, fields.beverage_g, fields.vessel_name, fields.vessel_weight_g, fields.favourite, fields.best_brew.param_no_description
Minor
String arguments with no constraint or example: fields.vessel_name.loose_string_param
Minor
Required identifiers whose description does not say where the value comes from: shot_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

list_grinders

65 / 100Cloudy

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

Minor
No `required` list, so every argument is optional.no_required

register_scale

65 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 21 / 25
Return value: 15 / 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
String arguments with no constraint or example: notes.loose_string_param
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

set_maintenance_offset

65 / 100Cloudy

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

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Required identifiers whose description does not say where the value comes from: entry_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

diagnose_preview

66 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 17 / 25
Return value: 15 / 15
Constraints and side effects: 7 / 10
Examples: 10 / 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

register_bag

66 / 100Cloudy

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

Minor
Arguments without a description: cost, currency, storage, ean, qr_code.param_no_description
Minor
String arguments with no constraint or example: currency, storage, ean, qr_code.loose_string_param

diagnose_shot

67 / 100Cloudy

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

Minor
No `required` list, so every argument is optional.no_required

delete_shot

68 / 100Cloudy

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

Minor
Required identifiers whose description does not say where the value comes from: shot_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

register_machine

70 / 100Clear

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

Minor
Its description is nearly the same as register_grinder's (similarity 0.60); only the names and schemas tell them apart. Say in this description when to use register_grinder instead.confusable_pair
Minor
Arguments without a description: control_type, basket_size_grams, boiler_type, notes.param_no_description
Minor
String arguments with no constraint or example: boiler_type, notes.loose_string_param

set_active

70 / 100Clear

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

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

merge_beans

71 / 100Clear

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

Minor
Required identifiers whose description does not say where the value comes from: from_bean_id, into_bean_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

list_maintenance_due

72 / 100Clear

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

Minor
No `required` list, so every argument is optional.no_required

log_shot

72 / 100Clear

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

Minor
Arguments without a description: dose_g, yield_g, time_s, finish_action, drink_intent, flavor_notes, sensory_tags, observations, temp_taste, rating, verdict.param_no_description
Minor
String arguments with no constraint or example: verdict, vessel_name.loose_string_param

register_grinder

73 / 100Clear

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

Minor
Its description is nearly the same as register_machine's (similarity 0.60); only the names and schemas tell them apart. Say in this description when to use register_machine instead.confusable_pair
Minor
Arguments without a description: motor_type, burr_type, direction_convention.param_no_description
Minor
String arguments with no constraint or example: notes.loose_string_param

set_maintenance_schedule

75 / 100Clear

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

Minor
Arguments without a description: fields.param_no_description
Minor
Required identifiers whose description does not say where the value comes from: equipment_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

register_coffee

82 / 100Clear

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

Major
Arguments without a description: name, roast_level, process_type, roaster, origin, variety, bag_notes, rest_window_days_min, rest_window_days_max, state, storage, cost, currency, roast_range, roast_custom, roasting_type, aromatics, cupping_points, rating, url, ean, qr_code, co2e_kg, frozen_storage, frozen_note, origins[].country, origins[].region, origins[].farm, origins[].farmer, origins[].variety, origins[].processing, origins[].elevation_m, origins[].harvest, origins[].percentage.param_no_description
Minor
String arguments with no constraint or example: name, roaster, origin, variety, storage, currency, roast_range, roast_custom, url, ean, qr_code, frozen_storage, frozen_note, origins[].country, origins[].region, origins[].farm, origins[].farmer, origins[].variety, origins[].processing, origins[].harvest.loose_string_param

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