{"openapi":"3.1.0","info":{"title":"Turath (Heritage) API","version":"0.1.0","description":"A fully local Arab folk heritage and traditional handicrafts reference: 18 crafts and heritage practices, craft materials, general heritage-architecture types, falconry heritage (UNESCO-listed), majlis custom, and oral heritage traditions.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://turath.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/turath/docs"},"termsOfService":"https://connectorbay.com/turath/terms"},"servers":[{"url":"https://turath.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/turath/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/craft_info":{"post":{"operationId":"craft_info","summary":"One traditional craft or heritage practice's description, region, materials and technique — covers 18","description":"One traditional craft or heritage practice's description, region, materials and technique — covers 18\n    crafts and practices, from sadu weaving and khous palm-frond weaving to Damascene mother-of-pearl inlay,\n    copper/brass metalwork, Bedouin silver jewelry and Arabic calligraphy. Use for \"what is sadu weaving\",\n    \"tell me about Damascene inlay\", \"what's talli\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A traditional craft or heritage practice's name or Arabic alias.","examples":["sadu weaving","khous","talli","damascene inlay","khanjar"],"title":"Name","type":"string"}},"required":["name"],"title":"craft_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/craft_search":{"post":{"operationId":"craft_search","summary":"Search all traditional crafts and heritage practices by partial name, alias, region, material or","description":"Search all traditional crafts and heritage practices by partial name, alias, region, material or\n    technique. Use for \"crafts that use mother of pearl\", \"which craft uses palm fronds\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial name, alias, region, material, or a word from a craft's description or technique.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"craft_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/crafts_by_region":{"post":{"operationId":"crafts_by_region","summary":"Traditional crafts and heritage practices characteristic of a region — Arabian Peninsula/Gulf, Levant,","description":"Traditional crafts and heritage practices characteristic of a region — Arabian Peninsula/Gulf, Levant,\n    Yemen, Oman, Egypt, or practices shared Pan-Arab. Use for \"what crafts come from the Gulf\", \"heritage\n    crafts of Yemen\", \"Levant handicrafts\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Arabian Peninsula/Gulf | Levant | Yemen | Oman | Egypt | Pan-Arab (or a country name like UAE, Syria, Saudi Arabia).","title":"Region","type":"string"}},"required":["region"],"title":"crafts_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/falconry_heritage_info":{"post":{"operationId":"falconry_heritage_info","summary":"A factual, historical overview of falconry as an Arab heritage practice — its roots in Bedouin desert","description":"A factual, historical overview of falconry as an Arab heritage practice — its roots in Bedouin desert\n    life, its UNESCO Intangible Cultural Heritage status (first inscribed 2010, extended several times since),\n    traditional equipment terms, and a note on modern, conservation-regulated practice (captive breeding,\n    licensing, CITES trade restrictions). Not guidance for acquiring or keeping a wild bird of prey. Use for\n    \"is falconry UNESCO-listed\", \"what is falconry heritage\", \"how is falconry regulated today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"falconry_heritage_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/majlis_custom_guide":{"post":{"operationId":"majlis_custom_guide","summary":"The traditional Gulf/Arabian Peninsula majlis gathering, seating and hospitality custom — layout,","description":"The traditional Gulf/Arabian Peninsula majlis gathering, seating and hospitality custom — layout,\n    Arabic coffee (gahwa) and incense (bakhoor) hospitality etiquette, its social role, and its own 2015\n    UNESCO Intangible Cultural Heritage listing. Use for \"what happens at a majlis\", \"how is Arabic coffee\n    served at a majlis\", \"is majlis UNESCO-listed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"majlis_custom_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/heritage_site_type_info":{"post":{"operationId":"heritage_site_type_info","summary":"General categories of Arab heritage architecture — barjeel wind towers, old souq architecture,","description":"General categories of Arab heritage architecture — barjeel wind towers, old souq architecture,\n    mud-brick construction, coral-stone construction, and mashrabiya lattice screens — described\n    typologically, not as a directory of specific standing sites. Use for \"what's a barjeel\", \"what is\n    mud-brick construction used for\", \"how does a wind tower work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A heritage-architecture category, e.g. barjeel, wind tower, souq, mud brick, coral stone, mashrabiya. Omit to list all.","title":"Type"}},"title":"heritage_site_type_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/craft_materials_guide":{"post":{"operationId":"craft_materials_guide","summary":"Sourcing and traditional use for a craft material — sadu wool/goat hair/camel hair, palm frond (khous),","description":"Sourcing and traditional use for a craft material — sadu wool/goat hair/camel hair, palm frond (khous),\n    mother-of-pearl (sadaf), copper and brass, silver, clay, camel/goat/sheep leather, and henna leaf — and\n    which crafts each one is used in. Use for \"what is sadu wool\", \"where does mother of pearl inlay material\n    come from\", \"what is khous made from\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"material":{"description":"A craft material's name.","examples":["sadu wool","palm frond","mother of pearl","copper","silver","clay","henna leaf"],"title":"Material","type":"string"}},"required":["material"],"title":"craft_materials_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/oral_heritage_info":{"post":{"operationId":"oral_heritage_info","summary":"A factual note on Arab oral poetry, storytelling and performance heritage traditions — Nabati (Bedouin)","description":"A factual note on Arab oral poetry, storytelling and performance heritage traditions — Nabati (Bedouin)\n    poetry, hakawati coffeehouse storytelling, and Al-Ayyala performance poetry — cross-referencing the\n    dedicated `hikaya` connector for folk tales and `adab` for poetry, rather than duplicating them. Use for\n    \"what is Nabati poetry\", \"what's a hakawati\", \"Arab oral storytelling tradition\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"oral_heritage_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/heritage_glossary":{"post":{"operationId":"heritage_glossary","summary":"Definitions of common Arab heritage terms (turath, sadu, khous, majlis, gahwa, bakhoor, sadaf, barjeel,","description":"Definitions of common Arab heritage terms (turath, sadu, khous, majlis, gahwa, bakhoor, sadaf, barjeel,\n    nakhoda, nahham, bisht, khatt). Use for \"what does turath mean\", \"what's gahwa\", \"what is bakhoor\".","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":"heritage_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}}}}