{"openapi":"3.1.0","info":{"title":"Cocina (Cuisine) API","version":"0.1.0","description":"A hand-curated Mexican regional cuisine encyclopedia: 76 classic dishes across eight regions with region, category, key ingredients, spice level and serving occasion, a Mexican ingredient guide with a chile heat table, fuller regional specialty write-ups, a street-food 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://cocina.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/cocina/docs"},"termsOfService":"https://connectorbay.com/cocina/terms"},"servers":[{"url":"https://cocina.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/cocina/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 Mexican dish's description, region of origin, category, key ingredients, spice level and typical","description":"One Mexican dish's description, region of origin, category, key ingredients, spice level and typical\n    serving occasion. Use for \"what is cochinita pibil\", \"tell me about mole poblano\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A dish name.","examples":["cochinita pibil","mole poblano","tacos al pastor"],"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 Mexican dishes by keyword across name, region, category, description and key ingredients. Use","description":"Search Mexican dishes by keyword across name, region, category, description and key ingredients. Use\n    for \"dishes with tomatillo\", \"what has achiote in it\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search across dish name, region, category, description and 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":"Characteristic dishes of a Mexican region. Covers Oaxaca, Yucatán, Norte, Centro, Veracruz, Puebla,","description":"Characteristic dishes of a Mexican region. Covers Oaxaca, Yucatán, Norte, Centro, Veracruz, Puebla,\n    Baja California and Jalisco. Use for \"what dishes come from Oaxaca\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A Mexican region.","examples":["Oaxaca","Yucatán","Norte","Centro","Veracruz","Puebla","Baja California","Jalisco"],"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: antojito (street snack), soup/caldo, main/plato fuerte, dessert/postre,","description":"Dishes filtered by category: antojito (street snack), soup/caldo, main/plato fuerte, dessert/postre,\n    drink/bebida, or salsa. Use for \"show me Mexican desserts\", \"what salsas do you know\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"antojito | soup/caldo | main/plato fuerte | dessert/postre | drink/bebida | salsa","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 Mexican ingredient's flavor profile and common use — masa/nixtamal, named chiles (poblano,","description":"A key Mexican ingredient's flavor profile and common use — masa/nixtamal, named chiles (poblano,\n    serrano, habanero, chile de árbol, guajillo, ancho, chipotle, jalapeño, pasilla), epazote, achiote,\n    tomatillo, hoja santa and more. Use for \"what is epazote\", \"what is achiote used for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A Mexican ingredient.","examples":["masa","poblano","epazote","achiote","tomatillo","hoja santa","chipotle"],"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/chile_heat_guide":{"post":{"operationId":"chile_heat_guide","summary":"A Scoville-range-referenced heat comparison table of common Mexican chiles, from mildest to hottest,","description":"A Scoville-range-referenced heat comparison table of common Mexican chiles, from mildest to hottest,\n    with flavor notes and typical use. Use for \"how hot is a habanero\", \"compare serrano and jalapeño\n    heat\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"chile_heat_guideArguments","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/regional_specialty_guide":{"post":{"operationId":"regional_specialty_guide","summary":"A fuller write-up of what makes a Mexican region's food culture distinctive — its signature","description":"A fuller write-up of what makes a Mexican region's food culture distinctive — its signature\n    ingredients, influences and dishes. A deeper version of dishes_by_region's filter. Use for \"what makes\n    Oaxacan food different\", \"describe Yucatecan cuisine\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A Mexican region.","examples":["Oaxaca","Yucatán","Norte","Puebla"],"title":"Region","type":"string"}},"required":["region"],"title":"regional_specialty_guideArguments","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/street_food_guide":{"post":{"operationId":"street_food_guide","summary":"An overview of Mexican street food (antojito) culture — tacos, tortas, elote/esquites, tlayudas and","description":"An overview of Mexican street food (antojito) culture — tacos, tortas, elote/esquites, tlayudas and\n    garnachas — plus the full list of antojitos in the dataset. Use for \"tell me about Mexican street\n    food\", \"what's the difference between elote and esquites\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"street_food_guideArguments","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 Mexican culinary and food-culture terms (nixtamalización, masa, mole, salsa, comal,","description":"Definitions of Mexican culinary and food-culture terms (nixtamalización, masa, mole, salsa, comal,\n    antojito, molcajete, metate, recado, adobo, cal, guisado, picante, botana). Use for \"what does\n    nixtamalización mean\", \"what's a molcajete\".","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}}}}