{"openapi":"3.1.0","info":{"title":"Khayma (Tent) API","version":"0.1.0","description":"A fully local Bedouin nomadic material-culture reference: bayt al-sha'ar tent construction and weaving, tent layout and its hospitality meaning, pastoralism and seasonal migration, nomadic-life objects, textile technique, tent hospitality customs, and a neutral note on the modern transition to settled life.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://khayma.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/khayma/docs"},"termsOfService":"https://connectorbay.com/khayma/terms"},"servers":[{"url":"https://khayma.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/khayma/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/tent_construction_info":{"post":{"operationId":"tent_construction_info","summary":"The goat-hair weaving material and technique behind the bayt al-sha'ar tent, the horizontal ground","description":"The goat-hair weaving material and technique behind the bayt al-sha'ar tent, the horizontal ground\n    loom ('nol') it is woven on, how narrow woven panels are sewn into a full roof sheet, and how the\n    finished cloth, center poles ('amoud'), side walls and guy ropes come together into the pitched tent.\n    Use for \"how is a Bedouin tent made\", \"what loom is used to weave a bayt al-sha'ar\", \"why is the tent made\n    of goat hair\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"tent_construction_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/tent_layout_guide":{"post":{"operationId":"tent_layout_guide","summary":"The traditional division of a bayt al-sha'ar's interior — the ma'nad curtain splitting the shiqq","description":"The traditional division of a bayt al-sha'ar's interior — the ma'nad curtain splitting the shiqq\n    (men's/guest reception side) from the family side — and its social and hospitality function, cross-\n    referencing the `turath` connector's majlis_custom_guide for the settled-house version of the same\n    custom rather than duplicating it. Use for \"what's the men's side of a Bedouin tent called\", \"how is a\n    Bedouin tent divided\", \"what is a ma'nad\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"tent_layout_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/nomadic_life_info":{"post":{"operationId":"nomadic_life_info","summary":"Bedouin pastoralism and herding basics, seasonal migration (transhumance), water and wells, and the","description":"Bedouin pastoralism and herding basics, seasonal migration (transhumance), water and wells, and the\n    camel's central role in nomadic life. Omit topic to get all four. Use for \"how did Bedouin herd\n    livestock\", \"what is transhumance\", \"why was the camel so important to Bedouin life\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"pastoralism-herding | seasonal-migration | water-and-wells | camel-culture. Omit to list all four.","title":"Topic"}},"title":"nomadic_life_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/object_info":{"post":{"operationId":"object_info","summary":"One traditional nomadic-life object's description and use — the khurj saddlebag, shakwa goatskin","description":"One traditional nomadic-life object's description and use — the khurj saddlebag, shakwa goatskin\n    churn, mihbash mortar and hand mill, sadu-woven floor rugs, girba waterskin, shugduf camel litter, or\n    amoud tent pole. Use for \"what's a khurj\", \"what is a shakwa used for\", \"what's a shugduf\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A nomadic-life object's name or alias.","examples":["khurj","shakwa","mihbash","girba","shugduf","amoud"],"title":"Name","type":"string"}},"required":["name"],"title":"object_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/object_search":{"post":{"operationId":"object_search","summary":"Search all nomadic-life objects by partial name, alias, category, or a word from its description or","description":"Search all nomadic-life objects by partial name, alias, category, or a word from its description or\n    use. Use for \"what objects were used to transport water\", \"nomadic tools for making butter\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial name, alias, category, or a word from an object's description or use.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"object_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/textile_technique_guide":{"post":{"operationId":"textile_technique_guide","summary":"Goat-hair and wool weaving technique on the Bedouin ground loom, distinguishing plain structural tent","description":"Goat-hair and wool weaving technique on the Bedouin ground loom, distinguishing plain structural tent\n    cloth from decorative flat-woven rugs, cushions and saddlebags, and explaining how both relate to — and\n    differ from — the separate Turkish/Persian kilim tradition. Use for \"how is sadu different from a\n    kilim\", \"is Bedouin weaving the same as a kilim\", \"what's the difference between tent cloth and a rug\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"textile_technique_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/hospitality_in_the_tent_guide":{"post":{"operationId":"hospitality_in_the_tent_guide","summary":"Guest-receiving customs specific to tent life — the arrival custom of sheltering and feeding a guest","description":"Guest-receiving customs specific to tent life — the arrival custom of sheltering and feeding a guest\n    before questioning them, the traditional duration and obligation of hospitality, and how a household's\n    hospitality reflected on its reputation — cross-referencing the dedicated `qahwa` connector for coffee\n    preparation, equipment and serving etiquette rather than duplicating it. Use for \"how are guests received\n    in a Bedouin tent\", \"how long is a guest traditionally hosted\", \"why is hospitality so important to\n    Bedouin culture\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"hospitality_in_the_tent_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/modern_transition_info":{"post":{"operationId":"modern_transition_info","summary":"A factual, neutral note on the shift from nomadic tent-based pastoral life to settled or urban life","description":"A factual, neutral note on the shift from nomadic tent-based pastoral life to settled or urban life\n    across the Arabian Peninsula and wider region — its historical drivers, current status, and the living\n    cultural practices that continue today. Neither romanticizes the nomadic past nor disparages it: fully\n    nomadic tent life is described as a small minority lifestyle today, not as a loss or as something\n    backward. Use for \"do Bedouin still live in tents\", \"why did Bedouin settle down\", \"is nomadic life still\n    practiced today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"modern_transition_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/nomadic_glossary":{"post":{"operationId":"nomadic_glossary","summary":"Definitions of common Bedouin nomadic-life terms (bayt al-sha'ar, shiqq, ma'nad, nol, khurj, shakwa,","description":"Definitions of common Bedouin nomadic-life terms (bayt al-sha'ar, shiqq, ma'nad, nol, khurj, shakwa,\n    rahil, amoud, girba, transhumance, sadu, badu/Bedouin). Use for \"what does shiqq mean\", \"what is rahil\",\n    \"what does ma'nad mean\".","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":"nomadic_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}}}}