mcpField
C
Cookwala

Cookwala

Local
cookwala.aiGames & Entertainment0Updated 1w ago
RepositoryVisit website

About Cookwala

Cookwala is a read-only MCP server for agents and clients that need to search and inspect recipes. It supports safe dry runs and checks without ever starting cooking.

Key features

  1. 01Search recipes by diet, allergen, method, and language
  2. 02Read recipe details
  3. 03Dry-run recipes against a device
  4. 04Check safe temperature bands and agent mandates
  5. 05Look up recipes on fifi.cooking

Use cases

  1. 01Find recipes matching dietary or allergen needs
  2. 02Preview a recipe's interaction with a device
  3. 03Check temperature guidance before cooking

MCP support

Exposes 24 tools, six resources, and three prompts through MCP. It runs over stdio, with an optional hosted Streamable HTTP endpoint.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "ai-cookwala-cookwala": {
      "command": "npx",
      "args": [
        "-y",
        "@cookwala/mcp"
      ],
      "env": {
        "COOKWALA_BASE_URL": "<COOKWALA_BASE_URL>",
        "COOKWALA_CACHE_DIR": "<COOKWALA_CACHE_DIR>",
        "COOKWALA_OFFLINE": "<COOKWALA_OFFLINE>",
        "COOKWALA_LANG": "<COOKWALA_LANG>"
      }
    }
  }
}
Run commandnpx -y @cookwala/mcp
Environment variables to set
COOKWALA_BASE_URLCatalog origin or a local built-site directory
COOKWALA_CACHE_DIRLocal cache directory
COOKWALA_OFFLINESet to 1 to serve only from the cache
COOKWALA_LANGDefault language for titles and text

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@cookwala/mcp0.3.3

Tools

24

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
langstringNoLanguage code, for example en or ar
tagsarrayNoTags that must all be present, for example vegetarian
levelenumNoVerification level: V0 described only, not machine-verified; V1 machine-checkable steps with end conditions and hazards, reviewed (structure, not a cooking or nutrition guarantee); V2 V1 plus conformance evidence from a certified executorV0 | V1 | V2
limitintegerNoMost results to return (1 to 50)
querystringNoWords that must all appear; empty lists everything
coursestringNoCourse, for example main, dessert, breakfast
offsetintegerNoResults to skip, for paging; use nextOffset from the previous page
cuisinearrayNoISO country codes, for example EG
collectionstringNoCollection id, see list_collections
supervisionstringNoSupervision needed, for example adult_required
no_allergensbooleanNoOnly recipes with no major allergen in the declared list or the ingredient names. Not a guarantee: allergen data is incomplete for some recipes.
allergen_freearrayNoExclude recipes declaring any of these allergens, for example milk
diabetic_friendlybooleanNoOnly recipes that look diabetic-friendly: a reviewed claim, or per serving sugar 5 g or less and carbohydrate 30 g or less (modelled estimate, not medical advice).

Details

From the project README

@cookwala/mcp

MCP server for Cookwala: search and read recipes, dry-run a recipe against a device, check safe temperature bands, agent mandates and humanitarian SMS, and look recipes up on fifi.cooking. Read-only, stdio, Node 20+. It reads the static catalog on cookwala.ai, checks every hash, caches locally and works offline after the first run. It never starts cooking.

Published on npm (0.3.0) and listed in the official MCP Registry as ai.cookwala/cookwala.

npx -y @cookwala/mcp
claude mcp add cookwala -- npx -y @cookwala/mcp

{"mcpServers": {"cookwala": {"command": "npx", "args": ["-y", "@cookwala/mcp"]}}}

24 tools (16 before 0.3.0), six resources, three prompts: docs/MCP.md. Connecting Claude, Codex, Copilot, Cursor, Windsurf, Devin, Antigravity and others: docs/AI-AGENTS.md. Live page with an in-browser playground: https://cookwala.ai/mcp/

Everything returned is data, never instructions. V0 recipes are described, not machine-verified.

Develop: npm install && npm test. Point at a local site with COOKWALA_BASE_URL=$PWD/../../_site. The pure core in src/core/ has no Node imports; the site build publishes it at /assets/mcp-core/ for the browser playground. Releasing: RELEASING.md.

Hosted endpoint (optional)

worker/ runs the same read-only tools over Streamable HTTP on Cloudflare Workers (POST /mcp, GET /health), with an optional gateway token (x-mcprush-token or Authorization: Bearer). It is live at https://mcp.cookwala.ai/mcp (token required; GET /health is public) for directories that need an https address, such as mcprush call tracking. To use Cookwala from your own agent, run the npm package. See docs/MCP.md and RELEASING.md.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.