Forecall
Failure recordsDocs
All scored servers

Shopmonkey MCP by usefulapi: tool descriptions scored io.usefulapi/shopmonkey

tools/list taken
(UTC)
From
Official MCP Registry
Connected to
https://shopmonkey.usefulapi.io/mcp
Homepage
usefulapi.io/shopmonkey/
Repository
github.com/m190/usefulapi-mcp
Scoring rules
v2
Removal
support@forecall.dev
Score this URL as it is today

Scores, issues and names only

This page shows how Shopmonkey MCP by usefulapi (io.usefulapi/shopmonkey)'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/io.usefulapi/shopmonkey
Average score
52.7 / 100Cloudy
Tools
43
Near-identical descriptions
3

Across the server

  • Major
    43 tools. Above 40, models choose less accurately.too_many_tools

Tools whose descriptions are nearly the same

3 of 3 pairs shown, highest description similarity first.
ToolToolDescription similarityName similarity
shopmonkey_delete_laborshopmonkey_delete_part0.860.50
shopmonkey_delete_serviceshopmonkey_delete_part0.620.50
shopmonkey_find_customers_by_phoneshopmonkey_find_customers_by_email0.500.67

Tools

shopmonkey_create_order

42 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
15 / 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
    String arguments with no constraint or example: name, purchaseOrderNumber.loose_string_param
  • 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
    Says nothing about what it returns.no_return_info

shopmonkey_find_customers_by_email

42 / 100Cloudy

Purpose
17 / 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 shopmonkey_find_customers_by_phone's (similarity 0.50); only the names and schemas tell them apart. Say in this description when to use shopmonkey_find_customers_by_phone instead.confusable_pair
  • Minor
    Says nothing about what it returns.no_return_info

shopmonkey_find_customers_by_phone

42 / 100Cloudy

Purpose
17 / 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 shopmonkey_find_customers_by_email's (similarity 0.50); only the names and schemas tell them apart. Say in this description when to use shopmonkey_find_customers_by_email instead.confusable_pair
  • Minor
    Says nothing about what it returns.no_return_info

shopmonkey_add_customer_email

45 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
21 / 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: customerId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_update_order

46 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
19 / 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
    String arguments with no constraint or example: name, purchaseOrderNumber.loose_string_param
  • Minor
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: orderId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_get_customer

47 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
23 / 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: customerId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_get_vehicle

47 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
23 / 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: vehicleId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_list_customer_orders

47 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
23 / 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
    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: customerId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_list_customer_vehicles

47 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
23 / 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
    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: customerId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_list_workflow_statuses

47 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
20 / 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
    No `required` list, so every argument is optional.no_required
  • Minor
    Says nothing about what it returns.no_return_info

shopmonkey_search_appointments

47 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
16 / 25
Return value
7 / 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
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description

shopmonkey_create_customer

48 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
19 / 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
    String arguments with no constraint or example: firstName, lastName, address1, address2, city, state, postalCode, website.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 taxExempt is unclear.vague_boolean
  • Minor
    Says nothing about what it returns.no_return_info

shopmonkey_create_vehicle

48 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
19 / 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
    String arguments with no constraint or example: engine, vin, licensePlate, unit.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

shopmonkey_update_customer

48 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
19 / 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
    String arguments with no constraint or example: firstName, lastName, address1, address2, city, state, postalCode, website.loose_string_param
  • Minor
    The meaning of the boolean argument taxExempt 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: customerId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_list_users

49 / 100Cloudy

Purpose
17 / 20
When to use
5 / 20
Arguments
20 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Minor
    No `required` list, so every argument is optional.no_required
  • Minor
    Says nothing about what it returns.no_return_info

shopmonkey_update_appointment

49 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
20 / 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
    The meaning of the boolean argument allDay 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: appointmentId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_delete_labor

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 shopmonkey_delete_part's (similarity 0.86); only the names and schemas tell them apart. Say in this description when to use shopmonkey_delete_part 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: orderId, serviceId, laborId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_delete_part

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 shopmonkey_delete_labor's (similarity 0.86); only the names and schemas tell them apart. Say in this description when to use shopmonkey_delete_labor instead.confusable_pair
  • Minor
    Its description is nearly the same as shopmonkey_delete_service's (similarity 0.62); only the names and schemas tell them apart. Say in this description when to use shopmonkey_delete_service 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: orderId, serviceId, partId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_get_order

50 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
23 / 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: orderId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_get_purchase_order

50 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
23 / 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: purchaseOrderId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_get_time_entry

50 / 100Cloudy

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

shopmonkey_create_appointment

51 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
19 / 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
    String arguments with no constraint or example: startDate, endDate.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 allDay is unclear.vague_boolean
  • Minor
    Says nothing about what it returns.no_return_info

shopmonkey_add_labor

52 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
20 / 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
    Says nothing about what it returns.no_return_info

shopmonkey_list_canned_services

52 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
20 / 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
    No `required` list, so every argument is optional.no_required
  • Minor
    Says nothing about what it returns.no_return_info

shopmonkey_list_purchase_orders

52 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
20 / 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
    No `required` list, so every argument is optional.no_required
  • Minor
    Says nothing about what it returns.no_return_info

shopmonkey_list_time_entries

52 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
15 / 25
Return value
7 / 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: technicianIds, inProgress.param_no_description
  • Minor
    No `required` list, so every argument is optional.no_required
  • Minor
    The meaning of the boolean argument inProgress is unclear.vague_boolean

shopmonkey_list_order_services

53 / 100Cloudy

Purpose
20 / 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
    Says nothing about what it returns.no_return_info
  • Minor
    Required identifiers whose description does not say where the value comes from: orderId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_add_part

54 / 100Cloudy

Purpose
20 / 20
When to use
5 / 20
Arguments
15 / 25
Return value
7 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Minor
    Arguments without a description: partNumber, sku, note, binLocation, taxableGST, taxableHST, taxablePST.param_no_description
  • Minor
    String arguments with no constraint or example: partNumber, sku, note, binLocation.loose_string_param
  • Minor
    The meaning of the boolean argument taxable is unclear.vague_boolean
  • Minor
    The meaning of the boolean argument taxableGST is unclear.vague_boolean
  • Minor
    The meaning of the boolean argument taxableHST is unclear.vague_boolean
  • Minor
    The meaning of the boolean argument taxablePST is unclear.vague_boolean

shopmonkey_delete_service

55 / 100Cloudy

Purpose
17 / 20
When to use
5 / 20
Arguments
23 / 25
Return value
0 / 15
Constraints and side effects
10 / 10
Examples
0 / 10
  • Minor
    Its description is nearly the same as shopmonkey_delete_part's (similarity 0.62); only the names and schemas tell them apart. Say in this description when to use shopmonkey_delete_part 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: orderId, serviceId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_get_current_user

55 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
25 / 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
    Says nothing about what it returns.no_return_info

shopmonkey_search_customers

56 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
20 / 25
Return value
7 / 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
  • Minor
    The description mentions none of its 3 or more arguments.params_not_in_description

shopmonkey_add_service

57 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
20 / 25
Return value
0 / 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
    Says nothing about what it returns.no_return_info

shopmonkey_apply_canned_service

57 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
23 / 25
Return value
7 / 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

shopmonkey_list_orders

57 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
20 / 25
Return value
0 / 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
  • Minor
    Says nothing about what it returns.no_return_info

shopmonkey_delete_appointment

60 / 100Cloudy

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

shopmonkey_search_inventory_parts

60 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
20 / 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
  • 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
    Says nothing about what it returns.no_return_info

shopmonkey_search_orders

60 / 100Cloudy

Purpose
20 / 20
When to use
5 / 20
Arguments
18 / 25
Return value
7 / 15
Constraints and side effects
10 / 10
Examples
0 / 10
  • Minor
    Arguments without a description: status.param_no_description
  • Minor
    No `required` list, so every argument is optional.no_required

shopmonkey_clock_in

63 / 100Cloudy

Purpose
20 / 20
When to use
10 / 20
Arguments
19 / 25
Return value
7 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Minor
    Arguments without a description: note.param_no_description
  • Minor
    String arguments with no constraint or example: note.loose_string_param
  • Minor
    Required identifiers whose description does not say where the value comes from: orderId, technicianId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_clock_out

63 / 100Cloudy

Purpose
20 / 20
When to use
10 / 20
Arguments
19 / 25
Return value
7 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Minor
    Arguments without a description: note.param_no_description
  • Minor
    String arguments with no constraint or example: note.loose_string_param
  • Minor
    Required identifiers whose description does not say where the value comes from: orderId, technicianId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_send_message

65 / 100Cloudy

Purpose
20 / 20
When to use
10 / 20
Arguments
18 / 25
Return value
7 / 15
Constraints and side effects
10 / 10
Examples
0 / 10
  • Minor
    Arguments without a description: channel, emailSubject.param_no_description
  • Minor
    String arguments with no constraint or example: emailSubject.loose_string_param
  • Minor
    Required identifiers whose description does not say where the value comes from: customerId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_add_fee

67 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
23 / 25
Return value
7 / 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: orderId, serviceId. Name the tool or the place that returns it, or models look it up first.id_source_missing

shopmonkey_find_order_by_number

67 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
23 / 25
Return value
7 / 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

shopmonkey_send_estimate

69 / 100Cloudy

Purpose
20 / 20
When to use
5 / 20
Arguments
22 / 25
Return value
7 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Minor
    Required identifiers whose description does not say where the value comes from: orderId. 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