scale_recipe
Recipe scaler client and server side from freedailypro
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ingredients | Yes | ||
| targetServings | Yes | ||
| originalServings | Yes |
Recipe scaler client and server side from freedailypro
| Name | Required | Description | Default |
|---|---|---|---|
| ingredients | Yes | ||
| targetServings | Yes | ||
| originalServings | Yes |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, openWorld=false, and non-destructive, so the safety profile is covered structurally. The description adds nothing beyond that profile – no mention of output format, rounding behavior, or unit handling. The trailing vendor phrase is pure noise, not behavioral 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?
It is short but not concise in the useful sense: a single fragment with no front-loaded statement of action, and it spends words on irrelevant vendor provenance rather than function. Nothing here earns its place.
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 3-required-param tool with no output schema, no enums, and 0% schema description coverage, the description is far too thin. It omits what the tool returns (scaled ingredient list?), any rounding/unit rules, and any parameter explanation, leaving the agent unable to call it correctly on the basis of documentation alone.
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 three parameters are required, so the description carries the full documentation burden – yet it says nothing about ingredients, originalServings, or targetServings. The nested ingredient shape (name/unit/amount) and the meaning of target vs original servings are completely 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 is essentially a restatement of the name/title ('Recipe scaler' for scale_recipe) plus irrelevant vendor noise ('client and server side from freedailypro'). It never states a proper verb or clarifies what scaling means (that ingredient amounts are recomputed from originalServings to targetServings). An agent gets no more than it could infer from the tool 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 prerequisites, and no routing to any sibling (e.g. planning_grocery_list). 'client and server side' hints at an execution context but is not actionable guidance. No alternative or exclusion is offered.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.