Forecall
Failure recordsDocs
All scored servers

Hail: tool descriptions scored io.github.hail-hq/hail-mcp

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

Scores, issues and names only

This page shows how Hail (io.github.hail-hq/hail-mcp)'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.github.hail-hq/hail-mcp
Average score
61.5 / 100Cloudy
Tools
38
Near-identical descriptions
0

Across the server

  • Minor
    38 tools. Above 25, models start to tell tools apart less well.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

get_sms

45 / 100Cloudy

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

list_sms

45 / 100Cloudy

Purpose
17 / 20
When to use
0 / 20
Arguments
5 / 25
Return value
8 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: cursor, limit, status, to.param_no_description
  • Minor
    No `required` list, so every argument is optional.no_required

get_agent

50 / 100Cloudy

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

get_number

50 / 100Cloudy

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

route_number

50 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
3 / 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
  • Major
    Arguments without a description: number_id, voice_agent_id, sms_agent_id, clear_voice, clear_sms.param_no_description
  • Minor
    String arguments with no constraint or example: number_id.loose_string_param
  • Minor
    The meaning of the boolean argument clear_voice is unclear.vague_boolean
  • Minor
    The meaning of the boolean argument clear_sms is unclear.vague_boolean

get_email_attachment

53 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
3 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: email_id, attachment_id.param_no_description
  • Minor
    String arguments with no constraint or example: email_id, attachment_id.loose_string_param

get_email_raw

53 / 100Cloudy

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

cancel_verification

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: verification_id.param_no_description
  • Minor
    String arguments with no constraint or example: verification_id.loose_string_param
  • Minor
    Required identifiers whose description does not say where the value comes from: verification_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

create_contact

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: name, phone_e164, email.param_no_description
  • Minor
    String arguments with no constraint or example: name.loose_string_param

get_call

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: call_id.param_no_description
  • Major
    The name is made of generic words only.generic_name
  • Minor
    String arguments with no constraint or example: call_id.loose_string_param
  • Minor
    Required identifiers whose description does not say where the value comes from: call_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

get_email

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: email_id.param_no_description
  • Minor
    String arguments with no constraint or example: email_id.loose_string_param
  • Minor
    Required identifiers whose description does not say where the value comes from: email_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

get_verification

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: verification_id.param_no_description
  • Minor
    String arguments with no constraint or example: verification_id.loose_string_param

list_calls

55 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
5 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: cursor, limit, status, to.param_no_description
  • Minor
    No `required` list, so every argument is optional.no_required

list_contacts

55 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
5 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: q, limit.param_no_description
  • Minor
    No `required` list, so every argument is optional.no_required

list_numbers

55 / 100Cloudy

Purpose
20 / 20
When to use
0 / 20
Arguments
5 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: limit, cursor.param_no_description
  • Minor
    No `required` list, so every argument is optional.no_required

update_agent

55 / 100Cloudy

Purpose
17 / 20
When to use
5 / 20
Arguments
3 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: agent_id, name, system_prompt, first_message, ai_disclosure, recording_enabled, ai_disclosure_line, language, voice_id, tools, max_duration_seconds, handover_max_duration_seconds, voice_enabled, sms_enabled, status, handover_contacts, clear_fields.param_no_description
  • Minor
    String arguments with no constraint or example: agent_id.loose_string_param
  • Minor
    Required identifiers whose description does not say where the value comes from: agent_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

list_emails

60 / 100Cloudy

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

lookup_contact

60 / 100Cloudy

Purpose
20 / 20
When to use
10 / 20
Arguments
3 / 25
Return value
15 / 15
Constraints and side effects
7 / 10
Examples
5 / 10
  • Major
    Arguments without a description: query.param_no_description
  • Minor
    String arguments with no constraint or example: query.loose_string_param

upload_email_attachment

60 / 100Cloudy

Purpose
20 / 20
When to use
10 / 20
Arguments
3 / 25
Return value
15 / 15
Constraints and side effects
7 / 10
Examples
5 / 10
  • Major
    Arguments without a description: content_base64, filename, content_type.param_no_description
  • Minor
    String arguments with no constraint or example: content_base64, filename, content_type.loose_string_param

confirm_verification

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: verification_id, code.param_no_description
  • Minor
    String arguments with no constraint or example: verification_id, code.loose_string_param

get_events

62 / 100Cloudy

Purpose
17 / 20
When to use
10 / 20
Arguments
5 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: id, kind, cursor, limit.param_no_description
  • Minor
    No `required` list, so every argument is optional.no_required

list_verifications

62 / 100Cloudy

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

delete_agent

63 / 100Cloudy

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

acquire_number

65 / 100Cloudy

Purpose
17 / 20
When to use
15 / 20
Arguments
3 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: quote_id, country_code, number_type, confirm_total_cents, idempotency_key, subject_type, verification_id.param_no_description
  • Minor
    String arguments with no constraint or example: quote_id, country_code, number_type.loose_string_param

get_email_events

65 / 100Cloudy

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

list_email_domains

67 / 100Cloudy

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

create_agent

68 / 100Cloudy

Purpose
20 / 20
When to use
15 / 20
Arguments
3 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: name, system_prompt, first_message, ai_disclosure, recording_enabled, ai_disclosure_line, language, voice_id, tools, max_duration_seconds, handover_max_duration_seconds, voice_enabled, sms_enabled, handover_contacts.param_no_description
  • Minor
    String arguments with no constraint or example: name, system_prompt.loose_string_param
  • Minor
    The meaning of the boolean argument ai_disclosure is unclear.vague_boolean
  • Minor
    The meaning of the boolean argument voice_enabled is unclear.vague_boolean
  • Minor
    The meaning of the boolean argument sms_enabled is unclear.vague_boolean

release_number

68 / 100Cloudy

Purpose
20 / 20
When to use
15 / 20
Arguments
3 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: number_id, confirm_e164.param_no_description
  • Minor
    String arguments with no constraint or example: number_id, confirm_e164.loose_string_param

get_email_stats

69 / 100Cloudy

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

get_verification_requirements

69 / 100Cloudy

Purpose
20 / 20
When to use
15 / 20
Arguments
4 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: country_code, number_type, subject_type, quote_id, number_id, purpose.param_no_description
  • Minor
    String arguments with no constraint or example: country_code, number_type, subject_type.loose_string_param

submit_verification

70 / 100Clear

Purpose
20 / 20
When to use
15 / 20
Arguments
5 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: country_code, number_type, fields, documents, files, attest_authorized, subject_type, address, quote_id, number_id, purpose.param_no_description
  • Minor
    String arguments with no constraint or example: country_code, number_type.loose_string_param
  • Minor
    The meaning of the boolean argument attest_authorized is unclear.vague_boolean

list_agents

72 / 100Clear

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

list_number_regions

72 / 100Clear

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

place_call

72 / 100Clear

Purpose
17 / 20
When to use
20 / 20
Arguments
5 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: to, recipient_consent, system_prompt, llm, from_, first_message, language, ai_disclosure, recording_enabled, metadata, tools, idempotency_key, consent_source, consent_obtained_at, message_type, agent_id.param_no_description
  • Minor
    The description is long (468 words). It helps selection but costs steps and tokens.too_long
  • Minor
    String arguments with no constraint or example: to.loose_string_param
  • Minor
    The meaning of the boolean argument recipient_consent is unclear.vague_boolean
  • Minor
    The meaning of the boolean argument ai_disclosure is unclear.vague_boolean

quote_numbers

73 / 100Clear

Purpose
20 / 20
When to use
20 / 20
Arguments
3 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: country_code, capabilities, number_type, area_code, city, region.param_no_description
  • Minor
    String arguments with no constraint or example: country_code.loose_string_param

send_email

75 / 100Clear

Purpose
20 / 20
When to use
20 / 20
Arguments
5 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: to, subject, recipient_consent, body_text, body_html, from_, from_name, cc, bcc, reply_to, metadata, idempotency_key, consent_source, consent_obtained_at, message_type, attachment_ids.param_no_description
  • Minor
    String arguments with no constraint or example: subject.loose_string_param
  • Minor
    The meaning of the boolean argument recipient_consent is unclear.vague_boolean

send_sms

75 / 100Clear

Purpose
20 / 20
When to use
20 / 20
Arguments
5 / 25
Return value
15 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: to, body, recipient_consent, from_, metadata, idempotency_key, consent_source, consent_obtained_at, message_type.param_no_description
  • Minor
    String arguments with no constraint or example: to, body.loose_string_param
  • Minor
    The meaning of the boolean argument recipient_consent is unclear.vague_boolean

whoami

87 / 100Clear

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