horus-flow-mcp

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It discloses the output structure and basic interpretation but lacks details on authentication requirements, data freshness, or any side effects. The description is somewhat transparent but not exhaustive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with about 4 sentences. It leads with the main purpose, then explains output, composition, and interpretation. It is well-structured and efficient, though slightly more bullet-point structuring could improve readability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has an output schema (indicated but not shown), and the description adequately explains the return values (score and verdict). Given the single parameter and absence of annotations, the description covers the essential context for an agent to invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is one parameter (symbol) with 0% schema description coverage, meaning the schema only provides a title and default. The description adds semantic meaning by stating 'Trading pair (default: BTCUSDT)', which is clear and helpful beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool gets a composite intelligence score with a tactical verdict (BUY, SHORT, STAY_OUT). It specifies the score range (0-100) and combines multiple factors like orderflow, sentiment, leverage ratios, and smart money positioning, distinguishing it from sibling tools that focus on specific flows or heatmaps.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides interpretation guidance (score <45 dangerous, >65 opportunity) but does not explicitly state when to use this tool versus alternatives like get_market_intelligence or get_crypto_flow. No explicit when-to-use or when-not-to-use conditions are given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so the description must fully convey behavior. It describes the returned indicators and gives a threshold, but does not mention rate limits, authentication, or potential side effects. As a read operation, it is adequately transparent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise, well-structured, and front-loaded with key information. It uses a clear header, explanation, and args section without any unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has a single optional parameter and an output schema, the description is complete. It explains the indicators, a threshold, and the parameter, making it fully self-contained for an agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0% description coverage, so the description must compensate. It explicitly states the symbol argument is a trading pair with a default of BTCUSDT, adding meaning beyond the schema's default value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool gets Futures/Spot ratio, speculation index, and smart money divergence. It explains what these indicators reveal, making the purpose unmistakable. The name matches the description, and it is distinct from sibling tools like get_crypto_flow.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains what the tool reveals (speculation vs real demand) and provides a hyper-speculation threshold. It does not explicitly state when to use versus siblings or alternatives, but the context is clear for cross-exchange flow analysis.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It discloses the output types (signal, confidence, depth metrics, flags) and notes it is real-time. It does not mention rate limits or permissions, but for a read-only data tool, this is adequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is four sentences, starting with the core purpose and then listing return fields and the argument. It is front-loaded and every sentence adds value. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (1 required parameter) and the existence of an output schema, the description provides a thorough overview of return values and the argument. It covers all necessary context for an agent to select and invoke correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has only 'symbol' with type string and 0% description coverage. The description adds concrete examples ('BTCUSDT', 'ETHUSDT', 'SOLUSDT') and clarifies the trading pair format, which is essential for correct invocation. This fully compensates for the schema's lack of detail.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it 'Get real-time institutional orderflow for a cryptocurrency,' which is a specific verb+resource combination. It distinguishes itself from sibling tools like 'scan_crypto_flow' by focusing on a single symbol and providing detailed output metrics.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implicitly tells when to use: when needing real-time orderflow for a specific cryptocurrency. However, it does not explicitly state when not to use it or compare with alternative siblings like 'scan_crypto_flow' for scanning multiple symbols.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses the returned data fields but does not mention latency, data freshness, rate limits, or whether the operation is read-only. The non-destructive nature is implied.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with no wasted words. It uses a clear structure: a one-line purpose, a list of return fields, and an Args section for the parameter. Information is front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has a single parameter and an output schema (not shown to us). The description covers all returned fields and the parameter's usage. For a simple data retrieval tool, it is fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, but the only parameter 'symbol' is well-described with examples (e.g., 'SPY', 'AAPL'), adding meaning beyond the schema's title and type. This compensates for the lack of schema descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it retrieves real-time institutional orderflow for US equities, listing specific return fields like signals and flags. This distinguishes it from siblings such as get_crypto_flow (crypto) and get_cross_exchange_flow (cross-exchange).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for US equities but does not explicitly state when to use this tool versus alternatives like get_crypto_flow or get_cross_exchange_flow. No exclusions or alternative conditions are provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It discloses outputs (state and bias) and interprets them. It does not mention side effects, which is acceptable for a read-like tool. Lacks explicit read-only hint but is sufficiently transparent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, each adding value: purpose, outputs, interpretation. No unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no parameters and presence of output schema, description explains key return fields meaning. Could add more detail on directional bias format, but complete enough for usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters exist and schema coverage is 100%, so description need not add param details. Baseline of 4 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool detects volatility ignition events and returns ignition state and directional bias. It distinguishes itself from sibling tools (flow and intelligence tools) by focusing on explosive price moves.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides usage context by explaining what IGNITED and RISING states imply (reduce positions, prepare for breakout), but does not explicitly state when not to use or mention alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must bear all behavioral disclosure. It explains the tool returns clusters with dollar amounts but doesn't mention read-only behavior or any potential side effects. While it adds value, it could be more transparent about its idempotency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two paragraphs with an args list; the first sentence is clear and direct. However, the second paragraph partly restates the first, and the overall length could be trimmed without losing meaning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has only one parameter and an output schema exists, the description adequately explains the tool's purpose and return structure. It adds context about critical use cases, making it largely complete for an agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0% description coverage for the 'symbol' parameter, but the description explicitly states 'symbol: Trading pair (default: ETHUSDT)', which adds meaning beyond the schema's type and default. This compensates for the schema gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves liquidation zones with dollar amounts, specifying that it returns clusters of long and short liquidations at specific price levels. This differentiates it from sibling tools that focus on flows or intelligence, though not explicitly naming alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies use for avoiding entries near large liquidation zones to prevent cascading moves, but lacks explicit when-not-to-use or alternative suggestions. It provides a clear use case without situational exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must fully disclose behavioral traits. It states the tool returns macro climate and block trades, implying a read operation. However, it lacks details on data recency, update frequency, or any limitations, which would be helpful for an agent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three sentences with no wasted words. It front-loads the purpose, details the output, and provides a use case, making it highly efficient for an agent to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has no parameters and an output schema exists, the description adequately covers the output structure and threshold. It could mention whether data is historical or real-time, but overall it is complete for agent invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has zero parameters, so the baseline is 4. The description does not need to explain parameters, and it does not add any parameter info, which is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves US equity market macro trend and institutional block trades. It specifies the output includes SPY macro climate (market mode, buy ratio) and block trades with details. This sets it apart from sibling tools like get_equity_flow and get_market_climate.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description suggests using the tool 'to understand where institutional money is flowing', providing a use case. However, it does not explicitly mention when not to use it or compare it with alternative tools among the siblings, leaving some ambiguity for an AI agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description fully discloses return values and implications. Explains what each market mode means for trading strategy and advises position sizing adjustment for FRAGILE health.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

Four concise sentences front-loaded with purpose. Every sentence adds value. No redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Fully explains the tool's output and its interpretation. With no parameters and an output schema, the description is complete and self-contained.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters exist, so baseline 4. Description adds value by explaining the meaning of the returned data beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states it returns market mode (CHOP, TREND, RANGE) and health (HEALTHY, FRAGILE). Distinguishes from siblings like get_market_intelligence by focusing on climate status.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly describes when to use (get current mode/health) and gives actionable advice for FRAGILE health. Doesn't explicitly mention when not to use or alternatives, but context is sufficient.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits itself. It explains what data is returned but does not mention any limitations, auth needs, rate limits, or data freshness. This is insufficient for a tool combining multiple endpoints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is mostly concise with two clear introductory sentences and a parameter doc. The Args section could be integrated more smoothly, but overall it's well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (combining multiple analyses) and the presence of an output schema, the description adequately explains the return contents and parameter. It lacks mention of any usage restrictions or error handling, but otherwise is fairly complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds meaning to the symbol parameter beyond the schema: 'Trading pair (default: BTCUSDT)'. Since schema coverage is 0%, this extra context is valuable, though it could specify format or constraints.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it returns a combination of multiple endpoints (orderflow signal, composite score, etc.), distinguishing it from sibling tools that likely return individual metrics. The verb 'Get' with 'complete market intelligence' is specific.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description advises using this for a comprehensive pre-trade check, giving a clear context. However, it does not explicitly state when not to use it (e.g., if only one component is needed) or mention alternative sibling tools for specific data.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It mentions that the tool returns a summary and individual results sorted by confidence, indicating a read-like operation. However, it does not disclose potential behavioral traits such as authentication requirements, rate limits, error handling, or what happens if symbols are invalid. Basic transparency is present but incomplete.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and well-structured: it starts with the main purpose, then describes the return, gives a usage context, and explains the argument. Every sentence serves a purpose with no unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given that an output schema exists, the description does not need to explain return values. It adequately covers purpose, parameter, and usage context. The only gap is the minor inconsistency in the parameter default example, which slightly undermines completeness. Overall, it is mostly sufficient for a simple tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has no descriptions (0% coverage). The description adds value by explaining the 'symbols' parameter as 'Comma-separated trading pairs' and provides a default list. This goes beyond the schema's mere type and default. However, there is a slight inconsistency: the schema default includes full trading pairs like 'BTCUSDT', while the description lists simple names like 'BTC'. This could cause confusion.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool scans multiple cryptocurrencies for orderflow signals, returns a summary with strongest buy/sell signals, and individual results sorted by confidence. It distinguishes from siblings like get_crypto_flow (likely for single asset) by explicitly mentioning 'multiple' and 'portfolio-wide risk assessment.'

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides a clear use case: 'Use this for portfolio-wide risk assessment.' It implies the tool is for scanning multiple assets but does not explicitly state when not to use it or compare to alternatives. The context is clear but lacks exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.