SmartHR MCP by usefulapi: tool descriptions scored io.usefulapi/smarthr

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

Scores, issues and names only

This page shows how SmartHR MCP by usefulapi (io.usefulapi/smarthr)'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/smarthr

Average score: 50.4 / 100Cloudy
Tools: 23
Near-identical descriptions: 0

Across the server

No server-wide issues.

Tools

smarthr_list_grades

33 / 100Rain

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

Major
The description only restates the name (5 words).restates_name
Major
The description is too short (5 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
Says nothing about what it returns.no_return_info

smarthr_list_job_categories

33 / 100Rain

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

Major
The description only restates the name (3 words).restates_name
Major
The description is too short (3 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
Says nothing about what it returns.no_return_info

smarthr_list_positions

38 / 100Rain

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

smarthr_list_employee_input_forms

40 / 100Cloudy

Purpose: 13 / 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

smarthr_get_department

43 / 100Cloudy

Purpose: 13 / 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: id. Name the tool or the place that returns it, or models look it up first.id_source_missing

smarthr_list_business_establishments

44 / 100Cloudy

Purpose: 17 / 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
The description mentions none of its 3 or more arguments.params_not_in_description
Minor
Says nothing about what it returns.no_return_info

smarthr_list_companies

44 / 100Cloudy

Purpose: 17 / 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

smarthr_list_dependent_relations

44 / 100Cloudy

Purpose: 17 / 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

smarthr_list_departments

45 / 100Cloudy

Purpose: 13 / 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

smarthr_list_dependents

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: employee_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

smarthr_list_employee_custom_fields

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
The description mentions none of its 3 or more arguments.params_not_in_description
Minor
Says nothing about what it returns.no_return_info

smarthr_list_employment_types

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
No `required` list, so every argument is optional.no_required
Minor
Says nothing about what it returns.no_return_info

smarthr_create_department

54 / 100Cloudy

Purpose: 17 / 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
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

smarthr_update_department

54 / 100Cloudy

Purpose: 17 / 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
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

smarthr_list_webhooks

55 / 100Cloudy

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

smarthr_list_maternity_childcare_leaves

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
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: employee_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

smarthr_list_users

57 / 100Cloudy

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

smarthr_create_dependent

59 / 100Cloudy

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

smarthr_invite_employee

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
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: id, inviter_user_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

smarthr_create_employee

61 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 22 / 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
String arguments with no constraint or example: entered_at, resigned_at.loose_string_param
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

smarthr_update_employee

61 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 22 / 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
String arguments with no constraint or example: entered_at, resigned_at.loose_string_param
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

smarthr_get_employee

67 / 100Cloudy

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

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

smarthr_list_employees

67 / 100Cloudy

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

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

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