Skip to main content
Glama

Get a use case recipe

get_use_case
Read-only

Full recipe for one use case id: source credit, what they did, result as claimed, every named tool, cost note, setup time, difficulty, step-by-step setup and a copyable setup prompt for Claude Code, Codex or Grok Bot.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYesUse case id from search_use_cases, latest_use_cases or use_cases_by_tool.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so safety is covered and the bar is lower. The description earns credit by disclosing the exact return payload (setup time, difficulty, step-by-step instructions, copyable prompt), which is genuinely useful since there is no output schema. It does not mention behavior on an unknown/stale id, which keeps it from a 5.

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

Conciseness4/5

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

A single dense sentence that front-loads the core fact ('full recipe for one use case id') and then lists the payload. Every item listed is informative, though the trailing enumeration is a long run-on that could be trimmed slightly.

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

Completeness4/5

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

With no output schema and only one required parameter, the description does the necessary work of describing what comes back, which is the main completeness risk for a detail-lookup tool. What remains missing is minor: failure mode for an invalid id and any sense of response size.

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

Parameters3/5

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

Schema description coverage is 100% for the single id parameter, so the schema already documents both the type and where the id comes from. The description only restates that the input is one use case id, adding no format details (e.g. id shape) beyond the schema. Baseline 3 applies.

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

Purpose5/5

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

States a specific verb (retrieve the full recipe) and resource (one use case id) and enumerates the exact contents returned: source credit, claimed result, named tools, cost note, difficulty, step-by-step setup. This clearly separates it from the sibling list/search tools, which return collections rather than a single full detail record.

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

Usage Guidelines3/5

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

Usage is only implied: the 'one use case id' phrasing and the id parameter's provenance note signal that this is the detail-follow-up to a list/search call, but that provenance lives in the schema rather than the description. There is no explicit when-to-use/ when-not-to-use statement or named alternative inside the description text.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources