{"openapi":"3.1.0","info":{"title":"Masala (Spice Blend) API","version":"0.1.0","description":"A fully local Indian spice encyclopedia: 37 individual spice profiles, 12 common blends, substitution guidance, dish-type pairings, a qualitative chili heat-level guide, storage/shelf-life notes, regional spice profiles, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://masala.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/masala/docs"},"termsOfService":"https://connectorbay.com/masala/terms"},"servers":[{"url":"https://masala.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/masala/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/spice_info":{"post":{"operationId":"spice_info","summary":"One spice's description, flavor profile, common culinary uses, whole-vs-ground form notes, and storage","description":"One spice's description, flavor profile, common culinary uses, whole-vs-ground form notes, and storage\n    tips — covers 37 individual spices. Use for \"what does cardamom taste like\", \"what is hing\", \"how is\n    turmeric used\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A spice's common English name or a Hindi/regional alias.","examples":["cumin","haldi","green cardamom","hing"],"title":"Name","type":"string"}},"required":["name"],"title":"spice_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/spice_search":{"post":{"operationId":"spice_search","summary":"Search all spices by partial name, alias, flavor profile, or culinary use. Use for \"spices with a","description":"Search all spices by partial name, alias, flavor profile, or culinary use. Use for \"spices with a\n    citrusy flavor\", \"which spice is also called saunf\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial name, alias, or a word from a spice's flavor/use description.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"spice_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/spice_blend_info":{"post":{"operationId":"spice_blend_info","summary":"One spice blend's typical composition, flavor profile, common uses, and regional variants — covers","description":"One spice blend's typical composition, flavor profile, common uses, and regional variants — covers\n    12 common blends (garam masala, chaat masala, sambar podi, rasam podi, panch phoron, goda masala, chana\n    masala, biryani masala, tandoori masala, pav bhaji masala, kitchen king masala, Kolhapuri masala). Use for\n    \"what's in garam masala\", \"what is sambar powder made of\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A blend's name or alias.","examples":["garam masala","chaat masala","sambar podi","biryani masala"],"title":"Name","type":"string"}},"required":["name"],"title":"spice_blend_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/substitution_guide":{"post":{"operationId":"substitution_guide","summary":"Reasonable substitutes for a spice that's unavailable, with notes on how close each one comes. Use for","description":"Reasonable substitutes for a spice that's unavailable, with notes on how close each one comes. Use for\n    \"what can I use instead of hing\", \"substitute for curry leaves\", \"no cardamom, what else works\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"spice":{"description":"A spice's common English name or alias.","examples":["asafoetida","black cardamom","curry leaves"],"title":"Spice","type":"string"}},"required":["spice"],"title":"substitution_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/spice_by_dish_type":{"post":{"operationId":"spice_by_dish_type","summary":"Spices commonly used for a category of dish: curries, rice dishes, snacks/chaat, desserts/sweets, or","description":"Spices commonly used for a category of dish: curries, rice dishes, snacks/chaat, desserts/sweets, or\n    pickles. Use for \"what spices go in a curry\", \"what do Indian sweets use for flavor\", \"spices for pickling\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dish_type":{"description":"curries | rice_dishes | snacks_chaat | desserts_sweets | pickles (synonyms like 'curry', 'rice', 'chaat', 'dessert', 'pickle' also work).","title":"Dish Type","type":"string"}},"required":["dish_type"],"title":"spice_by_dish_typeArguments","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/heat_level_guide":{"post":{"operationId":"heat_level_guide","summary":"A qualitative heat-level reference (mild / medium / hot / very hot) for chilies and peppers commonly","description":"A qualitative heat-level reference (mild / medium / hot / very hot) for chilies and peppers commonly\n    used in Indian cooking — Kashmiri, Byadgi and Guntur chilies, bird's-eye/Thai chili as used in some\n    Northeast Indian cooking, black pepper, and long pepper. Heat is described qualitatively rather than with\n    precise Scoville numbers. Use for \"how hot is Kashmiri chili\", \"what's the mildest Indian chili\", \"is\n    Guntur chili hotter than Kashmiri chili\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"heat_level_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/storage_shelf_life_guide":{"post":{"operationId":"storage_shelf_life_guide","summary":"General storage and shelf-life guidance for a spice — whole and ground forms of the same spice keep","description":"General storage and shelf-life guidance for a spice — whole and ground forms of the same spice keep\n    very differently. Use for \"how long does ground cumin last\", \"should I store whole or ground nutmeg\",\n    \"does turmeric powder go bad\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"spice":{"description":"A spice's common English name or alias.","examples":["saffron","black pepper","cinnamon"],"title":"Spice","type":"string"}},"required":["spice"],"title":"storage_shelf_life_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_spice_profile":{"post":{"operationId":"regional_spice_profile","summary":"Characteristic spice use for a major Indian region — style, signature spices, typical dishes, and a","description":"Characteristic spice use for a major Indian region — style, signature spices, typical dishes, and a\n    note on what makes the region's spicing distinctive. Use for \"what spices does Bengali cooking use\",\n    \"how is Kashmiri cooking different from Punjabi\", \"characteristic spices of South India\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Punjab | Bengal | Kerala/South India | Gujarat | Maharashtra | Kashmir | Rajasthan.","title":"Region","type":"string"}},"required":["region"],"title":"regional_spice_profileArguments","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/spice_glossary":{"post":{"operationId":"spice_glossary","summary":"Definitions of common Indian-cooking spice terms (tadka/tempering, bhuna, what \"garam masala\" means,","description":"Definitions of common Indian-cooking spice terms (tadka/tempering, bhuna, what \"garam masala\" means,\n    whole vs ground, hing, khada masala, panch phoron, dhungar smoking, kasuri methi, masala). Use for\n    \"what's tadka\", \"what does bhuna mean\", \"does garam masala mean spicy\".","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":"spice_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}}}}