API and MCP

Weekly meal plans with real store prices and one shopping list, from your own app or from an assistant. No key, no account.

Key

not needed

Requests a minute

600 / 60

Recipes

2140

Countries

Where to get a key

Nowhere: the public API works without a key and without an account, just send the request. Keys starting with rk_ do exist, but they write recipes into the database and are issued to service administrators only. Reading and building plans needs none, and the limits are the same for everybody else.

Getting started

Search recipes by words in the title and the ingredients. Each result already carries the time, the calories and the cost of one portion in the currency of the country you asked for.

curl "https://racion.app/api/recipes?q=chicken&country=DE&lang=en&limit=5"

The main call builds a week. Send who eats, where they shop and what they will not eat; get seven days of dishes and one shopping list rounded up to whole packs.

curl -X POST "https://racion.app/api/plans" \
  -H "Content-Type: application/json" \
  -d '{"country":"DE","store":"rewe","lang":"en","adults":2,
       "kids":[{"age":7}],"slots":["breakfast","lunch","dinner"],
       "equipment":["stove","oven"],"excludeTags":["fish"],
       "budgetMode":"perPersonDay","budgetValue":12}'

The answer carries an id, and /plan/<id> opens the same week as a page for a person — printable, tickable in the shop, shareable by link. Give the link rather than retelling the list.

What it does

Method	What it does
`GET /api/meta`	Countries, stores with their price index, allergens and exclusion presets
`GET /api/recipes`	Catalogue with search and paging
`GET /api/recipes/{id}`	Full recipe: grams per portion, steps, macros, cost
`GET /api/collections`	Curated collections and their recipe ids
`GET /api/occasions`	Holiday tables that can be built for a number of guests
`GET /api/ingredients`	Ingredient reference: units, pack sizes, nutrition per 100 g
`POST /api/plans`	Build a week with a shopping list
`GET /api/plans/{id}`	Read a plan built earlier
`POST /api/baskets`	Build a table from dishes you picked, each with its own number of servings
`POST /api/occasions/{id}`	Build a holiday table for a number of guests

openapi.json — the full description in OpenAPI 3.1, understood by client generators and assistants.

Limits

Per address: 600 requests a minute to /api/ overall, of which 60 a minute may build plans. Bursts of 100 and 20 are allowed. Over the limit the answer is 429 with a Retry-After header. CORS is open, so the API can be called straight from a browser. Need more? Write to us.

Where the prices come from

They are estimates, not shelf prices. The base is official statistics: Rosstat in Russia, Eurostat price levels with HICP in Europe, BLS in the United States. A per-chain index is applied on top, so a discounter and a premium supermarket give different totals. Every answer carries a priceSource field with the source and the period — show it next to the figure if you publish one.

MCP server

If you work in Claude, ChatGPT or another MCP client, connect the racion-mcp server and the assistant can plan the week itself. It needs no key either.

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

Six tools: build a week, build a table from chosen dishes, search recipes, get a recipe, list collections, list stores with the country price index.

Terms

Building a product on the API is fine. Republishing the recipe corpus or the photos, whole or in large parts, is not. Details in the rights section: Gebruiksvoorwaarden.

Questions, higher limits, partnership — info@racion.app.