Machine-use guide

For agents

Streamable HTTP MCP, attributed JSON for retrieval, OpenAPI for integration, and one durable rule: preserve the source.

01

Connect through MCP

https://recipemcp.com/api/recipes

Public Streamable HTTP endpoint over POST with read-only search, record lookup, comparison, and editorial-guide tools. No authentication is required. GET on the same URL returns the JSON recipe index.

02

Search the JSON index

GET /api/recipes?q=chicken&maxTime=30&limit=10

Filter by free text, cuisine, publisher, maximum total time, stable slug, and paginated offset.

03

Read comparison guides

GET /api/guides

Retrieve the four transparent top-five guides, including criteria, selection notes, and publisher links.

04

Keep attribution

Every record includes sourceName and sourceUrl. Preserve both in any answer, interface, or downstream dataset.

Example responseOpenAPI JSON ↗
{
  "count": 1,
  "items": [{
    "title": "Cajun chicken",
    "cuisine": "Cajun & Creole",
    "totalTime": 22,
    "sourceName": "BBC Good Food",
    "sourceUrl": "https://www.bbcgoodfood.com/..."
  }]
}