BeliefState: tool descriptions scored ai.beliefstate/investor-research

tools/list taken: 2026-11-02 (UTC)
From: Official MCP Registry
Connected to: https://beliefstate.ai/v1/research/mcp
Homepage: docs.beliefstate.ai/guides/mcp-server
Repository: github.com/Antcolombo/beliefstate-agent-integrations
Scoring rules: v2
Removal: support@forecall.dev

Scores, issues and names only

This page shows how BeliefState (ai.beliefstate/investor-research)'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/ai.beliefstate/investor-research

Average score: 47.4 / 100Cloudy
Tools: 18
Near-identical descriptions: 1

Across the server

Critical
These tools share the same description: get_tickers, search_companies.identical_description
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

1 of 1 pairs shown, highest description similarity first.
Tool	Tool	Description similarity	Name similarity
get_tickers	search_companies	1.00	0.00

Tools

get_tickers

20 / 100Rain

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

Major
The description is too short (6 words).too_short
Major
Says nothing about when to use it, or when not to.no_usage_context
Major
Arguments without a description: as_of.param_no_description
Minor
Its description is nearly the same as search_companies's (similarity 1.00); only the names and schemas tell them apart. Say in this description when to use search_companies instead.confusable_pair
Minor
No `required` list, so every argument is optional.no_required
Minor
Says nothing about what it returns.no_return_info
Minor
No constraints, side effects, auth or rate limits described, and no annotations.no_constraints

search_companies

38 / 100Rain

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

Major
The description is too short (6 words).too_short
Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Its description is nearly the same as get_tickers's (similarity 1.00); only the names and schemas tell them apart. Say in this description when to use get_tickers instead.confusable_pair
Minor
Says nothing about what it returns.no_return_info
Minor
No constraints, side effects, auth or rate limits described, and no annotations.no_constraints

get_belief_relationships

42 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 10 / 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: belief_id, as_of, from_entity_id, to_entity_id, max_depth, edge_budget.param_no_description
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: belief_id, from_entity_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

search_entities

42 / 100Cloudy

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

get_author_track_record

44 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 9 / 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: ticker, entity_id, belief_id, corpus, person_id, source_id, published_from, published_through, as_of.param_no_description
Minor
String arguments with no constraint or example: corpus.loose_string_param
Minor
Required identifiers whose description does not say where the value comes from: person_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

get_belief_catalysts

44 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 6 / 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
Major
Arguments without a description: ticker, entity_id, belief_id, corpus, person_id, source_id, object_status, published_from, published_through, as_of, limit, cursor.param_no_description
Minor
String arguments with no constraint or example: corpus, object_status.loose_string_param
Minor
No `required` list, so every argument is optional.no_required

get_belief_changes

44 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 6 / 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
Major
Arguments without a description: person_id, source_id, domain, event_kind, revision_only, ticker, entity_id, belief_id, corpus, cursor, checkpoint, resync, as_of, changed_since, limit.param_no_description
Minor
String arguments with no constraint or example: ticker, corpus.loose_string_param
Minor
No `required` list, so every argument is optional.no_required
Minor
The meaning of the boolean argument revision_only is unclear.vague_boolean
Minor
The meaning of the boolean argument resync is unclear.vague_boolean

get_belief_risks

44 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 6 / 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
Major
Arguments without a description: ticker, entity_id, belief_id, corpus, person_id, source_id, object_status, severity, published_from, published_through, as_of, limit, cursor.param_no_description
Minor
String arguments with no constraint or example: corpus, object_status.loose_string_param
Minor
No `required` list, so every argument is optional.no_required

get_context_assessment

45 / 100Cloudy

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

get_beliefs

46 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 11 / 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: ticker, person_id, direction, status, time_horizon, as_of, cursor.param_no_description
Minor
No `required` list, so every argument is optional.no_required

search_beliefs

46 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 14 / 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: ticker, person_id, direction, status, time_horizon, as_of.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

list_research_visuals

47 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 15 / 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: belief_id, as_of.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

refresh_market_data

51 / 100Cloudy

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

evaluate_belief_scenario

52 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 10 / 25
Return value: 15 / 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: belief_id, as_of, scenario, scenario.assumptions, scenario.assumptions[].condition_id, scenario.assumptions[].status.param_no_description
Minor
Required identifiers whose description does not say where the value comes from: belief_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

compare_beliefs

56 / 100Cloudy

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

get_research_visual

56 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 21 / 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: belief_id, as_of.param_no_description
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

get_brief

65 / 100Cloudy

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

Minor
Arguments without a description: ticker, as_of, cursor.param_no_description
Minor
No `required` list, so every argument is optional.no_required

get_belief

71 / 100Clear

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

Minor
Arguments without a description: belief_id, as_of.param_no_description

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