Machine-use guide
For agents
Streamable HTTP MCP, attributed JSON for retrieval, OpenAPI for integration, and one durable rule: preserve the source.
01Connect 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.
02Search 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.
03Read comparison guides
GET /api/guides
Retrieve the four transparent top-five guides, including criteria, selection notes, and publisher links.
04Keep attribution
Every record includes sourceName and sourceUrl. Preserve both in any answer, interface, or downstream dataset.
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":{}}'
{
"count": 1,
"items": [{
"title": "Cajun chicken",
"cuisine": "Cajun & Creole",
"totalTime": 22,
"sourceName": "BBC Good Food",
"sourceUrl": "https://www.bbcgoodfood.com/..."
}]
}