MCP Ptitchef

mcp-ptitchef

Ptitchef is a French cooking site where home cooks publish their recipes. Each one gives its ingredients, its steps, often photographed one by one, its preparation and cooking times, its cost, its nutrition figures and the ratings its readers left. The site files its recipes under a tree of ingredient families, and publishes many of them in several languages.

This server connects a chat client to that site. You can walk the tree of categories, search the recipes by dish or by ingredient, browse a category or one of the site's standing lists, ask what can be made from what is in the fridge, read one recipe with its ingredients rescaled to the number of people at your table, and find the other languages a recipe was published in. It needs no API key and no account.

_Version française_

Install

One-click install

Claude Code

claude mcp add ptitchef -- npx -y mcp-ptitchef

Claude Desktop, Cursor, and any client using the standard config format

{

"mcpServers": { "ptitchef": { "command": "npx", "args": ["-y", "mcp-ptitchef"] } } }

Node 24 or later is required, and no environment variable has to be set.

With Docker

{

"mcpServers": { "ptitchef": { "command": "docker", "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-ptitchef:1.1.0"] } } }

-i keeps stdin open, which is where the protocol travels, and -t is left out because a TTY rewrites the stream. The container needs outbound HTTPS to www.ptitchef.com, and nothing else: no volume, no port, no credential.

Bundle, without npm

Download mcp-ptitchef-1.1.0.mcpb from the latest release and open it. A client that supports MCP bundles installs it on its own, with no npm and no configuration file to edit. The bundle carries its dependencies, so nothing is fetched at install time.

What you can ask

• « Qu'est-ce que Ptitchef a comme recettes de chou kale ? »
• "What can I cook with courgettes, feta and mint?"
• "Read me that gratin for eight people."
• "Show me the highest rated recipes on the site."
• "Is that recipe published in Spanish too?"

Ptitchef is a French site, so its recipes are found in French. The ordinary path runs from a listing to a recipe: a row carries an id, and get_recipe takes that id.

Tools

Start at `list_categories`. The site gives you the right addresses, which saves building one by hand: an address built that way lands on the site's front page.

list_categories

Reads the tree the site files its recipes under. Called with no argument it returns the families; pass a family's slug back as family to read what it holds.

In return: rows carrying slug, which comes back as family or as category; title in the site's own wording; url; description, which is null where the page carries none; and sample_children for the categories one level below.

search_recipes

Searches the recipes for a dish or an ingredient.

In return: results, rows carrying id, title, url, image_url, rating, rating_count and review_count, a counter the page prints nothing for being null. The envelope says how the site answered: kind reads category when the answer came from a category page of its own, whose total_available counts that whole category, and free_text when the site answered on its own terms on a single page, where the total counts the rows served. Those two totals count different things. kind also reads guide for a topic the site wrote by hand, where rows carry a name and an address and no total exists. Alongside come result_count, rows_seen, page, single_page and url. A listing marked single_page whose total exceeds rows_seen has a remainder the site counts and does not serve.

browse_recipes

Reads a category page by page, or one of the site's standing lists.

In return: the envelope search_recipes returns, with kind reading category, standing or topic. page is the page the site served. A page past the last one comes back either as the first page again or as a not_found refusal naming it past the last page.

search_by_ingredients

Answers what can be made from the ingredients a cook already has.

In return: the envelope the other listings return, with kind reading fridge. The site matches on its own vocabulary, so an ingredient it writes differently narrows the answer rather than widening it.

get_recipe

Reads one recipe in full, and rescales its ingredients when a number of servings is given.

In return: title, url, description, image_url, category, cuisine, difficulty in the site's own wording, author, published, modified, rating, rating_count, review_count, prep_minutes, cook_minutes, total_minutes, nutrition as published for the serving size it names, estimated_cost, keywords, faq and translations, each null where the page states nothing. steps carries the method one line per step, and illustrated_steps the same steps with the photograph the site took of each. yield says what the recipe was written for and what it was rescaled to. Every ingredient carries scaling, which reads scaled, rounded or unscaled: read it before quoting a quantity, since rounded was moved to stay usable in a kitchen.

scale_ingredients

Applies the same arithmetic to any list of French ingredient lines, with no request to the site.

Pass factor, or the from_servings and to_servings pair.

In return: the factor used, the rescaled ingredients in the shape get_recipe returns, and scaled_count, rounded_count and unscaled_count.

get_recipe_translations

Lists the other languages one recipe was published in, using the pairing the site publishes its