MCP Supertoinette

mcp-supertoinette

Supertoinette is a French cooking site, one of the oldest still standing. Its recipes give their ingredients, their steps, their preparation, cooking and resting times, the number of people they feed and the photographs of the dish. Beside the recipes it keeps a set of pages of its own on what to drink with a dish, matching a wine to it and saying which style it belongs to.

This server connects a chat client to that site. You can search its recipes, read one with its ingredients rescaled to the number of people at your table, walk its categories, read a category page by page, and look up what it suggests drinking with a dish. It needs no API key and no account.

_Version française_

Install

One-click install

Claude Code

claude mcp add supertoinette -- npx -y mcp-supertoinette

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

{

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

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

With Docker

{

"mcpServers": { "supertoinette": { "command": "docker", "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-supertoinette:1.2.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.supertoinette.com, and nothing else: no volume, no port, no credential.

Bundle, without npm

Download mcp-supertoinette-1.2.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

• « Trouve-moi une recette de blanquette de veau. »
• "Read me that recipe for ten people."
• "What categories does the site file its recipes under?"
• "What wine goes with a beef bourguignon?"
• "Scale this ingredient list from my grandmother's notebook by three."

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

Tools

get_recipe

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

In return: title with the pictogram the site opens it with taken off, and title_as_published exactly as the site wrote it; url; description; published_at; intro, the prose printed above the method; steps; prep_minutes, cook_minutes, rest_minutes and total_minutes; category; author; and rating, each null where the page states nothing. yield says what the recipe was written for and what it was rescaled to. ingredients carries the lines with the headings the page groups them under, which is what ingredient_count counts, and each line's scaling reads scaled, rounded or unscaled.

search_recipes

Searches the recipes for a dish or an ingredient, one page at a time.

In return: rows carrying id, which get_recipe takes, title, title_as_published and url. Alongside come page, last_page for the highest page the site links to from this one, result_count, rows_published for the rows the page held before any were rendered, total_available and facets, which publishes the category wordings a further search takes. Never build a category wording by hand: the site answers one it does not know with a page that reads as an absence.

list_categories

Reads the categories the site files its recipes under. It takes no argument.

In return: categories, with category_count for the entries the site's two lists hold, and the url they were read from. Pass a category on to browse_recipes.

browse_recipes

Reads one category, page by page.

In return: the rows and the envelope search_recipes returns, with last_page saying how far the listing runs.

get_wine_pairings

Reads what the site suggests drinking with a dish, from the pages it wrote on the subject.

In return: entries carrying the id, the dish under the site's own name for it, and style, the style of wine the page opens with, which is null where it wrote none.

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 rescaled lines in the shape get_recipe returns, each with its scaling.

Rescaling the quantities

A quantity is stated in the unit that suits it, so a line can come back in a different unit from the one the recipe used: 200 g multiplied by twenty reads 4 kg.

How finely an ingredient can be divided depends on what it is. A baguette can be cut in two, in three or in four; an egg cannot be shared out. A quantity landing between the two is rounded, and the rescaled recipe then departs a little from the proportions of the original. The line carries rounded, and its note says what was done.

The figures are this server's arithmetic, so say they were recomputed when you show them. A recipe whose page states no number of servings cannot be put to a number of people, and the answer says so.

Configuration

Every variable is optional. Set them in the env block of your client config.

| STO_MAX_RETRIES | 3