{"openapi":"3.1.0","info":{"title":"Matbakh (Cuisine) API","version":"0.1.0","description":"A hand-curated Arab cuisine encyclopedia: 88 dishes across the Levantine, Egyptian, Gulf/Khaleeji, Maghrebi and Iraqi culinary regions with region, category and main ingredients, a spice/ingredient guide, a transparent disputed-origin list, Ramadan iftar dishes, a beverage guide and a cuisine glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://matbakh.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/matbakh/docs"},"termsOfService":"https://connectorbay.com/matbakh/terms"},"servers":[{"url":"https://matbakh.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/matbakh/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/dish_info":{"post":{"operationId":"dish_info","summary":"One Arab dish's description, region, main ingredients, how it's typically served, and common","description":"One Arab dish's description, region, main ingredients, how it's typically served, and common\n    variations. Use for \"what is kibbeh\", \"tell me about kabsa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A dish name.","examples":["kibbeh","kabsa","shakshuka","kanafeh"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"dish_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/dish_search":{"post":{"operationId":"dish_search","summary":"Search Arab dishes by keyword across name, region, category, description and main ingredients.","description":"Search Arab dishes by keyword across name, region, category, description and main ingredients.\n    Use for \"dishes with eggplant\", \"what has sumac in it\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search across dish name, region, category, description and main ingredients.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"dish_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/dishes_by_region":{"post":{"operationId":"dishes_by_region","summary":"Dishes from a specific Arab culinary region: Levantine (Lebanese/Syrian/Jordanian/Palestinian),","description":"Dishes from a specific Arab culinary region: Levantine (Lebanese/Syrian/Jordanian/Palestinian),\n    Egyptian, Gulf/Khaleeji, Maghrebi (Moroccan/Tunisian/Algerian), or Iraqi. Use for \"what dishes come\n    from the Levant\", \"show me Gulf food\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A culinary region.","examples":["Levantine","Egyptian","Gulf","Maghrebi","Iraqi"],"title":"Region","type":"string"}},"required":["region"],"title":"dishes_by_regionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/dishes_by_category":{"post":{"operationId":"dishes_by_category","summary":"Dishes filtered by category: mezze/appetizer, main, dessert, bread, or beverage. Use for \"show me","description":"Dishes filtered by category: mezze/appetizer, main, dessert, bread, or beverage. Use for \"show me\n    Arab desserts\", \"what breads do you know\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"mezze/appetizer | main | dessert | bread | beverage","title":"Category","type":"string"}},"required":["category"],"title":"dishes_by_categoryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/ingredient_info":{"post":{"operationId":"ingredient_info","summary":"A key Arab-cuisine ingredient's description, flavor profile, and common uses — za'atar, sumac,","description":"A key Arab-cuisine ingredient's description, flavor profile, and common uses — za'atar, sumac,\n    tahini, rosewater, and more. Use for \"what is za'atar\", \"what does sumac taste like\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A key Arab-cuisine ingredient.","examples":["za'atar","sumac","tahini","rosewater","preserved lemon"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"ingredient_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/disputed_origin_dishes":{"post":{"operationId":"disputed_origin_dishes","summary":"A transparent list of dishes whose origin or \"who invented it\" is genuinely disputed or shared among","description":"A transparent list of dishes whose origin or \"who invented it\" is genuinely disputed or shared among\n    Arab (and sometimes neighboring) cuisines — hummus, falafel, tabbouleh, kibbeh/kubba, kanafeh, baklava,\n    shakshuka, kabsa/machboos, and more. Handled neutrally: this list states that food historians differ\n    rather than picking a side, and makes no claim of exclusive national ownership over any dish. Use for\n    \"is hummus Lebanese or Israeli\", \"who really invented falafel\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"disputed_origin_dishesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/ramadan_iftar_dishes":{"post":{"operationId":"ramadan_iftar_dishes","summary":"Dishes traditionally associated with breaking the day's fast at iftar during Ramadan — harira,","description":"Dishes traditionally associated with breaking the day's fast at iftar during Ramadan — harira,\n    shorbat adas, qatayef, jallab, luqaimat, chebakia and more. Strictly about food: descriptive, not\n    prescriptive religious guidance. For prayer times, the Ramadan calendar and fasting rules, see the\n    separate salah connector. Use for \"what do people eat to break the fast\", \"Ramadan dessert ideas\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"ramadan_iftar_dishesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/beverage_info":{"post":{"operationId":"beverage_info","summary":"An Arab beverage's description, main ingredients and how it's served — mint tea, tamarind drink,","description":"An Arab beverage's description, main ingredients and how it's served — mint tea, tamarind drink,\n    karak chai, jallab, and more. The Arabic coffee entry here is intentionally brief; the dedicated qahwa\n    connector covers coffee-ceremony culture in depth. Use for \"what's karak chai\", \"what is jallab\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"An Arab beverage.","examples":["mint tea","karak chai","jallab","arabic coffee"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"beverage_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/cuisine_glossary":{"post":{"operationId":"cuisine_glossary","summary":"Definitions of Arab culinary and food-culture terms not tied to a single dish (mezze, tarqa, taboon,","description":"Definitions of Arab culinary and food-culture terms not tied to a single dish (mezze, tarqa, taboon,\n    warqa, dallah, jameed, black lime, ashta, ras el hanout, dibs, and more). Use for \"what does mezze\n    mean\", \"what's a dallah\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"cuisine_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}