Forecall
Failure recordsDocs
All scored servers

Heystack: tool descriptions scored com.heystacks/heystack

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

Scores, issues and names only

This page shows how Heystack (com.heystacks/heystack)'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.heystacks/heystack
Average score
38.2 / 100Rain
Tools
19
Near-identical descriptions
0

Across the server

No server-wide issues.

Tools

list_topics

18 / 100Rain

Purpose
6 / 20
When to use
0 / 20
Arguments
5 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 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
  • Major
    Arguments without a description: limit.param_no_description
  • Minor
    No `required` list, so every argument is optional.no_required
  • Minor
    Says nothing about what it returns.no_return_info

read_moderation

18 / 100Rain

Purpose
6 / 20
When to use
0 / 20
Arguments
5 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    The description only restates the name (8 words).restates_name
  • Major
    Says nothing about when to use it, or when not to.no_usage_context
  • Major
    Arguments without a description: case, page.param_no_description
  • Minor
    No `required` list, so every argument is optional.no_required
  • Minor
    Says nothing about what it returns.no_return_info

search_documents

29 / 100Rain

Purpose
17 / 20
When to use
0 / 20
Arguments
5 / 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
  • Major
    Arguments without a description: q, tag, type, kind, sort, page.param_no_description
  • Minor
    No `required` list, so every argument is optional.no_required
  • Minor
    Says nothing about what it returns.no_return_info

read_activity

32 / 100Rain

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

comment

35 / 100Rain

Purpose
17 / 20
When to use
0 / 20
Arguments
6 / 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
  • Major
    Arguments without a description: documentId, body, parentId, publicKey, kind, timestamp, nonce, signature.param_no_description
  • Minor
    String arguments with no constraint or example: publicKey, nonce, signature.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: documentId. Name the tool or the place that returns it, or models look it up first.id_source_missing

read_profile

35 / 100Rain

Purpose
20 / 20
When to use
0 / 20
Arguments
8 / 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
  • Major
    Arguments without a description: key.param_no_description
  • Minor
    Says nothing about what it returns.no_return_info

delete

37 / 100Rain

Purpose
20 / 20
When to use
0 / 20
Arguments
5 / 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
  • Major
    Arguments without a description: documentId, commentId, publicKey, kind, timestamp, nonce, signature.param_no_description
  • Minor
    String arguments with no constraint or example: publicKey, nonce, signature.loose_string_param
  • Minor
    Says nothing about what it returns.no_return_info

edit_spreadsheet

38 / 100Rain

Purpose
20 / 20
When to use
0 / 20
Arguments
6 / 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
  • Major
    Arguments without a description: documentId, baseRevisionId, name, columns, rows, message, publicKey, kind, timestamp, nonce, signature.param_no_description
  • Minor
    String arguments with no constraint or example: publicKey, nonce, signature.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: documentId, baseRevisionId. Name the tool or the place that returns it, or models look it up first.id_source_missing

mark_read

38 / 100Rain

Purpose
17 / 20
When to use
5 / 20
Arguments
4 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
5 / 10
  • Major
    Arguments without a description: ids, publicKey, kind, timestamp, nonce, signature.param_no_description
  • Minor
    String arguments with no constraint or example: publicKey, nonce, signature.loose_string_param
  • Minor
    Says nothing about what it returns.no_return_info

read_document

38 / 100Rain

Purpose
20 / 20
When to use
5 / 20
Arguments
6 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 10
  • Major
    Arguments without a description: id, revision, readerPublicKey.param_no_description
  • Minor
    String arguments with no constraint or example: id.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: id. Name the tool or the place that returns it, or models look it up first.id_source_missing

read_rules

38 / 100Rain

Purpose
6 / 20
When to use
0 / 20
Arguments
25 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
0 / 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
    Says nothing about what it returns.no_return_info

read_notifications

41 / 100Cloudy

Purpose
20 / 20
When to use
5 / 20
Arguments
4 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
5 / 10
  • Major
    Arguments without a description: unread, limit, publicKey, kind, timestamp, nonce, signature.param_no_description
  • Minor
    String arguments with no constraint or example: publicKey, nonce, signature.loose_string_param
  • Minor
    The meaning of the boolean argument unread is unclear.vague_boolean
  • Minor
    Says nothing about what it returns.no_return_info

create_spreadsheet

42 / 100Cloudy

Purpose
20 / 20
When to use
5 / 20
Arguments
5 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
5 / 10
  • Major
    Arguments without a description: title, name, columns, rows, publicKey, kind, timestamp, nonce, signature.param_no_description
  • Minor
    String arguments with no constraint or example: publicKey, nonce, signature.loose_string_param
  • Minor
    Says nothing about what it returns.no_return_info

submit_contribution

42 / 100Cloudy

Purpose
20 / 20
When to use
5 / 20
Arguments
7 / 25
Return value
0 / 15
Constraints and side effects
10 / 10
Examples
0 / 10
  • Major
    Arguments without a description: envelope, envelope.version, envelope.scope, envelope.publicKey, envelope.kind, envelope.timestamp, envelope.nonce, envelope.action, envelope.payload, envelope.signature.param_no_description
  • Minor
    String arguments with no constraint or example: envelope.scope.loose_string_param
  • Minor
    Says nothing about what it returns.no_return_info

upload_image

46 / 100Cloudy

Purpose
20 / 20
When to use
10 / 20
Arguments
6 / 25
Return value
0 / 15
Constraints and side effects
10 / 10
Examples
0 / 10
  • Major
    Arguments without a description: imageBase64, alt, proof.version, proof.scope, proof.publicKey, proof.kind, proof.timestamp, proof.nonce, proof.sha256, proof.draftId, proof.documentId, proof.signature.param_no_description
  • Minor
    String arguments with no constraint or example: proof.scope, proof.publicKey, proof.nonce, proof.sha256, proof.draftId, proof.documentId, proof.signature.loose_string_param
  • Minor
    Says nothing about what it returns.no_return_info

create_markdown

47 / 100Cloudy

Purpose
20 / 20
When to use
10 / 20
Arguments
5 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
5 / 10
  • Major
    Arguments without a description: title, markdown, publicKey, kind, timestamp, nonce, signature.param_no_description
  • Minor
    String arguments with no constraint or example: publicKey, nonce, signature.loose_string_param
  • Minor
    Says nothing about what it returns.no_return_info

edit_markdown

48 / 100Cloudy

Purpose
20 / 20
When to use
10 / 20
Arguments
6 / 25
Return value
0 / 15
Constraints and side effects
7 / 10
Examples
5 / 10
  • Major
    Arguments without a description: documentId, baseRevisionId, markdown, title, message, publicKey, kind, timestamp, nonce, signature.param_no_description
  • Minor
    String arguments with no constraint or example: publicKey, nonce, signature.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: documentId, baseRevisionId. Name the tool or the place that returns it, or models look it up first.id_source_missing

suggest_edit

48 / 100Cloudy

Purpose
17 / 20
When to use
10 / 20
Arguments
6 / 25
Return value
0 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: documentId, baseRevisionId, markdown, title, message, publicKey, kind, timestamp, nonce, signature.param_no_description
  • Minor
    String arguments with no constraint or example: publicKey, nonce, signature.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: documentId, baseRevisionId. Name the tool or the place that returns it, or models look it up first.id_source_missing

review_suggestion

56 / 100Cloudy

Purpose
20 / 20
When to use
15 / 20
Arguments
6 / 25
Return value
0 / 15
Constraints and side effects
10 / 10
Examples
5 / 10
  • Major
    Arguments without a description: proposalId, decision, expectedRevisionId, message, publicKey, kind, timestamp, nonce, signature.param_no_description
  • Minor
    String arguments with no constraint or example: publicKey, nonce, signature.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: proposalId. 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