mcp-marmiton

Get a recipe

get_recipe

Read-onlyIdempotent

Retrieve a Marmiton recipe with ingredients, steps, times, category, rating, and nutrition. Rescale quantities to any serving size, with clear handling of scaled or rounded amounts.

Instructions

Read one Marmiton recipe: ingredients, steps, times, category, rating and nutrition. Give the id returned by search_recipes, or a marmiton.org recipe URL. Set 'servings' to rescale the quantities. Each ingredient reports how it was handled: 'scaled' when the arithmetic came out exact, which a count of eggs, spoons or pinches reaches as readily as a mass in grams, 'rounded' when the value had to be moved to stay usable, and 'unscaled' for lines carrying no quantity at all. Trust that flag rather than recomputing: the point of scaling here is to avoid answers like '2.4 eggs'. Recipes yielding pieces rather than servings are rescaled the same way; check 'yield' to see which. Always cite 'attribution' when showing a recipe to a user.

Input Schema

TableJSON Schema

Name	Required	Description
`id`	No	Marmiton recipe id, as returned by search_recipes. Preferred over 'url'.
`url`	No	Full marmiton.org recipe URL. Only marmiton.org is accepted. Ignored when 'id' is given.
`servings`	No	Rescale the ingredients to this many servings. Omit to get the recipe exactly as published.

Output Schema

TableJSON Schema

Name	Required	Description
`id`	Yes
`url`	Yes
`notes`	Yes
`steps`	Yes
`title`	Yes
`yield`	Yes
`author`	Yes
`rating`	Yes
`source`	Yes
`category`	Yes
`nutrition`	Yes	Nutrition is given for the recipe as published, not rescaled.
`attribution`	Yes
`ingredients`	Yes
`cook_minutes`	Yes
`prep_minutes`	Yes
`total_minutes`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed20 schema fields changedv2.1.0Sep 11, 2026

removedOutput schema / properties / author / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / author / 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 / 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 / amountMax / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / ingredients / items / properties / amountMax / 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"
+]
```

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"
-          }
-        ]
-      },
-      "fiber": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "protein": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "serving_size": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "sodium": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "calories",
-      "protein",
-      "fat",
-      "carbohydrate",
-      "fiber",
-      "sodium",
-      "serving_size"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "calories": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "carbohydrate": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "fat": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "fiber": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "protein": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "serving_size": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "sodium": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "calories",
+      "protein",
+      "fat",
+      "carbohydrate",
+      "fiber",
+      "sodium",
+      "serving_size"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / rating / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "best": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "count": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "value": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "value",
-      "count",
-      "best"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "best": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "count": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "value": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "value",
+      "count",
+      "best"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "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 / requested / anyOf

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / yield / properties / requested / type
```
Added value: +[
+  "number",
+  "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"
+]
```

Changed23 schema fields changedAug 21, 2026

addedOutput schema / properties / author / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / author / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

addedOutput schema / properties / category / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / category / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

changedOutput schema / properties / cook_minutes / anyOf

Previous value: -[
-  {
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / ingredients / items / properties / amount / anyOf

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / ingredients / items / properties / amount / type
```
Removed value: -[
-  "number",
-  "null"
-]
```
addedOutput schema / properties / ingredients / items / properties / amountMax / anyOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / ingredients / items / properties / amountMax / type
```
Removed value: -[
-  "number",
-  "null"
-]
```

addedOutput schema / properties / ingredients / items / properties / unit / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / ingredients / items / properties / unit / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

changedOutput schema / properties / nutrition / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "calories": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "carbohydrate": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "fat": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "fiber": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "protein": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "serving_size": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "sodium": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "calories",
-      "protein",
-      "fat",
-      "carbohydrate",
-      "fiber",
-      "sodium",
-      "serving_size"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "calories": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "carbohydrate": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "fat": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "fiber": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "protein": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "serving_size": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "sodium": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "calories",
+      "protein",
+      "fat",
+      "carbohydrate",
+      "fiber",
+      "sodium",
+      "serving_size"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / prep_minutes / anyOf

Previous value: -[
-  {
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / rating / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "best": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "count": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "value": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "value",
-      "count",
-      "best"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "best": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "count": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "value": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "value",
+      "count",
+      "best"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / total_minutes / anyOf

Previous value: -[
-  {
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / yield / properties / factor / anyOf

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / yield / properties / factor / type
```
Removed value: -[
-  "number",
-  "null"
-]
```

addedOutput schema / properties / yield / properties / original_count / anyOf

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / yield / properties / original_count / type
```
Removed value: -[
-  "number",
-  "null"
-]
```

addedOutput schema / properties / yield / properties / requested / anyOf

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / yield / properties / requested / type
```
Removed value: -[
-  "number",
-  "null"
-]
```

addedOutput schema / properties / yield / properties / unit / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / yield / properties / unit / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

Changed3 schema fields changedv1.7.0Aug 7, 2026

addedOutput schema / properties / ingredients / items / properties / amountMax

Added value: +{
+  "description": "Upper bound when the line gives a range, as in '200 à 300 g', with 'amount' holding the lower one. Null when the line states a single amount.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

changedOutput schema / properties / ingredients / items / properties / scaling / description

Previous value: -"'scaled' means the arithmetic came out exact, which a count reaches as readily as a mass: one pinch multiplied by six is six pinches. 'rounded' means the value had to be moved to stay usable, to a whole or half unit or to a step a scale can show. 'unscaled' was left alone, because the line carries no quantity."New value: +"'scaled' means the arithmetic came out exact, which a count reaches as readily as a mass: one pincée multiplied by six is six pincées. 'rounded' means the value had to be moved to stay usable, to a whole or half unit or to a step a scale can show. 'unscaled' was left as published, because nothing on the line is the factor's to multiply: the note says which of the two it is."

changedOutput schema / properties / ingredients / items / required

Previous value: -[
-  "original",
-  "text",
-  "amount",
-  "unit",
-  "scaling",
-  "adjusted"
-]New value: +[
+  "original",
+  "text",
+  "amount",
+  "amountMax",
+  "unit",
+  "scaling",
+  "adjusted"
+]

Changed3 schema fields changedv1.5.0Aug 5, 2026

changedOutput schema / properties / ingredients / items / properties / adjusted / description

Previous value: -"True when rounding moved the value away from the exact product. A line can be 'rounded' and still land exactly, as three eggs doubled land on six."New value: +"True when rounding moved the value away from the exact product, which is what makes a line 'rounded' rather than 'scaled'."

changedOutput schema / properties / ingredients / items / properties / note / description

Previous value: -"Why the line was rounded, clamped or left alone."New value: +"Why the line was rounded, clamped or left alone, including when the measure is approximate and only its count was multiplied."

changedOutput schema / properties / ingredients / items / properties / scaling / description

Previous value: -"'scaled' was multiplied cleanly. 'rounded' was multiplied then rounded to something countable. 'unscaled' was left alone, either because it carries no quantity or because the measure is approximate by nature."New value: +"'scaled' means the arithmetic came out exact, which a count reaches as readily as a mass: one pinch multiplied by six is six pinches. 'rounded' means the value had to be moved to stay usable, to a whole or half unit or to a step a scale can show. 'unscaled' was left alone, because the line carries no quantity."

Changed3 schema fields changedv1.3.0Aug 4, 2026

addedOutput schema / properties / ingredients / items / properties / adjusted

Added value: +{
+  "description": "True when rounding moved the value away from the exact product. A line can be 'rounded' and still land exactly, as three eggs doubled land on six.",
+  "type": "boolean"
+}

changedOutput schema / properties / ingredients / items / properties / note / description

Previous value: -"Why the line was rounded or left alone."New value: +"Why the line was rounded, clamped or left alone."

changedOutput schema / properties / ingredients / items / required

Previous value: -[
-  "original",
-  "text",
-  "amount",
-  "unit",
-  "scaling"
-]New value: +[
+  "original",
+  "text",
+  "amount",
+  "unit",
+  "scaling",
+  "adjusted"
+]

First observedv1.0.2Aug 3, 2026

TDQS

A4.2/5.0

Behavior5/5

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

Annotations already cover safety (readOnly, idempotent, non-destructive), and the description adds rich behavioral detail: how scaling works, the 'scaled'/'rounded'/'unscaled' flags, 'yield' interpretation, and the requirement to cite 'attribution'. This goes well beyond the structured data and discloses exact operation semantics.

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?

The description is longer than average but every sentence earns its place: purpose, input specification, scaling behavior, and attribution. It is front-loaded with the core purpose and logically structured, though slightly verbose.

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?

An output schema is present, so return values need not be described. The description covers input selection, scaling, flags, yield, and attribution. It does not address error cases (e.g., invalid URL), but for a simple read tool with optional parameters this is adequate. A 4 reflects that it is nearly complete but could mention failure modes.

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. The description adds significant meaning to 'servings' by explaining rescaling behavior and the flags, and it reinforces the id/url precedence. This adds value beyond the schema, though not exhaustively, so a 4 is appropriate.

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

Purpose4/5

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

The description states a specific verb ('read') and resource ('one Marmiton recipe') and lists the contents (ingredients, steps, times, category, rating, nutrition). It clearly differentiates from search_recipes by implying this is the retrieval step, but does not explicitly contrast with the scale_ingredients sibling, so it is not a full 5.

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 explicitly tells how to specify the recipe (id from search_recipes or a URL) and when to set 'servings' to rescale. It provides clear context for using the tool but does not mention when to use scale_ingredients instead or any exclusions, so it misses the 'when-not' guidance for a full 5.

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

Deploy Server