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/mcp/manual

Public Streamable HTTP endpoint over POST with read-only search, record lookup, comparison, and editorial-guide tools. No authentication is required. The older /api/recipes MCP alias remains available.

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.

MCP tools checkServer card ↗
curl https://recipemcp.com/mcp/manual \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
Example responseOpenAPI JSON ↗
{
  "count": 1,
  "items": [{
    "title": "Cajun chicken",
    "cuisine": "Cajun & Creole",
    "totalTime": 22,
    "sourceName": "BBC Good Food",
    "sourceUrl": "https://www.bbcgoodfood.com/..."
  }]
}