{"openapi":"3.1.0","info":{"title":"Nakhla (Date Palm) API","version":"0.1.0","description":"A hand-curated date-palm and dates variety reference: 19 varieties across 8 origin regions, the four botanical ripeness stages, USDA-checked nutrition facts, cultivation basics, storage guidance, culinary pairings, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://nakhla.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/nakhla/docs"},"termsOfService":"https://connectorbay.com/nakhla/terms"},"servers":[{"url":"https://nakhla.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/nakhla/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/variety_info":{"post":{"operationId":"variety_info","summary":"A date variety's origin region, flavor and texture profile, typical size, the ripeness stage it's","description":"A date variety's origin region, flavor and texture profile, typical size, the ripeness stage it's\n    typically harvested and sold at, and typical culinary use. Use for \"tell me about Medjool dates\", \"what's\n    special about Ajwa dates\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A date variety name.","examples":["Medjool","Ajwa","Khalas","Deglet Noor"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"variety_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/variety_search":{"post":{"operationId":"variety_search","summary":"Search the 19 date varieties in this reference by partial name, alias, origin region, or flavor/texture","description":"Search the 19 date varieties in this reference by partial name, alias, origin region, or flavor/texture\n    keyword. Use for \"which dates are chewy and caramel-like\", \"do you have anything on Sukkary\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"default":"","description":"Partial variety name, alias, region, or flavor keyword; empty lists all 19 varieties.","title":"Query","type":"string"}},"title":"variety_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/varieties_by_region":{"post":{"operationId":"varieties_by_region","summary":"Date varieties in this reference grouped by origin region — Saudi Arabia (Al-Qassim, Al-Madinah,","description":"Date varieties in this reference grouped by origin region — Saudi Arabia (Al-Qassim, Al-Madinah,\n    Al-Ahsa), Iraq, Tunisia, Algeria, Iran, UAE, Egypt or Morocco. Use for \"what dates come from Iraq\", \"which\n    varieties are grown in Saudi Arabia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"An origin region.","examples":["Saudi Arabia","Iraq","Tunisia","Algeria","Iran","UAE","Egypt","Morocco"],"title":"Region","type":"string"}},"required":["region"],"title":"varieties_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/ripeness_stages_guide":{"post":{"operationId":"ripeness_stages_guide","summary":"The four botanical ripeness stages of a date — kimri, khalal, rutab and tamr — explained with what","description":"The four botanical ripeness stages of a date — kimri, khalal, rutab and tamr — explained with what\n    changes in color, texture, sweetness and shelf life at each stage, and why it matters. Use for \"what are\n    the stages of a date's ripeness\", \"what does rutab mean\", \"why is Barhi sold both crunchy and soft\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"ripeness_stages_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/nutrition_info":{"post":{"operationId":"nutrition_info","summary":"Nutrition facts per typical serving — USDA-verified for Medjool and Deglet Noor specifically (the only","description":"Nutrition facts per typical serving — USDA-verified for Medjool and Deglet Noor specifically (the only\n    two date cultivars USDA FoodData Central tracks individually), and a typical range for other varieties.\n    Informational only, not medical or dietary advice. Use for \"how many calories are in a Medjool date\", \"are\n    dates high in fiber\", \"nutrition facts for dates\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"variety":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific date variety; omit for general dates nutrition facts and the USDA-tracked varieties.","title":"Variety"}},"title":"nutrition_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/culinary_pairing_guide":{"post":{"operationId":"culinary_pairing_guide","summary":"Traditional pairings (nuts, tahini, Arabic coffee, date syrup, ma'amoul, khoshaf) and modern ones","description":"Traditional pairings (nuts, tahini, Arabic coffee, date syrup, ma'amoul, khoshaf) and modern ones\n    (cheese, dark chocolate, bacon-wrapped dates, smoothies, date-sweetened baking). Use for \"what goes well\n    with dates\", \"traditional ways to eat dates\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"culinary_pairing_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/cultivation_basics":{"post":{"operationId":"cultivation_basics","summary":"Date-palm cultivation basics: pollination biology and the historical hand-pollination practice, harvest","description":"Date-palm cultivation basics: pollination biology and the historical hand-pollination practice, harvest\n    season timing, and general climate/soil requirements — a general reference, not a personalized growing\n    guide. Use for \"how are date palms pollinated\", \"when are dates harvested\", \"what climate do date palms\n    need\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"cultivation_basicsArguments","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_guide":{"post":{"operationId":"storage_guide","summary":"How to store dates by ripeness stage and variety for freshness — from highly perishable fresh khalal/","description":"How to store dates by ripeness stage and variety for freshness — from highly perishable fresh khalal/\n    rutab to shelf-stable tamr, plus notes on sugar crystallization versus mold. Use for \"how do I store dates\n    so they don't dry out\", \"is the white film on my dates mold\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"storage_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/date_glossary":{"post":{"operationId":"date_glossary","summary":"Definitions of common date-palm and dates terms (tamr, rutab, khalal, kimri, dibs, nawah, khoos, jummar,","description":"Definitions of common date-palm and dates terms (tamr, rutab, khalal, kimri, dibs, nawah, khoos, jummar,\n    and more). Use for \"what does dibs mean\", \"what is a nawah\".","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":"date_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}}}}