Skip to main content
Glama
mcp-ptitchef

mcp-ptitchef

Read one recipe

get_recipe
Read-onlyIdempotent

Read a Ptitchef recipe by ID to get its ingredients, method, times, rating, nutrition and estimated cost; pass a serving count to rescale ingredients.

Instructions

Read one Ptitchef recipe: its ingredients, method, times, rating, nutrition and the cost the site estimates for it. Pass the 'id' of a row from search_recipes, browse_recipes or search_by_ingredients. Give 'servings' to rescale the ingredients, and read each line's 'scaling' before quoting a quantity: 'scaled' is exact arithmetic, 'rounded' was moved to stay usable, and 'unscaled' carries nothing that could be multiplied. A time or a figure the site publishes none of comes back null, never zero.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id": "<id>"
    },
    "name": "get_recipe"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYesThe 'id' of a row from a search or a listing, which is the recipe's own page path.
servingsNoRescale the ingredients to this many servings. Left out, the ingredients come back as published.

Output Schema

NameRequiredDescriptionDefault
idYes
faqYes
urlYesThe public page. Show this when citing the recipe.
notesYesWhat qualifies this answer: what the arithmetic did, what it could not do, and what the site states rather than this server. Read these before quoting a quantity or a cost.
stepsYesThe method, one line per step, in the shape every source of recipes publishes it in. 'illustrated_steps' carries the same lines beside the photograph the site took of each.
titleYes
yieldYes
authorYes
ratingYes1 to 5, as the site states it.
sourceYesThe site this recipe was read from. Credit it when showing it.
cuisineYes
categoryYes
keywordsYes
modifiedYes
image_urlYes
nutritionYesAs published, per the serving size it names.
publishedYes
author_urlYes
difficultyYesThe site's own wording, such as 'facile'.
attributionYes
descriptionYes
ingredientsYesThe lines as published where no servings were asked for, in which case 'yield.factor' is null and each line's 'scaling' describes no arithmetic. Pass 'servings' to rescale them.
cook_minutesYes
prep_minutesYes
rating_countYes
review_countYes
translationsYesThe other languages this recipe was published in, which get_recipe_translations answers on its own for a caller who wants nothing else.
total_minutesYes
estimated_costYesWhat the site estimates the ingredients cost, with the currency it names. Repeated as published: it is the site's figure and readers of the site dispute it.
illustrated_stepsYes
steps_are_one_blockYesTrue when the site published its method as one block of prose, so the single step above is that block rather than the first of several.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed39 schema fields changedv1.1.0
    • removedOutput schema / properties / author / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / author / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / author_url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / author_url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / category / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / category / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / cuisine / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / cuisine / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / description / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / description / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / difficulty / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / difficulty / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / estimated_cost / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / estimated_cost / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / illustrated_steps / items / properties / image_url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / illustrated_steps / items / properties / image_url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / image_url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / image_url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / ingredients / items / properties / amount / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / ingredients / items / properties / amount / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / ingredients / items / properties / amount_max / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / ingredients / items / properties / amount_max / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / ingredients / items / properties / unit / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / ingredients / items / properties / unit / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / modified / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / modified / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / nutrition / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "calories": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "carbohydrate": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "fat": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "fibre": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "protein": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "saturated_fat": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "serving_size": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "The serving the figures below describe."
      -      },
      -      "sodium": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "sugar": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "serving_size",
      -      "calories",
      -      "carbohydrate",
      -      "fat",
      -      "saturated_fat",
      -      "protein",
      -      "fibre",
      -      "sugar",
      -      "sodium"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "calories": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "carbohydrate": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "fat": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "fibre": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "protein": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "saturated_fat": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "serving_size": {
      +        "description": "The serving the figures below describe.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "sodium": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "sugar": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "serving_size",
      +      "calories",
      +      "carbohydrate",
      +      "fat",
      +      "saturated_fat",
      +      "protein",
      +      "fibre",
      +      "sugar",
      +      "sodium"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / published / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / published / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / rating / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / rating / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / yield / properties / factor / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / yield / properties / factor / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / yield / properties / original_count / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / yield / properties / original_count / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / yield / properties / original_text / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / yield / properties / original_text / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / yield / properties / unit / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / yield / properties / unit / type
      Added value: +[
      +  "string",
      +  "null"
      +]
  2. First observedv1.0.0

TDQS

A4.5/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, openWorld and non-destructive, so safety is covered. The description adds real behavioral context beyond that: missing times or figures return null rather than zero, and each ingredient line carries a 'scaling' marker ('scaled' = exact, 'rounded' = adjusted, 'unscaled' = not multiplicable) that must be checked before quoting a quantity. That is genuine interpretation guidance, though it does not cover error behavior for an invalid id.

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

Conciseness5/5

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

Three dense sentences, all front-loaded: purpose first, then id provenance and the servings control, then the output-interpretation caveats. No sentence restates the name or duplicates the schema verbatim, and nothing could be removed without losing a distinct instruction.

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

Completeness5/5

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

An output schema exists, so return-field definitions need not be restated, and the description instead supplies the two things an agent would otherwise get wrong: how to interpret 'scaling' per ingredient line and why a value may be null instead of zero. For a two-parameter, single-record read tool, nothing an agent needs in order to call and correctly interpret it is missing.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, and the description adds modest but real value: it explains that 'id' should come from one of three named search/list tools and that 'servings' rescales the ingredient list rather than the whole record. It does not extend beyond the schema on the default-equivalent behavior of omitted 'servings', which the schema already states.

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?

The description opens with a specific verb and resource ('Read one Ptitchef recipe') and immediately enumerates what comes back: ingredients, method, times, rating, nutrition, estimated cost. It also names the sibling search tools that produce the required id, so an agent can distinguish this single-item read from the sibling list/search tools without opening any schema.

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

Usage Guidelines4/5

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

It states the precondition clearly: pass the 'id' of a row from search_recipes, browse_recipes or search_by_ingredients, which establishes the intended call sequence. It also explains when to supply 'servings'. There is no explicit exclusion (e.g., a case where you should call get_recipe_translations instead), so it stops short of a full when/when-not guide.

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