Security Recipes
Server Details
Read-only CVE intelligence, remediation playbooks, and agent setup guides. Not a scanner.
- Status
- Healthy
- Uptime
- 99.9% over 36 days
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- stevologic/security-recipes.ai
- GitHub Stars
- 2
- Server Listing
- Security Recipes
TDQS
Scored across 75 tools
The set contains many similarly named agentic security packs that return overlapping profiles, evidence, controls, and decisions, making boundaries hard to distinguish. Some tools are clearly distinct (CVE lookup, MCP upstream access, recipe list/get/search), but the large cluster of 'agentic_*_pack' tools creates significant misselection risk.
All tools use the recipes_ prefix and snake_case, which is highly consistent. However, the naming mixes descriptive noun phrases with verbs such as get, list, search, match, and refresh, so it is not a single predictable verb_noun pattern.
With 75 tools, the surface is far beyond a well-scoped set and well into extreme mismatch territory. Even if each tool maps to a distinct security artifact, the sheer volume makes discovery and selection costly for an agent.
The server covers a broad content domain: recipes can be listed, searched, fetched, matched, refreshed, and quality-reported; CVEs, playbooks, MCP servers, and upstream MCP interactions also have dedicated tools. Minor gaps may exist around write/update lifecycle operations, but for a read-oriented security recipes server the retrieval surface is largely complete.
Available Tools
75 toolsrecipes_a2a_agent_card_trust_profileRecipes A2A Agent Card Trust ProfileCInspect
Return A2A Agent Card intake profiles, trust controls, and sample decisions.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| risk_tier | No | ||
| profile_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. 'Return' implies a read operation, but there is no disclosure of authentication needs, rate limits, side effects, or data sensitivity. It adds minimal behavioral context beyond implying retrieval.
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 a single, front-loaded sentence with no wasted words. It is appropriately concise, though its brevity leaves important semantic gaps that are captured under other dimensions.
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?
An output schema exists, so return values need not be explained. However, with no annotations, three undocumented parameters, and no usage guidance, the description is substantially incomplete for helping an agent select and 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?
Schema description coverage is 0%, and the description does not mention any of the three parameters (decision, risk_tier, profile_id) or their expected values. The parameter names alone provide some hint, but the description adds no meaning beyond the bare 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 uses a clear verb ('Return') and names the resources: A2A Agent Card intake profiles, trust controls, and sample decisions. It distinguishes the tool from generic siblings by mentioning A2A Agent Card trust content, but it does not explicitly differentiate it from similar trust/agentic pack siblings.
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 no guidance on when to use this tool versus alternatives, no prerequisites, and no exclusions. Usage must be inferred entirely from the name and resource list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agent_capability_risk_registerRecipes Agent Capability Risk RegisterCInspect
Return capability-based residual risk scores for agentic workflows.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| risk_tier | No | ||
| workflow_id | No | ||
| minimum_residual_score | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full behavioral burden, but it only states the return purpose. It does not disclose whether the operation is read-only, whether authentication is required, how filters behave, or what the scores represent operationally.
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 single sentence is front-loaded and contains no filler, but it is under-specified rather than concise. For a tool with four undocumented parameters and no annotations, the extreme brevity leaves important invocation details unaddressed.
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?
Although an output schema exists, the description does not compensate for absent annotations, 0% parameter documentation, or the dense sibling landscape. It gives only a high-level purpose, so an agent would struggle to know how to filter, when to call it, or what the scores mean.
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 description coverage is 0% for four parameters, and the description does not mention or explain any of them. An agent receives no meaning for decision, risk_tier, workflow_id, or minimum_residual_score beyond their names in 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 states a specific verb ('Return') and resource ('capability-based residual risk scores for agentic workflows'), so the basic purpose is clear. However, it does not distinguish this tool from sibling risk-scoring tools such as recipes_agentic_aivss_risk_scoring_pack or recipes_mcp_risk_coverage_pack, leaving ambiguity about which risk register is appropriate.
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?
There is no explicit guidance on when to use this tool versus its many risk-related siblings. The phrase 'for agentic workflows' implies a context but gives no conditions, prerequisites, or alternatives to help an agent choose correctly.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agent_handoff_boundary_packRecipes Agent Handoff Boundary PackCInspect
Return agent handoff boundary profiles, protocol controls, and workflow maps.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| protocol | No | ||
| profile_id | No | ||
| workflow_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. 'Return' weakly implies a read, but nothing is said about authorization needs, scoping, pagination, or whether the optional filters narrow or widen the result. For a zero-annotation tool this leaves the agent guessing about how the call behaves.
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?
A single front-loaded sentence with no filler or repetition. It is tight, but at this level of under-specification the brevity reflects a lack of content rather than disciplined editing.
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?
An output schema exists, so return values need not be explained. Still, with no annotations, no usage context, and four undocumented optional parameters, the description is not sufficient for an agent to invoke this tool correctly rather than a neighboring pack.
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 description coverage is 0% across four parameters (decision, protocol, profile_id, workflow_id). The description only incidentally echoes 'protocol' and 'workflow' in its output noun list, giving no meaning, format, or expected values for any parameter — decision and profile_id are entirely unaddressed.
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?
States a verb ('Return') and a set of resources (handoff boundary profiles, protocol controls, workflow maps), so the general shape of the output is inferable. However, the terminology is opaque jargon and there is no differentiation from near-identical siblings such as recipes_agent_memory_boundary_pack, recipes_context_egress_boundary_pack, or recipes_agentic_protocol_conformance_pack, so an agent cannot confidently choose this tool over them.
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 offers no when-to-use guidance, no prerequisites, and no alternatives. With roughly sixty sibling 'pack' tools sharing this naming pattern, the absence of any routing signal is a real selection hazard rather than a minor omission.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_action_runtime_packRecipes Agentic Action Runtime PackCInspect
Return action classes, workflow action envelopes, runtime policy, and evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| risk_tier | No | ||
| workflow_id | No | ||
| action_class_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. 'Return' weakly implies a read, but the description says nothing about side effects, permissions, rate limits, or whether the optional filters constrain the result set. Since an output schema exists, return-value shape is partly covered, but behavior beyond that is undocumented.
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?
A single front-loaded sentence with no filler or repetition. It is efficient, though arguably too terse relative to the tool's complexity and four unexplained parameters.
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?
An output schema exists, so return values need not be described, but for a tool with four optional filtering parameters at 0% schema coverage and no annotations, the description should at minimum explain what the pack is and how the filters scope it. As written, an agent cannot confidently invoke it.
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?
All four parameters (decision, risk_tier, workflow_id, action_class_id) have 0% schema description coverage, and the description mentions none of them. There is no indication of what these filters mean, their expected string formats, or how combining them affects the returned pack, so the parameter layer is entirely opaque.
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 names a concrete verb ('Return') and lists specific resources (action classes, workflow action envelopes, runtime policy, evidence), which is more informative than a tautology. However, it never says what the tool actually does operationally — assemble a report, fetch configuration, or generate a bundle — and dozens of sibling 'recipes_*_pack' tools use near-identical framing, so it does little to distinguish itself.
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?
There is no when-to-use guidance, no description of which scenarios call for this pack versus siblings like recipes_agentic_assurance_pack or recipes_agentic_control_plane_blueprint, and no prerequisites. The agent is left to infer applicability purely from the resource nouns in the sentence.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_aivss_risk_scoring_packRecipes Agentic Aivss Risk Scoring PackCInspect
Return AIVSS-aligned agentic risk scores, SLAs, evidence, and hosted MCP wedges.
| Name | Required | Description | Default |
|---|---|---|---|
| owner | No | ||
| severity | No | ||
| scenario_id | No | ||
| minimum_score | No | ||
| runtime_default_decision | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. 'Return' implies a read-style operation, but there is no information about side effects, permissions, rate limits, authentication needs, or whether the result is cached or live. The description adds no behavioral context beyond the basic output categories.
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 a single front-loaded sentence with no filler. It is appropriately sized for a concise tool summary, though the phrase 'hosted MCP wedges' is opaque and undercuts clarity.
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 five undocumented parameters, no annotations, and a dense sibling ecosystem, the description is far too sparse to guide correct invocation. The presence of an output schema means return values need not be explained, but parameter filtering behavior, selection criteria, and behavioral constraints are missing.
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 schema has 5 parameters with 0% description coverage, and the description does not explain any of them. Terms like 'owner', 'severity', 'scenario_id', 'minimum_score', and 'runtime_default_decision' are left entirely undefined. For a five-parameter tool with no schema documentation, this is a severe 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 states a verb ('Return') and a set of resources (AIVSS-aligned agentic risk scores, SLAs, evidence, hosted MCP wedges), so it is more than a tautology. However, 'hosted MCP wedges' is vague jargon and the definition does not distinguish this tool from any of the many sibling risk/scoring/assurance tools. It provides a general sense of purpose without a precise boundary.
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?
There is no explicit when-to-use, when-not-to-use, or alternative-tool guidance. The description does not say when an agent should select this pack over the many sibling risk, assurance, or scoring tools. It simply states what is returned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_app_intake_packRecipes Agentic App Intake PackCInspect
Return generated agentic app launch-review profiles and decisions.
| Name | Required | Description | Default |
|---|---|---|---|
| app_id | No | ||
| decision | No | ||
| risk_tier | No | ||
| buyer_stage | No | ||
| minimum_score | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, and it discloses almost nothing: not whether the call is read-only, whether results are cached or generated on demand, how filtering behaves when optional params are omitted, or any auth/rate considerations. The single verb 'Return' is the only behavioral signal.
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?
A single short sentence with no filler, which is good, but it is under-specified rather than concise — the brevity stems from missing content rather than from tight editing. Front-loaded verb+resource is fine.
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 presence of an output schema excuses the description from explaining return values, but for a five-parameter, zero-coverage, annotation-free tool the description is far too thin. Nothing tells an agent how to use the filters or what the call guarantees.
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 description coverage is 0% across five optional parameters (app_id, decision, risk_tier, buyer_stage, minimum_score), so the description must compensate and does not. Parameter names are somewhat self-descriptive, but the description adds no meaning about filtering semantics, allowed values, or how the numeric threshold interacts with the others.
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 states a general verb ('Return') and resource ('agentic app launch-review profiles and decisions'), which hints at a read operation over launch-review records. However, it does not distinguish this pack from the many similarly named sibling packs (intake, approval receipt, assurance, readiness scorecard), so an agent cannot tell when this one is the right choice. Minimum viable but vague.
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?
There is no when-to-use guidance, no prerequisites, and no named alternative among the ~60 sibling tools. The word 'generated' hints the profiles are pre-produced rather than computed on demand, but this is not made explicit as a selection criterion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_approval_receipt_packRecipes Agentic Approval Receipt PackCInspect
Return scope-bound approval receipt profiles, workflow requirements, and evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| risk_tier | No | ||
| workflow_id | No | ||
| action_class | No | ||
| approval_profile_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full disclosure burden, yet it says nothing about read-only vs. mutating behavior, permissions, side effects, or rate limits. 'Return' weakly implies a read, but no guarantees are stated.
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?
A single front-loaded sentence with no filler or repetition. It is efficient, though the extreme terseness contributes to gaps elsewhere rather than to conciseness itself.
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?
With an output schema present, return values need not be explained, but a 5-parameter, 0%-covered, annotation-free tool needs far more: parameter meaning, usage context, and behavioral guarantees are all absent.
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?
All 5 parameters have 0% schema description coverage and the description does not mention any of them. Terms like 'scope-bound' hint at filtering but never map to decision, risk_tier, workflow_id, action_class, or approval_profile_id.
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 uses a clear verb ('Return') and names specific artifacts (approval receipt profiles, workflow requirements, evidence). It does not distinguish this tool from the many sibling '..._pack' tools, so it stops short of a 5.
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?
There is no indication of when to use this tool, what prerequisites exist, or which sibling tools (e.g., run_receipt_pack, assurance_pack) are alternatives. Only a bare output statement is given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_assurance_packRecipes Agentic Assurance PackCInspect
Return enterprise assurance controls, workflow evidence, and AI/Agent BOM seed.
| Name | Required | Description | Default |
|---|---|---|---|
| control_id | No | ||
| workflow_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It implies a read ('Return') but discloses nothing about auth requirements, scoping behavior when control_id/workflow_id are omitted, result size, or how the three artifact types relate. The terse noun list leaves behavior opaque.
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?
A single, front-loaded sentence with no padding, which is efficient. However, it is a noun-list fragment rather than a structured statement, and its brevity borders on under-specification for a tool with two undocumented inputs.
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?
An output schema exists, so return-value detail is rightly omitted. But with no annotations, 0% parameter coverage, and no routing guidance among many near-identical siblings, the description is not sufficient for an agent to select or call this tool confidently.
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?
Two optional parameters exist at 0% schema description coverage, and the description never mentions control_id or workflow_id. It gives no indication of what values these IDs are, whether both are needed, or what happens when they are null. This falls well short of compensating for the documentation 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 verb 'Return' plus a bundle of three nouns ('enterprise assurance controls', 'workflow evidence', 'AI/Agent BOM seed') loosely conveys the resource but not a specific one. Against ~60 sibling 'recipes_agentic_*_pack' tools (including recipes_agentic_system_bom), it gives no basis for distinguishing this pack from adjacent ones. Purpose is implied rather than defined.
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?
There is no when-to-use guidance, no prerequisites, and no mention of alternatives among the many similar pack tools. The agent is left to infer invocation context entirely from the noun list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_catastrophic_risk_annexRecipes Agentic Catastrophic Risk AnnexCInspect
Return the severe-risk annex for high-impact agentic AI runtime decisions.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| control_id | No | ||
| scenario_id | No | ||
| buyer_view_id | No | ||
| impact_domain | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It does not disclose read-only status, permission requirements, rate limits, or any mutation/side-effect profile; only the word 'Return' weakly implies a read operation.
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 single sentence is front-loaded and free of fluff. It is efficient, though extremely sparse for a tool with five filter parameters and no annotation coverage.
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?
An output schema exists, so return values need not be explained. However, with five undocumented optional filters, no annotations, and no usage context, the definition is not complete enough to guide correct 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 schema has five optional parameters with 0% description coverage, and the description mentions none of them. It adds no meaning about status, control_id, scenario_id, buyer_view_id, or impact_domain, so the parameters remain entirely opaque.
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 states a specific verb and resource: return the severe-risk annex. It does not, however, distinguish this annex from the many sibling risk, incident, scoring, and assurance packs, so an agent cannot easily tell when this is the right artifact without opening schemas.
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?
There is no when-to-use guidance, no exclusions, and no named alternatives. The description only says what is returned, leaving the agent to infer usage context from the tool name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_control_plane_blueprintRecipes Agentic Control Plane BlueprintCInspect
Return the acquisition-ready agentic control plane architecture and buyer evidence map.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| layer_id | No | ||
| question_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
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 implies a read ('Return') but does not state whether the operation is read-only, what permissions are needed, whether results are cached/refreshed, or what filtering does. It adds only marketing-style framing ('acquisition-ready') rather than behavioral facts.
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?
A single short, front-loaded sentence with no filler or redundancy. It is efficient, though its brevity is partly under-specification rather than disciplined conciseness.
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?
An output schema exists so return values needn't be explained, but with no annotations and three undocumented filter parameters at 0% coverage, the definition leaves too much to inference. It does not say how the optional filters interact or what the blueprint contains at a glance.
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?
Three filter parameters (status, layer_id, question_id) have 0% schema description coverage and are never mentioned in the description, so the agent cannot tell what values are valid or what each filter scopes. Parameter names are loosely inferable, but nothing compensates for the coverage 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?
States a specific verb ('Return') and a named resource ('agentic control plane architecture and buyer evidence map'), so an agent understands what comes back. However it offers no differentiation from the many sibling 'recipes_agentic_*' packs (assurance_pack, posture_snapshot, system_bom), leaving the reader unsure why this one is distinct.
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?
There is no statement of when to use this tool, when not to, or which sibling to prefer instead. The phrase 'acquisition-ready' hints at a diligence/buyer context but never says so explicitly as a usage condition.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_entitlement_review_packRecipes Agentic Entitlement Review PackCInspect
Return expiring agent entitlement leases, access reviews, and scope evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| namespace | No | ||
| risk_tier | No | ||
| access_mode | No | ||
| identity_id | No | ||
| workflow_id | No | ||
| entitlement_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full disclosure burden. 'Return' implies a read, but nothing states whether this requires authorization, pagination behavior, freshness of the data, or whether results are filtered/scoped by the optional params.
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?
A single tight sentence with the key scope ('expiring') front-loaded and zero filler. It is efficient, though brevity here reflects under-specification as much as discipline.
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?
An output schema exists so return-format explanation is not required, but with six undocumented filter parameters, no annotations, and no usage context, the definition is not complete enough for an agent to invoke it correctly or confidently.
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?
All six parameters (namespace, risk_tier, access_mode, identity_id, workflow_id, entitlement_id) have 0% schema description coverage and no enums, and the description mentions none of them. The agent has no way to know what each filter accepts or means, which is a severe gap for a 6-param tool.
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 states a specific verb ('Return') and concrete resources ('expiring agent entitlement leases, access reviews, and scope evidence'), which is more than a restatement of the name. However, it does not differentiate from the many sibling 'pack' tools (e.g. agent_identity_ledger, access-review-adjacent packs), so an agent cannot tell which pack to pick without reading all names.
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?
There is no statement of when to use this tool, when not to, or which alternative to choose. With 50+ similarly named sibling packs, the absence of routing guidance leaves the agent to guess based on the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_exposure_graphRecipes Agentic Exposure GraphCInspect
Return risk-ranked agentic exposure paths across context, identities, MCP tools, and evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| node_id | No | ||
| path_id | No | ||
| decision | No | ||
| namespace | No | ||
| identity_id | No | ||
| workflow_id | No | ||
| minimum_score | No | ||
| path_class_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. "Risk-ranked" hints at ordering semantics, but it says nothing about how ranking is computed, whether results are bounded/paginated, what permissions are required, or how the four facets relate. For an 8-parameter analytical tool this is thin.
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?
A single front-loaded sentence with zero filler, which is structurally clean. It earns the score on brevity, though the brevity comes partly from under-specification rather than tight editing.
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?
An output schema exists, so return values need not be described. However, with no annotations, 0% schema coverage across 8 parameters, and no usage context, the definition leaves an agent unable to determine what the filters do or when this tool is the right choice.
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 description coverage is 0%, so all 8 parameters (node_id, path_id, decision, namespace, identity_id, workflow_id, minimum_score, path_class_id) are undocumented in both schema and description. Phrases like "identities" and "MCP tools" only vaguely gesture at filterable facets and explain none of the actual parameter names or value formats.
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?
States a specific verb ("Return") and a concrete resource ("risk-ranked agentic exposure paths"), with a scope spanning context, identities, MCP tools, and evidence. It is clear on its own, but gives no signal distinguishing it from the many other agentic risk/analysis siblings such as recipes_agentic_posture_snapshot or recipes_agentic_threat_radar.
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?
No when-to-use guidance, no prerequisites, and no named alternatives despite a sibling set dense with overlapping agentic-risk tools. The single sentence describes output only; an agent has no basis for choosing this over neighboring graph/score tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_incident_response_packRecipes Agentic Incident Response PackCInspect
Return agentic incident response classes, phases, workflow matrix, and evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| severity | No | ||
| workflow_id | No | ||
| incident_class_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It implies a read ('Return') but says nothing about permissions, whether inputs are required, how filtering behaves, or what the evidence payload contains. It discloses the output categories but no behavioral traits.
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?
A single front-loaded sentence with no wasted words, which is structurally clean. But at one line for a four-parameter pack tool, the brevity reads as under-specification rather than disciplined conciseness.
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?
An output schema exists, so return-format explanation is not required. Still, for a tool with four undocumented optional parameters and zero annotations, the description omits everything an agent would need to invoke it correctly: usage context, filter semantics, and any behavioral expectations.
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 tool has four parameters (decision, severity, workflow_id, incident_class_id) with 0% schema description coverage, and the description mentions none of them. It adds no meaning about what these optional filters do or how they narrow the returned pack, leaving every parameter undocumented in both the schema and the description.
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?
States a specific verb ('Return') and enumerates the resource contents: incident response classes, phases, workflow matrix, and evidence. This is clearly more than a tautology and tells the agent what the pack yields. However, it offers no differentiation from the many near-identical 'recipes_agentic_*_pack' siblings, so the agent cannot tell why it should pick this pack over, say, the soc_detection_pack.
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?
There is no guidance at all about when to use this tool, when not to, or which sibling to prefer. The description is purely a content inventory with no context-setting. An agent must infer usage purely from the tool name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_measurement_probe_packRecipes Agentic Measurement Probe PackCInspect
Return measurement probes for agentic workflow traceability and readiness.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| class_id | No | ||
| decision | No | ||
| probe_id | No | ||
| workflow_id | No | ||
| minimum_score | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, yet it discloses nothing about mutability, permissions, or side effects. The verb 'Return' weakly implies a read operation, but the description never confirms it, nor does it explain how the six filters interact or what happens when none are supplied.
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?
A single well-formed sentence with no waste and no redundancy. But the brevity comes at the cost of under-specification rather than disciplined conciseness, so it earns only a middling score.
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?
An output schema exists, so return values need not be described, but for a 6-parameter filtering tool with zero annotation and zero schema-description coverage, the definition leaves the agent unable to construct a meaningful call or predict the result set.
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?
Six parameters with 0% schema description coverage and no enum values, and the description adds no parameter meaning whatsoever. Nothing explains what status, class_id, decision, probe_id, workflow_id, or minimum_score filter on or how they combine.
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?
States a verb ('Return') and a resource ('measurement probes') with a scope qualifier ('agentic workflow traceability and readiness'). However, 'measurement probes' is jargon that is not defined, and the description does nothing to distinguish this tool from near-neighbors like recipes_agentic_readiness_scorecard, recipes_agentic_telemetry_contract, or recipes_agentic_posture_snapshot.
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?
There is no when-to-use guidance, no prerequisites, and no mention of any alternative sibling in a list of ~70 related recipes tools. The agent must guess whether this is the right tool for a probe/measurement need.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_posture_snapshotRecipes Agentic Posture SnapshotCInspect
Return the generated enterprise posture snapshot for agentic AI and MCP operations.
| Name | Required | Description | Default |
|---|---|---|---|
| finding_id | No | ||
| workflow_id | No | ||
| minimum_score | No | ||
| risk_factor_id | No | ||
| posture_decision | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full disclosure burden, and it discloses almost nothing: not whether this is a read-only lookup or a compute/generate operation, not the cost or latency, not whether the snapshot is cached or regenerated, and not whether the optional filters are ANDed together. The word "generated" hints at computation but is never resolved.
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?
A single front-loaded sentence with no filler or redundancy. It is compact, though its brevity reflects under-specification rather than disciplined conciseness.
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?
An output schema exists, so return values need not be described, but everything else is missing: five undocumented filters at 0% coverage, no annotations, and no differentiation from a large family of near-identically named agentic posture/risk tools. As written, an agent could not confidently choose or parameterize this call.
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 description coverage is 0% and the description mentions no parameter at all, leaving finding_id, workflow_id, minimum_score, risk_factor_id, and posture_decision entirely undefined in both places. For a five-filter tool, an agent has no way to know what values are valid (e.g., allowed posture_decision strings) or whether filters combine.
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 names a verb and resource ("Return the ... enterprise posture snapshot") and scopes it to agentic AI and MCP operations, so it is not a tautology. But "posture snapshot" is unexplained jargon, and against ~65 sibling recipes_* tools it gives no basis for distinguishing this artifact from recipes_agentic_readiness_scorecard, recipes_agentic_assurance_pack, or recipes_agentic_risk_* packs.
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?
There is no statement of when to call this tool, what preconditions exist (e.g., whether a snapshot must be generated first, given the sibling recipes_refresh), or which alternative artifacts to use instead. The only usage signal is the phrase "generated ... snapshot," which implies prior generation but never says so.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_protocol_conformance_packRecipes Agentic Protocol Conformance PackCInspect
Return MCP/A2A protocol conformance evidence and buyer-ready drift controls.
| Name | Required | Description | Default |
|---|---|---|---|
| check_id | No | ||
| decision | No | ||
| source_id | No | ||
| protocol_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. "Return" implies a read, but the description never states permissions, whether anything is mutated, rate limits, or what the evidence output actually contains.
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?
A single front-loaded sentence with no filler sentences. It loses a point only because the jargon-dense phrasing ("buyer-ready drift controls") adds words without adding 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?
An output schema exists, so return-value explanation is not required, but with four undocumented parameters and no annotations, the description is far too thin for an agent to invoke this correctly or route to it over its many siblings.
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 description coverage is 0% across four parameters (check_id, decision, source_id, protocol_id), and the description mentions none of them. The description provides no compensating meaning for what these identifiers select or how they interact.
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?
States a verb ("Return") and a resource ("MCP/A2A protocol conformance evidence"), which is more than a tautology, but "buyer-ready drift controls" is marketing jargon rather than a concrete deliverable. It gives no basis to distinguish it from close siblings like recipes_mcp_authorization_conformance_pack or recipes_mcp_tool_surface_drift_pack.
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?
There is no when-to-use guidance, no prerequisites, and no mention of alternatives among the ~60 sibling "pack" tools. The agent is left to infer selection from the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_readiness_scorecardRecipes Agentic Readiness ScorecardCInspect
Return generated scale, pilot, gate, or block decisions for agentic workflows.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| workflow_id | No | ||
| minimum_score | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, and it discloses almost nothing beyond the return vocabulary. It does not state whether the operation is read-only or generative, whether a missing workflow_id yields all workflows or an error, whether minimum_score filters results, or what the scorecard actually contains.
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?
A single front-loaded sentence with no filler or redundancy. It is efficient, though its brevity is closer to under-specification than to disciplined concision.
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?
An output schema exists, so return values needn't be described, but that is the only thing excused. With zero annotation coverage, 0% parameter documentation, and no workflow/prerequisite context, the definition leaves an agent unable to invoke this 3-parameter tool confidently.
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 description coverage is 0% for three parameters. The words "scale, pilot, gate, or block" loosely map to the `decision` filter and "minimum_score" is plausibly the threshold referenced by those labels, but `workflow_id` is never explained and no type/format/allowed values are given. The description adds only marginal meaning over the bare 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?
"Return generated scale, pilot, gate, or block decisions for agentic workflows" names a verb (return), a resource (decisions/scorecard), and enumerates the decision values. However, it never clarifies whether the tool computes these decisions or merely retrieves stored ones, and against ~70 sibling "recipes_*" packs (posture_snapshot, quality_report, assurance_pack) an agent cannot tell when this one applies.
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?
There is no when-to-use, when-not-to-use, or alternative-tool guidance. The description gives a bare capability statement with no indication of the precondition for calling it (e.g., does a workflow_id need to exist first, is this the entry point or a follow-up read?).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_red_team_drill_packRecipes Agentic Red Team Drill PackCInspect
Return adversarial drills for agentic remediation workflows and MCP controls.
| Name | Required | Description | Default |
|---|---|---|---|
| scenario_id | No | ||
| workflow_id | No | ||
| attack_family | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. 'Return' weakly implies a read operation, but the description does not disclose whether drills are generated or fetched, whether results are deterministic, how large the output is, or any auth/scoping constraints. For a tool with zero annotation coverage this is a significant gap.
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?
A single efficient sentence with the verb and resource front-loaded and no filler. It is well-sized, though its brevity is partly under-specification rather than disciplined trimming.
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?
An output schema exists, so return values need not be explained. However, with no annotations, no parameter documentation, and an ambiguous relationship to a very close sibling (red_team_replay_harness), the description is too thin for an agent to select and invoke this tool confidently.
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?
Three parameters (scenario_id, workflow_id, attack_family) have 0% schema description coverage and no elaboration in the description. The words 'remediation workflows' and 'adversarial drills' only loosely gesture at workflow_id and attack_family, leaving scenario_id and the relationship between the three filters unexplained.
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?
States a specific verb ('Return') and resource ('adversarial drills') with a domain scoping ('agentic remediation workflows and MCP controls'). It is clear what the tool produces, but it does not differentiate itself from the near-identical sibling recipes_agentic_red_team_replay_harness or the other red-team-adjacent packs like recipes_agentic_threat_radar.
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?
There is no when-to-use guidance, no condition that selects this tool over the replay harness or threat radar siblings, and no stated prerequisites. The agent must infer usage entirely from the tool name and the crowded sibling list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_red_team_replay_harnessRecipes Agentic Red Team Replay HarnessCInspect
Return replay fixtures, expected decisions, and evidence gates for red-team drills.
| Name | Required | Description | Default |
|---|---|---|---|
| severity | No | ||
| replay_id | No | ||
| scenario_id | No | ||
| workflow_id | No | ||
| attack_family | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description carries the full behavioral burden. 'Return' implies a read operation, but it says nothing about whether results are static fixtures or generated, whether filtering combines across the five optional parameters, or whether authentication or drill state is required to get meaningful output.
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?
A single compact sentence with the returned artifacts front-loaded and no filler. It is efficiently structured, though its brevity is achieved partly by omitting necessary detail rather than by disciplined editing.
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?
An output schema exists, so return-value description is not required, but the tool has five undocumented filter parameters, zero annotations, and no usage context. For a five-parameter retrieval harness, the definition leaves the agent without enough to invoke it correctly or interpret what the filters do.
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?
Five parameters (severity, replay_id, scenario_id, workflow_id, attack_family) all have 0% schema description coverage, no enums, and nullable defaults, yet the description mentions none of them or how they filter the returned fixtures. This is the same failure mode as the LOW calibration case and leaves every parameter's meaning to guesswork.
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 names a specific verb ('Return') and three concrete artifacts (replay fixtures, expected decisions, evidence gates) scoped to red-team drills, which an agent can distinguish from the similarly named recipes_agentic_red_team_drill_pack. It is clear but stops short of explicitly differentiating itself from that sibling.
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?
There is no when-to-use, when-not-to-use, or prerequisite guidance. The obvious alternative, recipes_agentic_red_team_drill_pack, is never mentioned, so an agent has no basis for choosing between them.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_run_receipt_packRecipes Agentic Run Receipt PackCInspect
Return agent run receipt templates for identity, context, tools, egress, approval, and evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| receipt_id | No | ||
| workflow_id | No | ||
| minimum_score | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, and it discloses almost nothing. It clarifies only that templates are returned rather than persisted receipts, but says nothing about read-only vs. mutating behavior, side effects, auth/permission requirements, or idempotency. For a tool with zero annotation coverage this is a significant gap.
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?
A single front-loaded sentence with no filler; the category list earns its place by scoping the returned templates. It is efficient, though the terseness comes at the cost of omitting any operational guidance.
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?
An output schema exists, so return values need not be explained, but the definition still leaves the agent without usage context, parameter meaning, or behavioral profile for a three-parameter tool. Given zero annotations and zero schema description coverage, the description is too thin to support confident 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?
Schema description coverage is 0% across three parameters (receipt_id, workflow_id, minimum_score), and the description does not mention any of them or explain filtering/scoring semantics. The enumerated categories (identity, context, tools, etc.) describe output content, not the input parameters, so the description fails to compensate for the coverage 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?
States a specific verb ('Return') and resource ('agent run receipt templates') and enumerates the receipt categories covered (identity, context, tools, egress, approval, evidence). It is clearly distinct from a generic template tool, though it does not explicitly differentiate itself from the closely related sibling recipes_agentic_approval_receipt_pack despite both touching 'approval' receipts.
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?
No guidance on when to invoke this tool versus alternatives, nor any preconditions or context for its use. The agent must infer from the name alone that this is a template/artifact generator for agent run receipts.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_soc_detection_packRecipes Agentic Soc Detection PackCInspect
Return SIEM-ready detections for agentic AI and MCP telemetry.
| Name | Required | Description | Default |
|---|---|---|---|
| rule_id | No | ||
| decision | No | ||
| severity | No | ||
| event_class | No | ||
| workflow_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It implies a read-style generation of detections, but discloses nothing about filtering behavior, whether output is deterministic, size, or any auth/rate constraints. Only marginal value beyond the name.
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?
A single front-loaded sentence with zero filler. It is efficient, though arguably too terse for a tool with five undocumented parameters and a large sibling surface.
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?
An output schema exists, so return-format explanation is not required. However, with five undocumented params, no annotations, and no usage guidance, the description is not sufficient for an agent to invoke this 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?
Five parameters (rule_id, decision, severity, event_class, workflow_id) with 0% schema coverage and no descriptions. The description never explains what these control or whether they filter the returned detections, so the schema-side gap is left uncompensated.
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 gives a specific verb+resource: "Return SIEM-ready detections for agentic AI and MCP telemetry." An agent can tell this is a detection-content pack, distinct from siblings like threat_radar or telemetry_contract. It stops short of explicitly naming or contrasting a sibling, so it earns 4 rather than 5.
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?
There is no when-to-use, when-not-to-use, or alternative routing guidance. Against a dense pack of ~70 sibling "recipes_*" tools (incident_response_pack, threat_radar, telemetry_contract), the agent gets no signal for choosing this one.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_source_freshness_watchRecipes Agentic Source Freshness WatchCInspect
Return source-freshness and standards-drift evidence for SecurityRecipes.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| source_id | No | ||
| freshness_class | No | ||
| publisher_family | No | ||
| watched_source_id | No | ||
| source_class_family | No | ||
| primary_watchlist_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, yet it discloses nothing beyond the implied read: no permissions or auth requirements, no statement of whether freshness/drift records are persisted or merely computed, no rate or scope limits. "Return ... evidence" hints at a read operation but that is inference, not disclosure.
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?
A single front-loaded sentence with no filler, which is structurally fine. But given seven optional parameters and no output guidance, the brevity reads as under-specification rather than economy.
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?
An output schema exists, so return values need not be described. Still, with seven undocumented parameters, zero annotations, and no usage routing, the definition leaves an agent without enough information to invoke the tool correctly or predict its behavior.
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 description coverage is 0% across seven parameters (decision, source_id, freshness_class, publisher_family, watched_source_id, source_class_family, primary_watchlist_id), and the description explains none of them. The phrase "source-freshness" weakly gestures at freshness_class/source_id but gives no meaning, format, or filtering semantics for the remaining parameters.
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 names a verb ("Return") and a resource ("source-freshness and standards-drift evidence") scoped to SecurityRecipes, so the general purpose is discernible. However, it never distinguishes this watch from near-identical siblings such as recipes_agentic_standards_crosswalk, recipes_agentic_threat_radar, or recipes_mcp_tool_surface_drift_pack, and "evidence" is left undefined.
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?
There is no statement of when to use this tool, when not to, or which sibling it replaces. An agent has no basis for choosing it over the many other agentic evidence/assessment tools in the same family.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_standards_crosswalkRecipes Agentic Standards CrosswalkCInspect
Return standards-to-evidence mappings for agentic AI, MCP, and prompt-injection guidance.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| source_id | No | ||
| control_id | No | ||
| standard_id | No | ||
| capability_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
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 implies a read-only retrieval ('Return'), but says nothing about whether the five filter parameters are combined with AND or OR, what happens when none are supplied (does it return everything?), pagination, or result size — all material for a catalog-style lookup tool.
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?
A single front-loaded sentence with no filler, and the resource is stated before the qualifier. It is efficient, though its brevity reflects under-specification that is penalized in other dimensions rather than verbosity problems here.
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?
An output schema exists, so return-format explanation is correctly omitted. However, with no annotations, no schema descriptions, and five undocumented filter parameters, the definition leaves the agent without enough information to invoke the tool correctly or predict its filtering behavior.
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 description coverage is 0% for five optional parameters (status, source_id, control_id, standard_id, capability_id), and the description mentions none of them. The parameter names are somewhat self-explanatory, but there is no indication of accepted values or filter interaction, so the description does not compensate for the coverage 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?
States a concrete verb ('Return') and a specific resource ('standards-to-evidence mappings') scoped to three named domains (agentic AI, MCP, prompt-injection guidance). The purpose is clear on its own, but nothing distinguishes it from the many similarly named agentic/secure-context sibling packs (e.g. recipes_agentic_control_plane_blueprint, recipes_secure_context_evidence_contract).
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?
There is no guidance on when to call this tool versus its many siblings, no prerequisites, and no stated alternative for the reverse lookup (evidence-to-standards). The agent must infer usage entirely from the name and description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_system_bomRecipes Agentic System BomCInspect
Return the Agentic System BOM for workflows, agents, identities, MCP tools, and evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| namespace | No | ||
| agent_class | No | ||
| workflow_id | No | ||
| component_type | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. "Return" weakly implies a read-only operation, but the description says nothing about permissions, scoping behavior, whether filters are conjunctive, or what happens when no filters are supplied — all undefined given four optional parameters.
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?
A single front-loaded sentence with no filler. It is efficient, though terse enough that it could have spent a few more words on filtering and sibling differentiation at little cost.
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?
An output schema exists, so return values need not be described, but the description still omits critical context: no annotations covering safety/mutation semantics, no explanation of the four undocumented filter parameters, and no differentiation from the many related agentic-* tools.
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 description coverage is 0% and none of the four parameters (namespace, agent_class, workflow_id, component_type) are explained in the description. The listed entity types loosely hint at filter dimensions, but there is no indication of how each parameter narrows the BOM or how they combine.
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?
States a specific verb ("Return") and resource ("Agentic System BOM") and enumerates the covered entity types (workflows, agents, identities, MCP tools, evidence), which gives the agent a concrete picture of scope. However, it never differentiates itself from closely-named siblings like recipes_agentic_exposure_graph or recipes_agentic_posture_snapshot, and "BOM" remains domain jargon.
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?
There is no when-to-use guidance, no stated preconditions, and no mention of alternative tools despite a large set of overlapping agentic-* siblings. The agent must infer usage purely from the name and description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_telemetry_contractRecipes Agentic Telemetry ContractCInspect
Return the OpenTelemetry-aligned agentic telemetry and redaction contract.
| Name | Required | Description | Default |
|---|---|---|---|
| check_id | No | ||
| decision | No | ||
| workflow_id | No | ||
| signal_class_id | No | ||
| required_attribute | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full behavioral burden. 'Return' implies a read, but it says nothing about auth/permission requirements, whether filters change the returned contract, rate limits, or side effects.
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?
A single, front-loaded sentence with no filler or redundancy. It is efficient, though its brevity is achieved partly by omitting information the tool needs.
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?
An output schema exists, so return values need not be explained, but the definition still leaves five undocumented filter parameters, no usage context, and no behavioral disclosure for a domain-heavy contract tool with many near-identical siblings.
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?
All five parameters (check_id, decision, workflow_id, signal_class_id, required_attribute) have 0% schema description coverage and zero documentation. The description adds no meaning for any of them, leaving the agent unable to know what a valid value or the effect of each filter is.
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 gives a specific verb ('Return') and a named resource ('OpenTelemetry-aligned agentic telemetry and redaction contract'), which is more than a tautology. It does not, however, distinguish itself from the many sibling '*_contract' and '*_pack' tools, so an agent still has to infer which contract to pick.
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?
There is no statement of when to call this tool, when not to, or which sibling alternatives exist. The description is purely declarative about what is returned and offers no routing guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agentic_threat_radarRecipes Agentic Threat RadarCInspect
Return current source-backed agentic AI threat signals and product priorities.
| Name | Required | Description | Default |
|---|---|---|---|
| horizon | No | ||
| priority | No | ||
| signal_id | No | ||
| capability_id | No | ||
| minimum_score | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, yet it discloses nothing beyond the return payload. It does not say whether the call is read-only, how 'current' freshness is determined, whether results are cached, paginated, or how scores/priorities are ranked.
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?
A single front-loaded sentence with zero filler; the core action and resource appear immediately. It is efficient, though its brevity reflects under-specification rather than disciplined trimming.
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?
An output schema exists, so return-value explanation is not required, but a five-parameter filter tool with zero parameter documentation and no annotations needs far more than one sentence. The agent lacks the information needed to call it correctly or to route to the right sibling.
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 description coverage is 0% across five parameters (horizon, priority, signal_id, capability_id, minimum_score), so the description must compensate and largely does not. 'Threat signals' and 'product priorities' hint weakly at signal_id and priority, but the accepted formats for horizon, capability_id, and minimum_score are entirely undocumented anywhere.
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 states a specific verb ('Return') and a specific resource ('source-backed agentic AI threat signals and product priorities'), which is more informative than a bare name restatement. However, it does not differentiate itself from the many closely-named siblings such as recipes_agentic_exposure_graph, recipes_agentic_posture_snapshot, or recipes_agentic_source_freshness_watch, so an agent cannot tell from the text alone which of these to pick.
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?
There is no statement of when to use this tool, when not to, or which sibling to prefer for adjacent needs (e.g. freshness monitoring vs. risk registers). The agent is left to infer usage purely from the tool name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agent_identity_ledgerRecipes Agent Identity LedgerCInspect
Return agent non-human identity, delegation, scope, and audit contracts.
| Name | Required | Description | Default |
|---|---|---|---|
| agent_class | No | ||
| identity_id | No | ||
| workflow_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It does not state that this is a read-only lookup, what the ledger returns, whether results are scoped per-tenant, or how the optional filters interact - none of the context a caller needs is disclosed.
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?
It is a single short sentence with no waste, but it is under-specified rather than concise - the brevity comes from omitting essential information, not from tight writing. Nothing is front-loaded beyond a bare domain list.
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?
An output schema exists, so return-value detail is not strictly required. But for a 3-parameter tool with 0% schema coverage and no annotations, the description should at minimum explain the filters and the read-only nature of the call; neither is present, leaving the definition inadequate.
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 description coverage is 0% and the description adds nothing about agent_class, identity_id, or workflow_id. The word 'identity' loosely gestures at identity_id, but there is no explanation of what values these filters accept, whether they combine, or what omitting them returns.
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 has a verb ('Return') and names the domains covered (non-human identity, delegation, scope, audit contracts), which loosely distinguishes it from siblings like recipes_agent_capability_risk_register. However, 'contracts' is undefined and it never says what form the ledger takes or what 'return' produces, so an agent cannot confidently tell its exact scope from the sibling cluster.
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?
There is no statement of when to use this tool, when not to, or which sibling to prefer for adjacent questions (e.g. delegation vs. handoff boundary or capability risk). The domain nouns imply a topical fit at best; no explicit routing guidance is given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agent_memory_boundary_packRecipes Agent Memory Boundary PackCInspect
Return agent memory classes, workflow profiles, TTLs, and persistence decisions.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| persistent | No | ||
| workflow_id | No | ||
| memory_class_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full behavioral burden and mostly fails. 'Return' implies a read, but nothing states whether the four optional inputs act as filters, whether results are scoped by them, or what happens when they are omitted.
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?
A single front-loaded sentence with no filler. It is efficient, though it could spend a few more words mapping the four inputs to behavior without becoming bloated.
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?
An output schema exists, so return values need not be described, but the invocation side is unaddressed: four optional, nullable parameters with 0% coverage and no annotations leave the agent guessing how to call it meaningfully.
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 description coverage is 0% and the description never explains the four parameters (decision, persistent, workflow_id, memory_class_id). The listed return concepts loosely echo two of them, but there is no mapping and no indication of whether these are filters, selectors, or overrides.
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?
States a specific verb (Return) and a concrete resource (agent memory classes, workflow profiles, TTLs, persistence decisions). The purpose is legible, but it does nothing to distinguish itself from the surrounding boundary-pack siblings, so an agent cannot tell why it would pick this over recipes_agent_handoff_boundary_pack without opening the schema.
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?
There is no when-to-use guidance, no prerequisites, and no naming of alternatives among the ~60 sibling tools. The agent is left to infer context entirely from the title and resource list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agent_skill_supply_chain_packRecipes Agent Skill Supply Chain PackCInspect
Return agent skill provenance, permission, isolation, and supply-chain decisions.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| platform | No | ||
| skill_id | No | ||
| risk_tier | No | ||
| minimum_score | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It implies a read ('Return'), but says nothing about permissions required, whether filtering is scoped, rate limits, or what 'decisions' contain. For a supply-chain/security tool with a rich risk surface, this is a substantial gap.
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?
A single, front-loaded sentence with no filler. It is efficient, though efficiency here partly reflects under-specification rather than disciplined editing.
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?
An output schema exists, so return-value explanation is not required. But with zero annotations, 0% parameter coverage on five params, and no usage context, the definition is not complete enough for an agent to call it confidently among so many similar peers.
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?
Five parameters (decision, platform, skill_id, risk_tier, minimum_score) with 0% schema description coverage, and the description mentions none of them. It does not explain what values decision/risk_tier/platform accept or how minimum_score filters results, leaving every parameter undocumented in both schema and prose.
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 states a verb and a resource domain ('Return agent skill provenance, permission, isolation, and supply-chain decisions'), so the general purpose is inferable. However, 'decisions' is vague about what is actually returned, and nothing distinguishes it from close siblings like recipes_agent_trust_fabric_pack or recipes_mcp_connector_trust_pack. Adequate but not sibling-differentiating.
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?
There is no when-to-use guidance, no prerequisites, and no named alternative. With 60+ sibling 'pack' tools in this family, an agent gets no help deciding when this one applies versus the trust-fabric or connector-trust packs.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_agent_trust_fabric_packRecipes Agent Trust Fabric PackCInspect
Return Agent Trust Fabric dimensions, workflow tiers, source evidence, and buyer proof.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| trust_tier | No | ||
| workflow_id | No | ||
| dimension_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. 'Return' implies a read operation, but there is no explicit read-only statement, no information about authentication, pagination, filtering behavior, or the effect of omitting parameters.
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 single sentence is front-loaded with the verb and contains no filler, which is efficient. It is slightly too sparse for a tool with four parameters and no annotations, but it avoids unnecessary repetition.
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?
An output schema exists, so return shape need not be described. However, with no annotations, 0% schema description coverage, and four parameters, the description is not complete enough to guide an agent on filtering or invocation beyond a minimal notion of the returned content.
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 description coverage is 0% and there are four optional parameters. The description mentions 'dimensions' and 'workflow tiers', which loosely correspond to dimension_id and trust_tier, but it does not explain what status, trust_tier, workflow_id, or dimension_id actually filter or control.
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 uses a specific verb (Return) and names the resource contents: Agent Trust Fabric dimensions, workflow tiers, source evidence, and buyer proof. However, it does not distinguish this tool from the many sibling recipes_* pack tools, several of which also return trust or assurance artifacts.
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?
There is no guidance on when to use this tool versus alternatives, no prerequisites, and no explanation of how the optional filters should be applied. The description only states what is returned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_browser_agent_boundary_packRecipes Browser Agent Boundary PackCInspect
Return browser-agent workspace classes, task profiles, controls, and evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| risk_tier | No | ||
| task_profile_id | No | ||
| workspace_class_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. "Return" implies a read-only retrieval, but nothing confirms read-only semantics, whether the optional filters narrow or widen the result set, whether results are paginated, or how large a response to expect.
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?
A single front-loaded sentence with no filler or repetition; the resource enumeration is efficient. It is terse to the point of under-specification, but that is a completeness problem rather than verbosity.
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?
An output schema exists, so return values need not be explained. However, with no annotations, 0% parameter coverage, and no usage routing against a dense sibling set of boundary packs, the description leaves an agent without enough to select or correctly filter this 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?
Schema description coverage is 0% across four optional filter parameters (decision, risk_tier, task_profile_id, workspace_class_id), and the description mentions none of them. The parameter names are reasonably self-describing, but with zero coverage the description should have compensated and does not.
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?
States a specific verb ("Return") plus a concrete resource set (workspace classes, task profiles, controls, evidence) that identifies it as a read/retrieval tool distinct from sibling packs like recipes_agent_handoff_boundary_pack. It never explains what the pack is for or why a browser-agent boundary differs from the other boundary packs, so sibling differentiation rests on the name alone.
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?
There is no when-to-use guidance, no when-not-to-use, and no named alternative among the ~20 sibling boundary/agentic packs. An agent cannot tell from the description which situation calls for this pack versus recipes_agent_handoff_boundary_pack or recipes_context_egress_boundary_pack.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_context_egress_boundary_packRecipes Context Egress Boundary PackCInspect
Return context egress data classes, destination classes, and workflow boundary policy.
| Name | Required | Description | Default |
|---|---|---|---|
| source_id | No | ||
| data_class | No | ||
| workflow_id | No | ||
| destination_class | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. 'Return' weakly implies a read-only lookup, but the description discloses nothing about permissions, scoping, whether the four optional filters are ANDed, or behavior when no filters are supplied. For a tool with zero annotation coverage this is thin, though the existing output schema covers the return shape.
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?
A single front-loaded sentence with no filler and no redundancy. It is appropriately sized, though brevity here is partly a symptom of under-specification rather than disciplined editing.
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?
An output schema exists so return values needn't be described, but with four undocumented optional parameters and no annotations, the definition leaves the agent without enough to invoke the tool confidently or know what distinguishes it from sibling boundary packs.
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 description coverage is 0% across four parameters, so the description must compensate and does not. It loosely echoes 'data classes' and 'destination classes' which hint at data_class/destination_class, but source_id and workflow_id are never explained, nor is the meaning of combining these optional filters.
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?
States a specific verb ('Return') and enumerates the artifacts returned (context egress data classes, destination classes, workflow boundary policy), which is clear enough for an agent to know what comes back. However, it does not distinguish this tool from boundary-themed siblings like recipes_agent_handoff_boundary_pack or recipes_agent_memory_boundary_pack, so the agent must guess which boundary pack applies.
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?
There is no when-to-use guidance, no conditions that select this tool over the many sibling '*_boundary_pack' tools, and no prerequisites stated. The agent gets a description of contents but no trigger for calling it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_context_poisoning_guard_packRecipes Context Poisoning Guard PackCInspect
Return context-poisoning scan results for registered secure-context sources.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| rule_id | No | ||
| decision | No | ||
| severity | No | ||
| source_id | No | ||
| actionable_only | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations at all, the description carries the full burden and does not meet it: it never states that this is a non-mutating read, whether results are paginated or capped, what a 'decision' outcome means, or what happens when no sources are registered. Only the word 'Return' hints at read-only behavior, which is a weak inference rather than a disclosure.
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?
A single efficient sentence with the resource front-loaded and no filler. It is appropriately sized, though its brevity comes at the cost of the missing detail noted elsewhere.
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?
An output schema exists, so return values need not be described, but the query surface is not covered: six optional parameters with implicit defaults and no documented filter/limit behavior leaves the agent unable to construct a correct invocation. For a parameterized findings tool with zero annotations and zero schema coverage, this is under-specified.
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?
Six parameters with 0% schema description coverage, and the description explains none of them. The critical filters (rule_id, decision, severity, source_id, actionable_only) and the limit default are left entirely unspecified, so the agent cannot know valid values or filtering semantics — exactly the compensation gap the description should fill.
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?
States a clear verb ('Return') and a specific resource ('context-poisoning scan results for registered secure-context sources'), so the agent knows it is a read of scan findings scoped to secure-context sources. However, it does not distinguish itself from the many adjacent siblings (e.g. recipes_secure_context_trust_pack, recipes_secure_context_eval_pack, recipes_agentic_source_freshness_watch), leaving the agent to guess among overlapping 'pack' tools.
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?
No guidance on when to use this versus any alternative, no prerequisites (what counts as a 'registered' source), and no exclusions. The agent must infer the usage context entirely from the name and the phrase 'registered secure-context sources'.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_critical_infrastructure_secure_context_packRecipes Critical Infrastructure Secure Context PackCInspect
Return the generated critical-infrastructure secure-context profile.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| sector_id | No | ||
| control_id | No | ||
| buyer_view_id | No | ||
| readiness_status | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, and it discloses essentially nothing: not whether the tool reads a pre-generated artifact or computes one, not whether it has side effects, auth requirements, or how the parameter filters affect the result. The only minor credit is the word 'generated,' hinting the profile is a pre-existing artifact.
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?
It is a single front-loaded sentence with no wasted words, which is structurally clean. But the brevity reflects under-specification rather than disciplined concision for a tool with five inputs and a rich sibling surface.
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?
An output schema exists, so return values need not be described. Still, for a 5-parameter tool with no annotations and no usage guidance, the description leaves the agent unable to determine what inputs do or when to call it, which is a substantial completeness gap.
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?
All five parameters (decision, sector_id, control_id, buyer_view_id, readiness_status) have 0% schema description coverage and the description adds no meaning about them whatsoever. It does not say whether they are filters, whether supplying them narrows or selects the profile, or whether they are required for meaningful output. With five undocumented params the description must compensate and does not.
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 names a specific verb ('Return') and a specific resource ('critical-infrastructure secure-context profile'), so the basic purpose is parseable. However, it offers no differentiation from the ~70 sibling 'recipes_*_pack' tools, and 'generated' begs the question of what generates it. It is adequate but thin.
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?
There is no when-to-use, when-not-to-use, or alternative-tool guidance anywhere in the description. Given the dense sibling list (e.g. recipes_secure_context_trust_pack, recipes_secure_context_evidence_contract), an agent has no signal for choosing this tool over neighbors.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_cve_catalog_infoRecipes Cve Catalog InfoAInspect
Return the complete Medium/High/Critical CVE catalog scope, coverage, provenance, and counts.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations the description carries the full burden, and it does disclose that the returned scope is limited to Medium/High/Critical severities and includes provenance. However, it says nothing about permissions, freshness guarantees, or response size/caching for what is evidently a static metadata endpoint; the low inherent risk of a zero-arg read keeps this from being worse.
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?
A single front-loaded sentence naming the verb, resource, and returned fields with zero filler. Nothing is padded and nothing unrelated is included.
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?
An output schema exists, so return values need not be explained, and the description still previews the four content areas (scope, coverage, provenance, counts). For a simple zero-param info tool the definition is essentially complete, missing only an explicit pointer to the sibling CVE tools.
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 tool takes zero parameters, so per the baseline there is nothing for the description to disambiguate. The severity-scoping language adds context about the implicit filter the catalog applies, which is a small bonus over an empty 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?
States a specific verb ('Return') plus the resource ('CVE catalog') and enumerates exactly what the payload contains: scope, coverage, provenance, and counts. The severity framing (Medium/High/Critical) further narrows the scope, making it distinguishable from recipes_cve_get and recipes_cve_search, though it never names those siblings.
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?
Usage is implied rather than stated: 'catalog info' reads as a metadata/about call to be used alongside the per-CVE get and search tools, but the description gives no explicit when-to-use, when-not-to-use, or alternative tool names. An agent can infer the role but is not guided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_cve_getRecipes Cve GetAInspect
Get evidence, recipe authority, and a bounded code/config/file change plan for one exact CVE.
| Name | Required | Description | Default |
|---|---|---|---|
| cve | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the disclosure burden itself. It usefully characterizes the output as 'bounded' evidence plus a change plan, hinting at scope limits, but says nothing about read-only behavior, data freshness/source, auth needs, or rate limits. The 'Get' verb implies a safe read, but this is inference rather than stated behavior.
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?
A single dense sentence with no filler. The required scope qualifier ('one exact CVE') and the payoff (change plan) are both front-loaded, so an agent can triage the tool at a glance.
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?
An output schema exists, so return values need not be re-explained, and the description still summarizes the payload. For a one-parameter read tool the coverage is nearly sufficient; the only meaningful gap is routing guidance against the other CVE-related siblings.
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 description coverage is 0% for the single 'cve' parameter. The description compensates partially by signaling that the value must be one exact CVE identifier (not a range or keyword), which adds real meaning over the bare schema, but it does not specify accepted formats such as CVE-YYYY-NNNN.
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 names a specific verb ('Get') and a tightly scoped resource ('one exact CVE'), then enumerates what is produced: evidence, recipe authority, and a bounded change plan. The word 'one exact' implicitly separates it from a multi-result sibling like recipes_cve_search, though no sibling is named explicitly.
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?
Usage is only implied. 'One exact CVE' suggests this is a single-item lookup rather than a search, but the description never states when to prefer it over recipes_cve_search, recipes_cve_catalog_info, or recipes_match_finding, nor does it give prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_cve_searchRecipes Cve SearchCInspect
Search every in-scope Medium/High/Critical CVE; use recipes_cve_get for complete details.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes | ||
| kev_only | No | ||
| severity | No | ||
| published_year | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It implies a read-only search but says nothing about pagination, result caps (the limit default of 20 contradicts 'search every'), rate limits, or what an empty/partial result means. For a 5-param tool with zero annotation coverage this is thin.
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?
A single efficient sentence with the core capability front-loaded and the alternative appended. Nothing is padded, though the brevity is partly achieved by omitting needed detail rather than by pruning.
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?
An output schema exists, so return-value explanation is rightly omitted, but the definition leaves four of five filters unexplained, provides no annotation substitutes, and its 'every CVE' claim sits awkwardly against a default limit of 20. It is not complete enough for an agent to invoke the filters 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?
Schema description coverage is 0%, so the description must explain the parameters and largely does not. 'Medium/High/Critical' loosely gestures at the severity filter, but query syntax, kev_only, limit, and published_year are completely undocumented anywhere.
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?
States a specific verb (Search) and resource (CVE) with a scope qualifier (in-scope Medium/High/Critical). It also names the sibling recipes_cve_get and positions itself as the summary view, which lets an agent distinguish it from that tool without opening a schema.
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 routes the agent to recipes_cve_get when full details are needed, which is a genuine alternative hint. However, it never states when to use this search versus recipes_cve_catalog_info, nor any preconditions or exclusions, so usage is only partially implied.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_design_partner_pilot_packRecipes Design Partner Pilot PackCInspect
Return the design partner pilot motion for buyer proof and hosted MCP validation.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| risk_id | No | ||
| phase_id | No | ||
| wedge_id | No | ||
| metric_id | No | ||
| segment_id | No | ||
| question_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. "Return" weakly implies a read-only fetch, but the description discloses nothing about permissions, whether the result is static or computed, or how the returned motion relates to the filter parameters. For a tool with zero annotation coverage this is a meaningful gap.
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?
It is a single front-loaded sentence with no filler, which is structurally clean. But the brevity is achieved by omission rather than precision — the sentence is too thin to orient an agent calling a 7-parameter tool.
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?
An output schema exists so return values needn't be spelled out, but with 7 undocumented parameters, no annotations, and no usage context, the description leaves the agent without enough to invoke the tool correctly. It fails to carry the burden the structured fields don't cover.
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?
Seven optional parameters (status, risk_id, phase_id, wedge_id, metric_id, segment_id, question_id) exist at 0% schema description coverage, and the description explains none of them. The agent cannot tell whether these are filters, selectors, or scoping identifiers, nor what values are valid.
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 names a verb ("Return") and a resource ("design partner pilot motion"), so the general shape is clear. However, "pilot motion" is abstract jargon that doesn't tell an agent what data actually comes back, and nothing distinguishes this pack from near-identical siblings like recipes_secure_context_customer_proof_pack or recipes_hosted_mcp_readiness_pack, both of which also touch buyer proof and hosted MCP validation.
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?
There is no explicit when-to-use guidance, no when-not-to-use, and no named alternative among the many sibling packs. An agent has no basis for choosing this tool over the dozens of other recipes_* packs beyond guessing from the title.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_enterprise_trust_center_exportRecipes Enterprise Trust Center ExportCInspect
Return the bundled enterprise trust-center export for buyer and platform diligence.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| pack_id | No | ||
| category | No | ||
| section_id | No | ||
| question_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. 'Return' implies a read, but nothing explains whether the export is pre-bundled server-side, how the optional filters interact, whether results are truncated, or what permissions are needed. The word 'bundled' hints at aggregation but is not elaborated.
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?
A single front-loaded sentence with no filler. It is appropriately short, though that brevity is partly the result of under-specification rather than disciplined editing.
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?
An output schema exists, so return values need not be re-explained. But with five undocumented parameters, no annotations, and no usage routing against a dense field of sibling trust/diligence tools, the definition leaves too much for the agent to infer before calling.
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?
Five optional parameters (status, pack_id, category, section_id, question_id) have 0% schema description coverage, and the description adds no meaning about any of them. It never explains the filter hierarchy or whether the parameters narrow the bundle or select a sub-section, leaving five undocumented knobs.
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?
States a specific verb ('Return') and resource ('bundled enterprise trust-center export') with a stated audience ('buyer and platform diligence'). However, it does not distinguish itself from nearby siblings such as recipes_secure_context_buyer_diligence_brief or recipes_agent_trust_fabric_pack.
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?
There is no explicit when-to-use guidance, no prerequisites, and no named alternative. The phrase 'for buyer and platform diligence' implies a context but does not tell the agent when this tool should be selected over the many adjacent 'pack' and 'diligence' siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_getRecipes GetBInspect
Get a full recipe record by slug or path.
| Name | Required | Description | Default |
|---|---|---|---|
| slug_or_path | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It only implies a read operation and that a full record is returned; it does not disclose permissions, rate limits, error behavior, or what happens if the identifier is not found.
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?
A single front-loaded sentence with no wasted words. The core action and lookup key are presented immediately.
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?
For a simple single-parameter read tool with an output schema, the description is minimally adequate. It omits routing guidance against the many sibling list/search/get tools and does not clarify identifier format, which leaves meaningful gaps for an agent selecting among dozens of recipes_* tools.
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 description coverage is 0% for the single required parameter. The description says 'slug or path', which largely repeats the parameter name slug_or_path and adds no format examples, validation rules, or path syntax to compensate 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 names a specific verb (Get) and resource (full recipe record) and specifies the lookup key (slug or path). It implicitly distinguishes direct lookup from list/search siblings, but does not explicitly differentiate itself from recipes_list or recipes_search.
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 phrase 'by slug or path' implies the tool is used when an identifier is known, which is useful usage context. However, it gives no explicit when-to-use guidance against alternatives like recipes_list or recipes_search, nor any exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_hosted_mcp_readiness_packRecipes Hosted Mcp Readiness PackCInspect
Return the hosted MCP readiness plan for enterprise product rollout.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| gate_id | No | ||
| risk_id | No | ||
| stage_id | No | ||
| control_id | No | ||
| buyer_evidence_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. 'Return' implies a read, but it doesn't disclose whether this computes/generates a plan versus retrieving a stored one, what auth or tenant scope is needed, or what happens with the six optional ID filters. This is a significant gap for an unannotated tool.
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?
A single front-loaded sentence with no padding, which is structurally clean. But it is under-specified rather than genuinely concise — the brevity comes at the cost of all usage and parameter context.
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?
An output schema exists, so return-value explanation is not required. But with six undocumented optional parameters, no annotations, and no usage guidance, the definition leaves an agent unable to invoke this correctly against its many similar siblings.
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?
Six optional parameters (status, gate_id, risk_id, stage_id, control_id, buyer_evidence_id) with 0% schema description coverage and zero mention in the description. An agent cannot tell whether these filter, scope, or select the returned plan, nor what entity each ID refers to.
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?
States a specific verb and resource ('Return the hosted MCP readiness plan'), which is clearer than a tautology. However, the crowded sibling set contains many near-identical readiness/risk/trust pack tools (e.g. recipes_agentic_readiness_scorecard, recipes_mcp_risk_coverage_pack), and nothing here distinguishes this one from them or clarifies what 'hosted MCP readiness' actually covers.
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?
No when-to-use guidance, no prerequisites, and no mention of alternatives among the dozens of sibling packs. The phrase 'for enterprise product rollout' is a context hint but not an actionable usage rule.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_listRecipes ListCInspect
List recipes with optional metadata filtering.
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | ||
| agent | No | ||
| limit | No | ||
| facets | No | ||
| section | No | ||
| severity | No | ||
| min_quality | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, yet it says nothing about pagination or how 'limit' defaults, result ordering, or whether filtering is conjunctive. It also doesn't disclose auth or rate-limit characteristics. Given zero annotation coverage for a 7-parameter listing tool, this is a thin disclosure.
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?
A single front-loaded sentence with no filler, which is structurally clean. It is arguably underspecified rather than wasteful, so the terse form costs a little clarity without bloating.
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?
For a 7-parameter, zero-required, zero-coverage listing tool with no annotations, the description omits nearly everything an agent needs to call it correctly. The presence of an output schema means return values needn't be described, but filter semantics, limit behavior, and sibling routing are all missing.
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 description coverage is 0%, so all seven parameters (tags, agent, limit, facets, section, severity, min_quality) are undocumented anywhere. The phrase 'metadata filtering' gestures at the filter family but gives no semantics for any individual parameter or how they combine.
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?
States a specific verb and resource ('List recipes') plus a scope qualifier ('optional metadata filtering'), so the basic operation is clear. However, it does nothing to distinguish itself from siblings like recipes_search or recipes_get, which a listing tool must do since an agent choosing between them has no signal here.
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?
No guidance on when to use this versus recipes_search (query-based retrieval) or recipes_get (single-item lookup). There are also no prerequisites or exclusions, so the agent must infer the routing entirely from the name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_match_findingRecipes Match FindingCInspect
Heuristic matcher that suggests best-fit recipes for a security finding.
| Name | Required | Description | Default |
|---|---|---|---|
| cve | No | ||
| limit | No | ||
| facets | No | ||
| package | No | ||
| rule_id | No | ||
| keywords | No | ||
| ecosystem | No | ||
| min_quality | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description carries the full burden. It hints at read-only/non-deterministic behavior via 'heuristic matcher' and 'suggests', but omits auth requirements, rate limits, side effects, or output characteristics.
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?
One concise sentence, front-loaded with the tool's action. No wasted words, though it could include more specific guidance without becoming verbose.
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?
Tool has 8 parameters, 0 required, 0% schema coverage, no annotations, and a complex heuristic matching purpose. Output schema exists, so return values needn't be described, but the description omits all input semantics and usage context.
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 description coverage is 0% across 8 optional parameters (cve, package, rule_id, keywords, ecosystem, facets, min_quality, limit), and the description mentions none of them. It adds no meaning beyond parameter names.
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 states a specific matching action ('suggests best-fit recipes') and target ('security finding'), so an agent can tell it is a matcher. However, it does not differentiate from sibling tools like recipes_cve_search or recipes_playbook_plan, and 'security finding' is undefined.
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?
No when-to-use guidance, no alternatives, no prerequisites. The description does not say when to choose this over recipes_cve_* or recipes_search.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_authorization_conformance_packRecipes Mcp Authorization Conformance PackCInspect
Return MCP authorization conformance, scope-drift, and token-boundary evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| namespace | No | ||
| workflow_id | No | ||
| connector_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It implies a safe read ('Return ... evidence') but never states read-only semantics, required authorization/scopes, whether the call reaches upstream connectors, or any rate/limit behavior. Only a bare output summary is given.
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?
It is a single front-loaded sentence with no filler, so it is efficient. It is arguably under-specified rather than concise, but it wastes no 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?
An output schema exists, so return format need not be explained. But with zero annotation coverage, four entirely undocumented parameters, and no sibling differentiation, the definition is too thin for an agent to invoke the tool correctly or know when it applies.
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?
All four parameters (decision, namespace, workflow_id, connector_id) are undocumented in the schema (0% coverage), and the description mentions none of them. An agent cannot infer what these optional filters do or how to scope the call, so the description fails to compensate for the coverage 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 names a specific verb ('Return') and a fairly specific resource ('MCP authorization conformance, scope-drift, and token-boundary evidence'), so an agent understands the artifact produced. However, it does not differentiate itself from adjacent sibling packs such as recipes_agentic_protocol_conformance_pack or recipes_mcp_tool_surface_drift_pack, which overlap in the conformance/evidence space.
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?
There is no guidance on when to invoke this pack versus the many other conformance/drift/risk packs, and no stated preconditions or exclusions. The single sentence is purely descriptive of output, leaving usage entirely to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_connector_intake_packRecipes Mcp Connector Intake PackCInspect
Return MCP connector intake decisions, risk findings, gaps, and promotion plans.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| namespace | No | ||
| candidate_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full disclosure burden, and it says nothing about whether the tool is read-only, whether it mutates state, what auth it requires, or what triggers it. "Return" weakly implies a read, but that is inference, not disclosure.
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?
A single front-loaded sentence with no padding, so it is structurally clean. But its brevity reflects under-specification rather than disciplined conciseness, so it earns only the minimum-viable score.
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 presence of an output schema relieves the description of explaining return values, but with zero annotations, 0% parameter coverage, and three ambiguous optional parameters, the description leaves far too much unresolved for an agent to invoke this tool confidently.
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 description coverage is 0% across three parameters (decision, namespace, candidate_id), and the description never references any of them. An agent cannot tell whether these are filters, selectors, or write targets, so the description fails to compensate for the documentation 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 names a verb ("Return") and enumerates the artifact types produced (decisions, risk findings, gaps, promotion plans), which is more specific than a tautology. However, it does not distinguish this tool from the many near-identical siblings such as recipes_mcp_connector_trust_pack, recipes_mcp_risk_coverage_pack, or recipes_agentic_app_intake_pack, and "intake pack" remains jargon an agent cannot map to a distinct operation.
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?
There is no when-to-use guidance, no prerequisites, and no mention of alternatives. With a sibling list containing several overlapping MCP connector packs, the absence of routing guidance is a real gap rather than a minor omission.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_connector_trust_packRecipes Mcp Connector Trust PackCInspect
Return MCP connector trust tiers, controls, evidence, and workflow namespace coverage.
| Name | Required | Description | Default |
|---|---|---|---|
| namespace | No | ||
| workflow_id | No | ||
| connector_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. 'Return' weakly implies a read-only report, but there is no disclosure of permissions, rate limits, side effects, or what scope the returned trust data covers.
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 definition is a single front-loaded sentence with no filler. It is appropriately terse, though its brevity contributes to under-specification rather than being a structural flaw in itself.
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?
An output schema is present, so return values need not be explained. However, with three undocumented input parameters, no annotations, and no usage guidance, the description is not complete enough for an agent to know how to scope or 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?
All three parameters (namespace, workflow_id, connector_id) have 0% schema description coverage, and the description does not explain what any of them filter or control. The phrase 'workflow namespace coverage' is output-oriented and does not compensate for the missing parameter semantics.
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 states a verb (Return) and a resource (MCP connector trust tiers, controls, evidence, workflow namespace coverage), but the purpose remains vague because the listed concepts are broad jargon and the tool is not differentiated from similar sibling trust packs such as recipes_mcp_connector_intake_pack or recipes_mcp_risk_coverage_pack.
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 offers no when-to-use guidance, no prerequisites, and no alternatives among the many sibling trust/connector tools. An agent must infer usage entirely from the tool name and one-sentence summary.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_elicitation_boundary_packRecipes Mcp Elicitation Boundary PackCInspect
Return MCP form-mode and URL-mode elicitation boundary evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | ||
| decision | No | ||
| risk_tier | No | ||
| profile_id | No | ||
| workflow_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It implies a read-style retrieval ('Return ... evidence') but never confirms it is read-only, does not describe permission requirements, filtering behavior, or whether results are deterministic versus environment-dependent.
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?
A single tight sentence with the verb leading and no filler. It is appropriately sized, though its brevity reflects under-specification rather than disciplined editing.
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?
An output schema exists, so return values need not be explained. But with no annotations, 5 undocumented optional parameters, and no indication of what 'evidence' comprises or how inputs scope it, the description leaves the agent without enough to invoke the tool confidently.
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 description coverage is 0% across 5 parameters. The description only loosely gestures at the 'mode' parameter via 'form-mode and URL-mode'; it adds nothing for decision, risk_tier, profile_id, or workflow_id, leaving their semantics entirely opaque.
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?
States a verb ('Return') and a resource ('MCP form-mode and URL-mode elicitation boundary evidence'), which is more specific than the bare name. However, it does not differentiate this pack from the dozens of sibling '*_pack' recipes, and 'boundary evidence' is jargon that an agent cannot map to a concrete artifact.
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?
No when-to-use, when-not-to-use, or alternative guidance is given. The agent cannot tell when this pack is preferable to recipes_agent_handoff_boundary_pack, recipes_context_egress_boundary_pack, or other boundary packs.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_gateway_policyRecipes Mcp Gateway PolicyCInspect
Return generated MCP gateway policy for scoped tool access and runtime controls.
| Name | Required | Description | Default |
|---|---|---|---|
| workflow_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, and it discloses almost nothing: it does not say whether the tool generates or merely retrieves a policy, whether it requires authorization, whether it is read-only or has side effects, or how errors/empty results behave.
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?
A single efficient sentence with the resource front-loaded and no filler. It is appropriately short, though its brevity reflects under-specification rather than economy of well-chosen detail.
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?
An output schema exists, so return values need not be described. But with no annotations, no parameter documentation, and no usage context, the definition is too thin for an agent to confidently select or call this tool among its many siblings.
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 description coverage is 0% for the single parameter workflow_id, so the schema provides no meaning and the description supplies none either. It is unclear whether workflow_id scopes the policy, is optional context, or what null implies.
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 names a verb ('Return') and a resource ('generated MCP gateway policy for scoped tool access and runtime controls'), which is more than a tautology. However, it is ambiguous whether this generates a policy or merely fetches one, and it does nothing to distinguish itself from near-identical siblings such as recipes_mcp_tool_risk_contract or recipes_agentic_control_plane_blueprint.
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?
There is no guidance on when to call this tool, what precondition triggers it, or which sibling to use instead. With dozens of closely related MCP/agentic policy recipes available, the absence of any routing guidance leaves the agent guessing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_risk_coverage_packRecipes Mcp Risk Coverage PackCInspect
Return OWASP MCP and agentic-skill risk coverage mapped to generated evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| risk_id | No | ||
| risk_tier | No | ||
| source_id | No | ||
| standard_id | No | ||
| capability_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the behavioral burden, but 'Return' implies a read-only, side-effect-free operation and an output schema exists to describe results. The description says nothing about filtering behavior, defaults, or pagination, but it is not misleading.
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?
A single front-loaded sentence with no filler or redundancy — appropriately sized, though the brevity comes at the cost of the missing detail noted elsewhere.
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 output schema covers return values, so those need not be described, but six undocumented filter parameters, no usage guidance, and no annotations leave the definition substantially incomplete for invoking 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?
All six filter parameters (status, risk_id, risk_tier, source_id, standard_id, capability_id) have 0% schema description coverage and no enums, and the description explains none of them. It does not compensate for the coverage gap at all, leaving the agent to guess each filter's meaning and valid values.
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 gives a specific verb (Return) and a clearly named resource (OWASP MCP and agentic-skill risk coverage mapped to generated evidence), which is much more informative than a generic 'pack' label. However, it offers no differentiation from the many sibling '*_pack' tools such as recipes_agentic_assurance_pack or recipes_agentic_standards_crosswalk, so an agent cannot easily tell which pack to choose.
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?
There is no statement of when to use this tool, when not to, or which sibling it substitutes for. With dozens of near-identically named risk/assurance packs, the absence of routing guidance is a real gap.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_server_getRecipes Mcp Server GetBInspect
Return one publicly documented MCP server with official setup and safety guidance.
| Name | Required | Description | Default |
|---|---|---|---|
| server_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full disclosure burden. It usefully reveals that the returned record is 'publicly documented' and carries 'official setup and safety guidance', which scopes the content, but says nothing about what happens when server_id is unknown or whether the call is cached/read-only.
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?
A single tight sentence with the resource and payload described up front and zero filler.
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?
An output schema exists, so return values need no explanation, and the description at least characterizes the payload. However, for a required lookup key at 0% schema coverage, the absence of any server_id semantics leaves an operational gap.
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 description coverage is 0% for the single required server_id parameter, so the description must compensate and does not. It never states whether server_id is a slug, UUID, or name, or any format/validity constraint.
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 gives a specific verb and resource: return one documented MCP server, along with its setup and safety guidance. The word 'one' implicitly distinguishes it from the plural list sibling (recipes_mcp_servers_list), though that sibling is never named.
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?
Usage is only implied by the singular 'one' versus the sibling list tool; there is no explicit statement of when to fetch a single server versus listing or searching. No prerequisites, lookup-key guidance, or error behavior are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_servers_listRecipes Mcp Servers ListCInspect
Search the bundled catalog of publicly documented MCP servers and ecosystems.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | ||
| availability | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It hints that the catalog is 'bundled' and 'publicly documented' (i.e., not live/dynamic), which is modest useful context, but it says nothing about pagination behavior, default ordering, rate limits, or result size limits. For a search tool with zero annotation coverage this is a significant gap.
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?
A single tight sentence with the key resource front-loaded and zero filler. It is appropriately sized, though it omits content that would earn its place (usage routing, parameter 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?
An output schema exists, so return values needn't be described, and the core purpose is conveyed. But for a three-parameter search tool with no annotations and no parameter documentation, the definition leaves selection ambiguity against sibling tools and the semantics of its own inputs unaddressed. Adequate only in the most minimal sense.
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 description coverage is 0% and the tool has three parameters (limit, query, availability) that are entirely undocumented in the schema. The description mentions no parameter semantics at all — not what 'query' matches on, not what values 'availability' accepts, not how 'limit' behaves. With low coverage the description must compensate, and it does not.
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?
States a specific verb ('Search') and resource ('bundled catalog of publicly documented MCP servers and ecosystems'), which is clearer than a bare name restatement. It does not, however, distinguish this list/search tool from nearby siblings such as recipes_mcp_server_get or recipes_mcp_upstream_servers, leaving the agent to infer the difference. Clear purpose, no sibling differentiation.
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 offers no guidance on when to use this tool versus alternatives. With siblings like recipes_mcp_server_get (detail lookup) and recipes_mcp_upstream_servers (live upstream) present, an agent gets no signal about which to pick. Nothing is stated about the bundled/static nature being the differentiator.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_stdio_launch_boundary_packRecipes Mcp Stdio Launch Boundary PackCInspect
Return MCP STDIO launch boundaries, profiles, decisions, and evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| launch_id | No | ||
| profile_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, and it discloses almost nothing. "Return" implies a read operation, but there is no mention of whether this is read-only, what permissions or inputs are required, whether it mutates state, or how the profiles/decisions/evidence relate to each other.
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?
A single short sentence that leads with the verb and contains no filler or repetition. It is efficient, though its brevity reflects under-specification rather than disciplined conciseness.
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?
An output schema exists, so return-value explanation is not required, but for a tool with three undocumented optional filter parameters, no annotations, and many near-identical siblings, the description leaves too much unspecified for confident 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?
Schema description coverage is 0% across three optional parameters, and the description does not explain decision, launch_id, or profile_id at all. The names are partially self-evident, but there is no guidance on whether these are filters, how they combine, or what values are valid.
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 gives a specific verb ("Return") and a specific resource ("MCP STDIO launch boundaries, profiles, decisions, and evidence"), so an agent can tell what domain it touches. However, the enumerated nouns are jargon-undefined and there is no differentiation from the many adjacent boundary/risk packs (e.g. mcp_elicitation_boundary_pack, mcp_connector_intake_pack), leaving the exact scope ambiguous.
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?
There is no when-to-use guidance, no when-not-to-use, and no named alternative among the dozens of sibling recipes_* packs. The agent must infer applicability purely from the tool name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_tool_risk_contractRecipes Mcp Tool Risk ContractCInspect
Return MCP tool annotation, trust, and session-combination risk evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| namespace | No | ||
| risk_tier | No | ||
| workflow_id | No | ||
| connector_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. 'Return' implies a read, but the description says nothing about permissions, side effects, authentication, rate limits, or whether the tool is safe to call repeatedly.
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 a single front-loaded sentence with no filler or repetition. It is as concise as possible while still naming the operation and evidence domain.
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?
Although an output schema exists and reduces the need to describe return values, the definition remains incomplete for a five-parameter tool with many similar siblings. It does not explain when to use it, how to use the optional parameters, or how it differs from adjacent risk-contract tools.
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 schema has five optional parameters (decision, namespace, risk_tier, workflow_id, connector_id) with 0% schema description coverage. The description does not mention any of them, their expected values, or their filtering behavior, leaving parameter semantics entirely undocumented.
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 uses a clear verb ('Return') and names the specific evidence type ('MCP tool annotation, trust, and session-combination risk evidence'). However, it offers no differentiation from closely named siblings such as recipes_mcp_risk_coverage_pack or recipes_mcp_tool_surface_drift_pack, leaving overlap ambiguity.
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?
There is no when-to-use guidance, no conditions, and no named alternatives or exclusions. The description only states what it returns, so an agent must infer its placement among the many sibling risk tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_tool_surface_drift_packRecipes Mcp Tool Surface Drift PackCInspect
Return pinned MCP tool descriptions, schemas, annotations, and drift evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| namespace | No | ||
| tool_name | No | ||
| surface_id | No | ||
| source_kind | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full behavioral burden. It does not disclose whether this is a read-only operation, whether it requires authorization, how drift evidence is computed, pagination behavior, or any side effects. It only says what data is returned, leaving the operational profile largely opaque.
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 a single front-loaded sentence with no filler. It is appropriately concise, though its brevity contributes to under-specification elsewhere rather than being a structural flaw.
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 five parameters, no schema descriptions, no annotations, and no description-level parameter or usage guidance. Although an output schema exists and need not be explained in the description, the description is still not complete enough for an agent to invoke this tool correctly in a field of many similar MCP-related recipes.
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 schema has five parameters (decision, namespace, tool_name, surface_id, source_kind) with 0% description coverage. The description mentions none of them, so it adds no semantic guidance about what any parameter controls or how to combine them.
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 gives a specific verb and resource: it returns pinned MCP tool descriptions, schemas, annotations, and drift evidence. That is clearer than a tautology and tells an agent the tool is about MCP tool-surface drift. However, it does not distinguish this tool from nearby siblings such as recipes_mcp_tool_risk_contract or recipes_mcp_upstream_tools, so it falls short of a 5.
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 states only what is returned, not when to use this tool versus alternatives. There is no mention of prerequisites, exclusions, or sibling routing among the many recipes_* tools. An agent gets no clear usage guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_upstream_callRecipes Mcp Upstream CallCInspect
Call an allowed read-only tool on a configured upstream MCP server.
| Name | Required | Description | Default |
|---|---|---|---|
| arguments | No | ||
| server_id | Yes | ||
| tool_name | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description carries the full behavioral burden. It usefully discloses that only allowlisted read-only upstream tools can be invoked, but says nothing about error/permission behavior, how 'arguments' are forwarded or validated against the upstream schema, or rate/timeout limits.
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?
A single tight sentence with no wasted words, but it is under-specified rather than concise in a useful way.
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?
An output schema exists so return values need not be explained, but for a proxy-invocation tool with three undocumented parameters and zero annotations, the description omits argument passing, prerequisites, and failure semantics that an agent needs to call it 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?
Schema description coverage is 0% across three parameters, so the description must compensate and does not. It never explains server_id, tool_name, or the free-form arguments object, leaving the agent to guess how the upstream tool's inputs are passed.
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?
States a specific verb ('Call') and resource ('allowed read-only tool on a configured upstream MCP server'), which distinguishes it from sibling listers like recipes_mcp_upstream_tools and recipes_mcp_upstream_servers. It stops short of explicitly naming the alternative it complements, but an agent can infer the proxy/invocation role.
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?
'Allowed read-only' hints at a constraint but there is no when-to-use guidance, no statement of prerequisites (must the server be configured and the tool be allowlisted first?), and no routing against siblings such as recipes_mcp_upstream_tools or recipes_mcp_upstream_context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_upstream_contextRecipes Mcp Upstream ContextCInspect
Collect bounded context from configured upstream MCP servers for a remediation query.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| max_chars | No | ||
| server_ids | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. 'Bounded' is the only hint that output is size-limited, and nothing is said about which servers are queried, whether failures of one upstream abort the call, latency/rate considerations, or whether this is a read-only aggregation. The single sentence leaves the risk profile opaque.
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?
One compact sentence with the purpose front-loaded and no filler. It is not bloated, though it is arguably under-specified rather than concise-by-design.
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?
An output schema exists so return values need not be described, but everything else is missing: no annotation coverage, no parameter documentation, no upstream-selection behavior, and no differentiation from sibling tools. For a 3-parameter aggregation tool this is too thin to call safely.
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 description coverage is 0% across three parameters, so the description must compensate and does not. 'Bounded' loosely gestures at max_chars, 'configured upstream MCP servers' at server_ids, and 'remediation query' at query, but no parameter is named, given a format, or given defaults/behavior when null.
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 gives a specific verb (collect) and resource (bounded context from configured upstream MCP servers) plus a triggering scenario (remediation query), so the agent knows roughly what it returns. However, it never distinguishes itself from close siblings such as recipes_mcp_upstream_call, recipes_mcp_upstream_servers, or recipes_mcp_upstream_tools, leaving the agent to guess which upstream-facing tool to pick.
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 phrase 'for a remediation query' hints at the situation, but there is no explicit when-to-use, no when-not-to-use, and no named alternative among the four upstream siblings. An agent choosing between this and recipes_mcp_upstream_call gets no routing guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_upstream_serversRecipes Mcp Upstream ServersBInspect
List optional upstream MCP servers configured for this Security Recipes server.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden, but 'List' strongly implies a non-destructive read and 'optional ... configured' conveys that results may be empty. It still does not state read-only status explicitly, permissions, or anything about result size/pagination, so it adds only mild behavioral context.
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?
A single front-loaded sentence with no filler; every word contributes to identifying the resource and its scope.
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?
For a trivial 0-param list tool with an output schema, the description is adequate, but in a crowded sibling set (upstream_call, upstream_context, upstream_tools, servers_list) it fails to give the agent enough to route confidently. It is minimally viable but leaves a clear routing gap.
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 tool takes zero parameters, so there is nothing for the description to disambiguate; the baseline for a 0-param tool is 4.
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?
States a specific verb (List) and resource (optional upstream MCP servers configured for this Security Recipes server), which is clearer than most siblings. However, it does not differentiate itself from closely-named siblings like recipes_mcp_servers_list, recipes_mcp_upstream_tools, or recipes_mcp_upstream_context, leaving the agent to infer the boundary.
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 offers no when-to-use context, no prerequisites, and never names an alternative among the several upstream-related siblings. The agent must guess whether this or recipes_mcp_upstream_tools/context is the right call.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_mcp_upstream_toolsRecipes Mcp Upstream ToolsBInspect
List tools exposed by a configured upstream MCP server and show local allow decisions.
| Name | Required | Description | Default |
|---|---|---|---|
| server_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the behavioral burden. It does convey that this is a read/enumeration operation surfacing 'local allow decisions', which is useful policy context beyond a plain list. It stops short of stating read-only guarantees, auth requirements, or result shape.
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?
A single, front-loaded sentence with no filler; the core action and the extra 'allow decisions' output are stated efficiently. It is appropriately sized, though it packs two behaviors into one clause without elaboration.
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?
An output schema exists, so return values need not be explained. But with no annotations and an undocumented required server_id, the definition leaves the agent guessing on identifier semantics and on how this differs from the adjacent upstream_context/upstream_call tools.
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 required parameter (server_id) with 0% schema description coverage, and the description says nothing about what server_id is, where it comes from, or its expected format. The schema documents only its type, so the meaning of the identifier is left entirely to inference.
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 states a specific verb and resource: 'List tools exposed by a configured upstream MCP server', plus the extra behavior of showing local allow decisions. It is clearly distinguishable from recipes_mcp_upstream_call (which would invoke a tool), though it does not explicitly contrast with recipes_mcp_upstream_context or recipes_mcp_upstream_servers.
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?
Usage is implied by the phrasing ('list tools exposed by a configured upstream MCP server'), so an agent can infer this is the enumeration step for a given server_id. However, no explicit when-to-use, prerequisites, or named alternatives (e.g., upstream_context, upstream_call) are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_model_provider_routing_packRecipes Model Provider Routing PackCInspect
Return model-provider route profiles, workflow mappings, and required evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| model_id | No | ||
| route_id | No | ||
| risk_tier | No | ||
| provider_id | No | ||
| workflow_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It states what is returned but omits whether the operation is read-only, what permissions are needed, whether the output is cached or fresh, and any other operational traits.
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 a single front-loaded sentence with no wasted words. It is concise, but its extreme brevity leaves it underspecified for a tool with six unannotated parameters.
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?
An output schema exists, so the description need not explain return values in detail. However, with no annotations, no parameter descriptions, and no usage guidance, the definition is incomplete for helping an agent understand how to invoke this routing pack 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 schema has 6 parameters with 0% description coverage, and the description does not mention or explain any of them. Parameters such as decision, model_id, route_id, risk_tier, provider_id, and workflow_id are left entirely opaque, so the description fails to compensate 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 uses a specific verb ('Return') and names the resource types it produces: model-provider route profiles, workflow mappings, and required evidence. It does not, however, differentiate this tool from the many similarly named recipes_* sibling tools, so it falls short of the 5 level.
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 gives no indication of when to use this tool, when not to use it, or which sibling tool is the alternative. An agent has no routing guidance for selecting this pack over the other recipe packs.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_playbook_getRecipes Playbook GetCInspect
Get one complete remediation workflow, evidence, output, and Python contract.
| Name | Required | Description | Default |
|---|---|---|---|
| playbook_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. 'Get' implies a read, but nothing states whether this is read-only, requires authorization, or how it behaves on an unknown playbook_id. It notes the payload includes evidence and a Python contract, which is mildly informative, but the behavioral profile is essentially undisclosed.
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?
A single front-loaded sentence with no filler. It is dense but earns its length by listing the returned artifacts, though the noun pile ('evidence, output, and Python contract') is slightly opaque.
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?
An output schema exists so return values needn't be re-explained, but with a 0%-covered required parameter and no usage or behavioral guidance, the definition leaves key calling decisions unresolved for an otherwise simple single-item retrieval 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?
Schema coverage is 0% and the single required parameter playbook_id has no description anywhere. The description never explains what a playbook_id is, its format, or that it comes from recipes_playbooks_list, leaving the agent to guess how to supply it.
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?
States a specific verb (Get) and resource (one complete remediation workflow) and enumerates what comes back (evidence, output, Python contract). This differentiates it from recipes_playbooks_list and recipes_playbook_plan, though the term 'Python contract' is jargon that could confuse an agent.
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?
No guidance on when to call this vs recipes_playbooks_list (enumerate) or recipes_playbook_plan. The 'Get one complete...' phrasing implies retrieval of a single item, but no prerequisites, exclusions, or alternative-routing is stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_playbook_planRecipes Playbook PlanBInspect
Build a deterministic, read-only phase, gate, and evidence checklist for a finding.
| Name | Required | Description | Default |
|---|---|---|---|
| finding | No | ||
| playbook_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It usefully discloses that the output is 'deterministic' and 'read-only,' but it does not cover permissions, side effects, auth requirements, or other operational behavior an agent may need.
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?
A single, front-loaded sentence with no wasted words. It communicates the core action and output type efficiently, despite being terse elsewhere.
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?
Although an output schema exists and return values need not be explained, the description omits important context for a tool with a required playbook_id, an optional finding, and no annotations. It does not explain the required parameter or when to choose this tool, leaving significant gaps for correct 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?
Schema description coverage is 0%, so the description should compensate for undocumented parameters. It only alludes to 'a finding' and says nothing about the required 'playbook_id' parameter, leaving the required input's meaning unexplained.
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?
States a specific verb ('Build') and resource ('phase, gate, and evidence checklist') applied to a finding. The purpose is clear, but the description does not distinguish this tool from siblings such as recipes_playbook_get or recipes_match_finding, so it falls short of a 5.
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?
No when-to-use, prerequisites, or alternative-tool guidance is provided. The mention of 'for a finding' gives only an implicit hint of context, but an agent is left to infer when this tool should be selected over related playbook tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_playbooks_listRecipes Playbooks ListCInspect
List concise remediation playbook records, optionally filtered by query or category.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | ||
| category | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
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 implies a read-only listing operation and notes that records are 'concise,' but it does not disclose permissions, pagination behavior, or other operational traits beyond the basic list action.
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 a single front-loaded sentence with no wasted words. It states the main operation first and then appends the optional filters efficiently.
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?
An output schema exists, so return values need less explanation. Still, with no annotations and 0% schema description coverage, the description leaves important calling details unspecified, especially the limit parameter and how query/category filtering works.
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 description coverage is 0%, so the description must compensate. It mentions query and category filters, which helps for two parameters, but it omits the limit parameter entirely and does not explain matching behavior or filter syntax.
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 states a clear verb ('List') and resource ('concise remediation playbook records'), and it distinguishes the operation from single-record siblings like recipes_playbook_get. However, it does not explicitly differentiate itself from recipes_list or explain how playbook records relate to general recipes.
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 mentions optional filtering by query or category, but that is a parameter behavior rather than usage guidance. It does not say when to use this tool versus alternatives such as recipes_list, recipes_playbook_get, or recipes_playbook_plan.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_quality_reportRecipes Quality ReportCInspect
Summarize recipe quality tiers and list recipes missing world-class signals.
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | ||
| facet | No | ||
| limit | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
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 does not state that the operation is read-only, how 'limit' affects output size, how 'tier'/'facet' scope the report, or what happens when no filters are supplied; only 'summarize ... and list' is stated.
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?
A single front-loaded sentence with no filler. It is efficient, though the brevity borders on under-specification given the unexplained jargon and undocumented parameters.
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?
An output schema exists so return values need not be described, but with no annotations and three undocumented parameters, the definition leaves the agent without enough to call the tool correctly, especially for the tier/facet filters that clearly shape the report.
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?
All three parameters (tier, facet, limit) have 0% schema description coverage and no enums, so the schema is silent. The description hints that tiers exist and that some recipes lack 'signals', but never says what values tier/facet accept or what limit bounds, leaving the parameters effectively undocumented.
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?
Specific verbs ('summarize', 'list') on a specific resource ('recipe quality tiers', recipes missing signals), so an agent can tell it produces a quality report rather than an agentic-pack artifact like the many sibling recipes_* tools. The phrase 'world-class signals' is undefined jargon, but the overall purpose is legible.
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?
There is no statement of when to use this tool, when not to, or which alternative to prefer. With dozens of recipes_* siblings, some routing guidance would be valuable, and none is given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_refreshRecipes RefreshCInspect
Refresh the in-memory copy of recipes-index.json.
| Name | Required | Description | Default |
|---|---|---|---|
| force | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations at all, the description carries the full behavioral burden. It hints at a cache reload but does not disclose whether the operation mutates server state, whether it is safe/idempotent, what 'in-memory' means for persistence, or what happens concurrently with in-flight reads.
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?
A single terse sentence with the action and target front-loaded and no filler. It is efficient, though borderline under-specified rather than padded.
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?
An output schema exists so return values need not be explained, but for a one-parameter operation with no annotations and an undescribed 'force' flag, the description leaves too much unstated about prerequisites, side effects, and what 'force' changes.
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% and the single parameter 'force' is completely undocumented in both the schema and the description. The name suggests overriding a cache-validity check, but the description never confirms this or explains default-vs-forced behavior, so the key semantic is missing.
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?
States a specific verb (Refresh) and resource (the in-memory copy of recipes-index.json), which is enough to separate it from sibling reads like recipes_get, recipes_list and recipes_search. It stops short of explaining what a 'refresh' implies operationally (cache reload vs. re-indexing), so it is clear but not fully self-distinguishing.
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?
No guidance on when to call this versus the many sibling recipes_* tools, no preconditions (e.g. after the index file changes), and no mention of the alternative of simply querying live data. The agent is left to infer timing entirely.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_searchRecipes SearchCInspect
Full-text search over security-recipes documents.
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | ||
| agent | No | ||
| limit | No | ||
| query | Yes | ||
| facets | No | ||
| section | No | ||
| min_quality | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, and it discloses almost nothing beyond "full-text search". It does not explain ranking/relevance behavior, how tags, facets, section, agent, and min_quality refine results, default limits, or pagination behavior for what is clearly a filtered query tool.
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?
A single short sentence with no filler, so nothing is wasted. However, at this brevity for a 7-parameter tool it reads as under-specification rather than discipline.
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?
An output schema exists, so return formatting need not be explained, but with no annotations and no parameter documentation the definition is not complete enough for a tool with seven filter inputs. The agent cannot tell which filters are optional refinements versus required scoping.
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?
Seven parameters with 0% schema description coverage, and the description mentions none of them. Filtering semantics for tags, agent, facets, section, and min_quality are entirely undocumented in both structured fields and prose, so an agent has no basis for using them correctly.
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?
States a specific verb+resource combination ("full-text search over security-recipes documents"), which is more precise than a generic "search". An agent can distinguish it from retrieval siblings like recipes_get and recipes_list by the full-text nature, though the description does not name any alternative explicitly.
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?
There is no when-to-use guidance, no conditions that favor this over recipes_cve_search, recipes_list, or recipes_get, and no prerequisites. Usage is only implied by the word "search" in the name and description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_secure_context_attestation_packRecipes Secure Context Attestation PackCInspect
Return secure-context attestation subjects, verification policy, and recertification state.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| source_id | No | ||
| artifact_id | No | ||
| workflow_id | No | ||
| subject_type | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. 'Return' implies a read, but nothing is said about permissions, whether the pack aggregates upstream sources, freshness of the attestation data, or whether the result is a snapshot versus a live query. The one sentence adds almost no behavioral context beyond the verb.
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?
It is a single front-loaded sentence with no filler, which is efficient for this surface. The trade-off is that conciseness here shades into under-specification rather than disciplined brevity.
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?
An output schema exists, so return values need not be described, and that is the description's one area of relief. However, with five undocumented filter parameters and zero annotations, the definition is missing the filtering semantics and operational context an agent needs to invoke it 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?
Schema description coverage is 0% across five optional filters (status, source_id, artifact_id, workflow_id, subject_type), and the description never explains any of them. There is only a faint implicit link between 'attestation subjects'/'recertification state' and subject_type/status; the meaning and accepted values of the remaining three filters are undocumented.
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 uses a specific verb ('Return') with a concrete resource set: attestation subjects, verification policy, and recertification state. That is far more informative than the title alone, but it offers no differentiation from the many adjacent siblings such as recipes_secure_context_trust_pack, recipes_secure_context_evidence_contract, or recipes_critical_infrastructure_secure_context_pack.
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?
There is no statement of when to use this pack versus the other secure-context packs, nor any prerequisites, trigger conditions, or exclusions. The agent is left to infer usage entirely from the tool name and this one sentence.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_secure_context_buyer_diligence_briefRecipes Secure Context Buyer Diligence BriefCInspect
Return buyer and acquirer diligence evidence for the secure context layer.
| Name | Required | Description | Default |
|---|---|---|---|
| bet_id | No | ||
| status | No | ||
| buyer_id | No | ||
| source_id | No | ||
| question_id | No | ||
| objection_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. 'Return' implies a read, but nothing is said about permissions, scoping behavior, rate limits, or whether omitted filters widen the result set. For a 6-parameter tool with zero annotation coverage this is a real gap.
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?
One sentence, front-loaded with the verb and resource, no filler or restatement of the title. It is efficient, though its brevity is partly under-specification rather than true conciseness.
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?
An output schema exists, so return values need not be described, but the six undocumented filter parameters, absent annotations, and missing usage context leave the agent without what it needs to invoke this correctly against its many siblings.
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?
Six parameters (bet_id, status, buyer_id, source_id, question_id, objection_id) have 0% schema description coverage, and the description names none of them or explains how they filter the evidence. The definition adds no semantic value over the bare property names.
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?
States a specific verb ('Return') and a specific resource ('buyer and acquirer diligence evidence for the secure context layer'), which is enough to place it apart from generic secure-context siblings like value_model or lineage_ledger. It stops short of naming the sibling it is not, so it earns a 4 rather than a 5.
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?
There is no when-to-use, when-not-to-use, or alternative-tool guidance at all. With ~70 sibling recipes tools, the absence of any routing signal leaves the agent guessing between this and the attestation, proof, trust, and evidence-contract packs.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_secure_context_customer_proof_packRecipes Secure Context Customer Proof PackCInspect
Return the customer proof contract for design partner and acquisition evidence.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| gate_id | No | ||
| risk_id | No | ||
| claim_id | No | ||
| event_id | No | ||
| metric_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. 'Return' implies a read operation, but it does not disclose permissions, side effects, rate limits, filtering behavior, or what happens with optional parameters.
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?
It is a single front-loaded sentence with no wasted words, but it is too sparse for a tool with six filtering parameters. Brevity alone does not compensate for the missing operational context.
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?
Although an output schema exists and return values need not be described, the input side is critically underspecified: six parameters are undocumented in both schema and description. With no annotations and a dense sibling toolset, the description is not complete enough for reliable 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 schema has six optional parameters (status, gate_id, risk_id, claim_id, event_id, metric_id) with 0% description coverage, and the tool description does not explain any of them. The agent gets no meaning for how these IDs or status should be used.
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 uses a specific verb (Return) and names a resource (customer proof contract), but the resource is jargon-heavy and undefined. It does not distinguish this tool from many sibling secure-context/evidence/contract tools such as recipes_secure_context_evidence_contract or recipes_design_partner_pilot_pack.
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?
It mentions design partner and acquisition evidence, which gives an implied context, but offers no explicit when-to-use, when-not-to-use, prerequisites, or alternative tools. An agent would have to guess whether this is the right pack among dozens of similar recipes_* tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_secure_context_eval_packRecipes Secure Context Eval PackCInspect
Return scenario-backed secure-context evals for retrieval, attestation, egress, and handoffs.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| scenario_id | No | ||
| workflow_id | No | ||
| minimum_score | No | ||
| scenario_type | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. 'Return' implies a read-only operation, but the description does not disclose any behavioral traits such as authentication requirements, rate limits, side effects, or whether results are cached or generated. It adds minimal context beyond the name.
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 a single, front-loaded sentence with no wasted words. It is appropriately concise, though its brevity contributes to the overall under-specification captured in other dimensions.
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 five undocumented parameters, no annotations, and no parameter descriptions in the schema, the description is not complete enough to guide correct invocation. While an output schema exists (so return values need not be explained), the input side is entirely opaque.
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 five parameters (decision, scenario_id, workflow_id, minimum_score, scenario_type) with 0% description coverage. The description does not mention any parameter or provide meaning, format, or filtering semantics for them, leaving an agent unable to infer how to use them correctly.
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 has a specific verb and resource ('Return scenario-backed secure-context evals') and names four domains (retrieval, attestation, egress, handoffs), which distinguishes it from sibling packs that focus on a single domain. However, it does not explicitly differentiate itself from other 'eval' or 'pack' siblings, and 'secure-context evals' remains somewhat jargon-heavy without further explanation.
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?
There is no guidance on when to use this tool versus alternatives. It does not mention prerequisites, appropriate contexts, or any of the many similar sibling tools (e.g., recipes_secure_context_attestation_pack, recipes_agent_handoff_boundary_pack) that an agent might otherwise consider.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_secure_context_evidence_contractRecipes Secure Context Evidence ContractDInspect
Return the secure context evidence API and release contract.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| channel_id | No | ||
| artifact_id | No | ||
| endpoint_id | No | ||
| object_type_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. "Return" weakly implies a read-only operation, but nothing is said about authentication requirements, scope of the contract, rate limits, or side effects. It adds almost no behavioral context.
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?
It is a single front-loaded sentence with no filler, so it is structurally tight. However, the brevity is a symptom of under-specification rather than disciplined concision, since no usable detail is conveyed.
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?
An output schema exists, so return values need not be documented. But with five undocumented optional parameters, no annotations, and no behavioral or usage detail, the definition is far too thin for an agent to invoke it confidently or distinguish it from its many siblings.
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 description coverage is 0% across five filters (status, channel_id, artifact_id, endpoint_id, object_type_id), and the description explains none of them. It leaves the agent with no idea how these filters constrain or shape the returned contract.
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?
"Return the secure context evidence API and release contract" essentially restates the tool name (Secure Context Evidence Contract) with a generic verb. It does not distinguish, or even hint at the distinction, between this tool and the many sibling recipes_secure_context_* tools (attestation pack, lineage ledger, trust pack, value model, eval pack). An agent cannot infer what unique artifact this returns.
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?
There is no when-to-use guidance, no prerequisites, and no mention of alternative tools. With roughly ten closely named secure-context siblings, the absence of any routing signal is a serious gap.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_secure_context_lineage_ledgerRecipes Secure Context Lineage LedgerCInspect
Return context lineage, reuse policy, stage requirements, hashes, and workflow envelopes.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| stage_id | No | ||
| source_id | No | ||
| reuse_class | No | ||
| workflow_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden, but it says nothing about read-only semantics, authorization requirements, pagination, or what scoping constraints apply. It only implies a read via 'Return', leaving the behavioral profile essentially undisclosed.
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?
It is a single front-loaded sentence with no filler, which is structurally clean. But the terseness tips into under-specification rather than tight conciseness for a five-parameter tool.
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?
An output schema exists, so return values need not be explained, but with zero annotation coverage and five undocumented parameters the description is far too thin to let an agent invoke this correctly. It does not compensate for the structured-data gaps.
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?
All five parameters have 0% schema description coverage with no enums or required fields. The description's nouns (reuse policy, stage requirements, workflow envelopes) hint at reuse_class, stage_id, and workflow_id, but 'decision' and 'source_id' are unaddressed and no formats, defaults, or filtering semantics are explained.
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 verb ('Return') and a list of resources (lineage, reuse policy, stage requirements, hashes, workflow envelopes) are present, so the tool is identifiable as a ledger lookup. However, the payload terms are internal jargon and nothing distinguishes it from the many sibling 'secure_context'/'agentic' pack tools, so an agent cannot reliably tell it apart from neighbors.
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?
No when-to-use context, no prerequisites, and no named alternatives are given despite dozens of overlapping sibling tools. Usage is only implied by the retrieval verb.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_secure_context_trust_packRecipes Secure Context Trust PackCInspect
Return context provenance, retrieval policy, source hashes, and workflow context packages.
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | ||
| source_id | No | ||
| trust_tier | No | ||
| workflow_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It implies a read-only retrieval, but says nothing about permissions, filtering behavior of the four optional inputs, pagination, or whether the returned packages are snapshots or live data.
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?
A single front-loaded sentence with no filler, which is structurally sound. The problem is underspecification rather than verbosity — the sentence is too thin to anchor a four-parameter tool.
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?
An output schema exists, so return shape need not be described. But with no annotations, 0% parameter coverage, and no usage guidance for a tool surrounded by near-identical siblings, the definition is not complete enough for confident 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?
Schema description coverage is 0% across four parameters (decision, source_id, trust_tier, workflow_id), and the description does not explain any of them. At best, 'source hashes' and 'workflow context packages' loosely gesture at source_id and workflow_id, leaving decision and trust_tier entirely undefined.
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 names a verb ('Return') and lists the kinds of content produced: context provenance, retrieval policy, source hashes, and workflow context packages. However, the boundary against close siblings such as recipes_secure_context_attestation_pack, recipes_secure_context_lineage_ledger, and recipes_secure_context_evidence_contract is not drawn, so an agent cannot readily tell which pack to pick.
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?
There is no statement of when to use this tool, when not to, or which alternative to prefer among the many recipes_secure_context_* and recipes_*_pack siblings. Usage can only be inferred from the noun list in the description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_secure_context_value_modelRecipes Secure Context Value ModelCInspect
Return the secure context value model for buyer, ROI, and acquisition diligence.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| wedge_id | No | ||
| driver_id | No | ||
| segment_id | No | ||
| question_id | No | ||
| scenario_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It says nothing about permissions, side effects, rate limits, or how the optional filters interact, which for a 6-parameter tool with zero annotation coverage is a substantial gap.
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?
A single front-loaded sentence with no waste, but its brevity reflects under-specification rather than efficiency given six undocumented parameters and no usage guidance.
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 output schema covers return values, so the description needn't explain those. But with no annotations and zero parameter coverage, the description leaves the agent without the behavioral and filtering context needed to invoke this 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?
Schema description coverage is 0% across 6 parameters (status, wedge_id, driver_id, segment_id, question_id, scenario_id). The description does not mention or explain any of them, so an agent gets no meaning for these filters from the text and must infer everything from parameter names alone.
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?
States a verb ('Return') and a resource ('secure context value model') and scopes it to buyer, ROI, and acquisition diligence. However, 'value model' is domain jargon that doesn't clearly distinguish this from siblings like recipes_secure_context_buyer_diligence_brief or recipes_secure_context_trust_pack, leaving the agent to guess the difference.
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?
No when-to-use guidance, no prerequisites, and no mention of alternatives. The mention of 'buyer, ROI, and acquisition diligence' implies a context but gives no condition for selecting this over the many sibling secure-context tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_server_infoRecipes Server InfoBInspect
Return MCP server metadata and source-index configuration.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full behavioral burden. It says only that metadata and configuration are returned, but does not state read-only nature, side effects, authentication requirements, or rate limits.
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 a single front-loaded sentence with no filler. Every word contributes to stating what is returned.
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 is simple, has no parameters, and has an output schema, so return-value details need not be repeated. However, with no annotations and no sibling differentiation, the description leaves the agent with minimal context for choosing this tool over related MCP server tools.
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 tool takes no parameters, so there are no parameter semantics to explain. The baseline for zero-parameter tools is 4, and the description appropriately does not waste space on nonexistent inputs.
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 states a specific verb and resource: 'Return MCP server metadata and source-index configuration.' It is clear what the tool does, but it does not distinguish itself from closely related siblings such as recipes_mcp_server_get or recipes_mcp_servers_list.
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?
There is no explicit when-to-use guidance, no conditions, and no alternatives named. An agent must infer that this tool is for reading the recipes server's own metadata rather than querying an external MCP server.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
recipes_workflow_control_planeRecipes Workflow Control PlaneCInspect
Return workflow control-plane policy for agents, reviewers, and MCP gateways.
| Name | Required | Description | Default |
|---|---|---|---|
| workflow_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It implies a read via 'Return' but discloses nothing about permissions, auth needs, rate limits, or what the returned policy actually contains. For a zero-annotation tool this is a significant gap.
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?
A single front-loaded sentence with no waste, but its brevity comes at the cost of under-specification rather than economy. Appropriate length is not the same as sufficient structure here.
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?
An output schema exists, so return values are partly covered, but for a zero-annotation policy tool the description omits workflow_id semantics and any behavioral or usage context. It leaves an agent without the information needed 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?
The single workflow_id parameter has 0% schema description coverage, and the description never mentions it or its optional/null-default semantics. An agent gets no indication of whether workflow_id scopes the result or what happens when it is omitted.
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?
States a verb (Return) and a resource (workflow control-plane policy), which is enough to know it's a read tool. However, 'control-plane policy' is vague, and the description does nothing to distinguish it from close siblings like recipes_mcp_gateway_policy or recipes_agentic_control_plane_blueprint.
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?
No when-to-use, when-not-to-use, or alternative guidance is provided. The audience list ('agents, reviewers, and MCP gateways') hints at context but does not tell an agent when to pick this tool over its many siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
75 tool updates
- First observed
recipes_a2a_agent_card_trust_profile - First observed
recipes_agent_capability_risk_register - First observed
recipes_agent_handoff_boundary_pack - First observed
recipes_agent_identity_ledger - First observed
recipes_agent_memory_boundary_pack - First observed
recipes_agent_skill_supply_chain_pack - First observed
recipes_agent_trust_fabric_pack - First observed
recipes_agentic_action_runtime_pack - First observed
recipes_agentic_aivss_risk_scoring_pack - First observed
recipes_agentic_app_intake_pack - First observed
recipes_agentic_approval_receipt_pack - First observed
recipes_agentic_assurance_pack - First observed
recipes_agentic_catastrophic_risk_annex - First observed
recipes_agentic_control_plane_blueprint - First observed
recipes_agentic_entitlement_review_pack - First observed
recipes_agentic_exposure_graph - First observed
recipes_agentic_incident_response_pack - First observed
recipes_agentic_measurement_probe_pack - First observed
recipes_agentic_posture_snapshot - First observed
recipes_agentic_protocol_conformance_pack - First observed
recipes_agentic_readiness_scorecard - First observed
recipes_agentic_red_team_drill_pack - First observed
recipes_agentic_red_team_replay_harness - First observed
recipes_agentic_run_receipt_pack - First observed
recipes_agentic_soc_detection_pack - First observed
recipes_agentic_source_freshness_watch - First observed
recipes_agentic_standards_crosswalk - First observed
recipes_agentic_system_bom - First observed
recipes_agentic_telemetry_contract - First observed
recipes_agentic_threat_radar - First observed
recipes_browser_agent_boundary_pack - First observed
recipes_context_egress_boundary_pack - First observed
recipes_context_poisoning_guard_pack - First observed
recipes_critical_infrastructure_secure_context_pack - First observed
recipes_cve_catalog_info - First observed
recipes_cve_get - First observed
recipes_cve_search - First observed
recipes_design_partner_pilot_pack - First observed
recipes_enterprise_trust_center_export - First observed
recipes_get - First observed
recipes_hosted_mcp_readiness_pack - First observed
recipes_list - First observed
recipes_match_finding - First observed
recipes_mcp_authorization_conformance_pack - First observed
recipes_mcp_connector_intake_pack - First observed
recipes_mcp_connector_trust_pack - First observed
recipes_mcp_elicitation_boundary_pack - First observed
recipes_mcp_gateway_policy - First observed
recipes_mcp_risk_coverage_pack - First observed
recipes_mcp_server_get - First observed
recipes_mcp_servers_list - First observed
recipes_mcp_stdio_launch_boundary_pack - First observed
recipes_mcp_tool_risk_contract - First observed
recipes_mcp_tool_surface_drift_pack - First observed
recipes_mcp_upstream_call - First observed
recipes_mcp_upstream_context - First observed
recipes_mcp_upstream_servers - First observed
recipes_mcp_upstream_tools - First observed
recipes_model_provider_routing_pack - First observed
recipes_playbook_get - First observed
recipes_playbook_plan - First observed
recipes_playbooks_list - First observed
recipes_quality_report - First observed
recipes_refresh - First observed
recipes_search - First observed
recipes_secure_context_attestation_pack - First observed
recipes_secure_context_buyer_diligence_brief - First observed
recipes_secure_context_customer_proof_pack - First observed
recipes_secure_context_eval_pack - First observed
recipes_secure_context_evidence_contract - First observed
recipes_secure_context_lineage_ledger - First observed
recipes_secure_context_trust_pack - First observed
recipes_secure_context_value_model - First observed
recipes_server_info - First observed
recipes_workflow_control_plane
Related MCP Connectors
CVE, KEV, EPSS, SBOM and advisory lookups; per-CVE exposure from Shodan data (© Shodan). Keyless.
Threat intel + your scans/findings/Shield posture. CVE, EPSS, KEV, package vuln lookup, DAST.
CVE intelligence: exploitation (KEV/EPSS), detection coverage, fixed versions, CPE configurations.
Live threat intel for agents: incidents, actors, CVEs with KEV/EPSS, ransomware leak-site victims.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceProvides keyless, read-only access to CISA KEV, SSVC, and full ICS advisory corpus, letting users check CVE statuses, compute BOD 26-04 remediation timelines, and search advisories by vendor, product, CVE, CVSS, or sector.414 npm1Apache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides unified access to vulnerability data from NVD, MITRE, and GitHub Security Advisories for cybersecurity intelligence.19 npm19MIT
- AlicenseNot gradedqualityCmaintenanceEnables CVE lookups and risk assessment by integrating CISA Known Exploited Vulnerabilities (KEV) data and CVSS metrics. It helps users prioritize patching efforts by ranking vulnerabilities based on exploitation status and calculated risk scores.MIT
- AlicenseNot gradedqualityFmaintenanceProvides CVE search enriched with EPSS exploit likelihood and CISA KEV status, plus live IP/domain reputation and a real-time threat feed for AI agents.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.