{"openapi":"3.1.0","info":{"title":"Malabis (Attire) API","version":"0.1.0","description":"A fully local Arab/MENA traditional-clothing reference: garment profiles across the Gulf, Levant, Egypt and the Maghreb, a tatreez embroidery guide, a headwear guide, occasion dress conventions, traditional fabrics and craft techniques, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://malabis.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/malabis/docs"},"termsOfService":"https://connectorbay.com/malabis/terms"},"servers":[{"url":"https://malabis.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/malabis/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/garment_info":{"post":{"operationId":"garment_info","summary":"One traditional Arab/MENA garment's description, region, materials and typical occasions worn. Use for","description":"One traditional Arab/MENA garment's description, region, materials and typical occasions worn. Use for\n    \"what is a bisht\", \"tell me about the takchita\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A garment's name.","examples":["thobe","bisht","abaya","jellaba","kaftan"],"title":"Name","type":"string"}},"required":["name"],"title":"garment_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/garment_search":{"post":{"operationId":"garment_search","summary":"Search traditional Arab/MENA garments by keyword, matched against name, description, region, gender","description":"Search traditional Arab/MENA garments by keyword, matched against name, description, region, gender\n    category, occasion and material. Use for \"which garments are worn in the Maghreb\", \"what's worn for Eid\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search across garment name, description, region, gender category, occasion or material.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"garment_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/garments_by_region":{"post":{"operationId":"garments_by_region","summary":"Traditional garments associated with one of four regions — Gulf, Levantine, Egyptian, Maghrebi. Use for","description":"Traditional garments associated with one of four regions — Gulf, Levantine, Egyptian, Maghrebi. Use for\n    \"what's worn in the Gulf\", \"clothing traditions of the Maghreb\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A region.","examples":["Gulf","Levantine","Egyptian","Maghrebi"],"title":"Region","type":"string"}},"required":["region"],"title":"garments_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/garments_by_gender_category":{"post":{"operationId":"garments_by_gender_category","summary":"Traditional garments for men's, women's, or unisex/children's wear. Use for \"what do men traditionally","description":"Traditional garments for men's, women's, or unisex/children's wear. Use for \"what do men traditionally\n    wear in the Gulf\", \"traditional women's garments\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"A gender category.","examples":["men's","women's","unisex/children's"],"title":"Category","type":"string"}},"required":["category"],"title":"garments_by_gender_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/tatreez_embroidery_guide":{"post":{"operationId":"tatreez_embroidery_guide","summary":"The Palestinian/Levantine tatreez cross-stitch embroidery tradition: regional village styles (Ramallah,","description":"The Palestinian/Levantine tatreez cross-stitch embroidery tradition: regional village styles (Ramallah,\n    Bethlehem, Hebron, Gaza, Galilee, Naqab Bedouin) with characteristic colors, common motifs, and the\n    counted cross-stitch and couching techniques used. Use for \"what is tatreez\", \"what does the cypress tree\n    motif mean in Palestinian embroidery\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"tatreez_embroidery_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/headwear_guide":{"post":{"operationId":"headwear_guide","summary":"Traditional Arab/MENA headwear — ghutra/keffiyeh with agal, hatta, hijab, niqab, tarboosh/fez, shayla,","description":"Traditional Arab/MENA headwear — ghutra/keffiyeh with agal, hatta, hijab, niqab, tarboosh/fez, shayla,\n    taqiyah — with styles and regional variation, described purely as clothing (fabric, style, regional\n    variation), never as religious instruction. Use for \"how is a ghutra worn\", \"what's the difference between\n    a hijab and a niqab\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"headwear_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/occasion_guide":{"post":{"operationId":"occasion_guide","summary":"What's traditionally worn, by region, for weddings, Eid, everyday wear, or formal events — described as","description":"What's traditionally worn, by region, for weddings, Eid, everyday wear, or formal events — described as\n    widely-observed convention, not a rule. For wedding customs and celebration traditions beyond attire, see\n    the zafaf connector. Use for \"what's worn for an Arab wedding\", \"what do people wear for Eid\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"occasion":{"description":"An occasion.","examples":["wedding","Eid","everyday","formal event"],"title":"Occasion","type":"string"}},"required":["occasion"],"title":"occasion_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/fabric_and_craft_info":{"post":{"operationId":"fabric_and_craft_info","summary":"A traditional Arab/MENA fabric (silk, cotton, wool, leather) or craft technique (sadu weaving, talli","description":"A traditional Arab/MENA fabric (silk, cotton, wool, leather) or craft technique (sadu weaving, talli\n    embroidery, tatreez, aghabani, sfifa braiding, fez felting) — origin, description and what it's used for.\n    Use for \"what is sadu weaving\", \"what fabric is a bisht made from\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"description":"A fabric or craft technique.","examples":["silk","sadu weaving","talli","tatreez","sfifa"],"title":"Term","type":"string"}},"required":["term"],"title":"fabric_and_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/attire_glossary":{"post":{"operationId":"attire_glossary","summary":"Definitions of craft and material terms used across Arab/MENA clothing (tatreez, talli, sadu, aghabani,","description":"Definitions of craft and material terms used across Arab/MENA clothing (tatreez, talli, sadu, aghabani,\n    sfifa, qob, harir, qutn, souf, jild, khait dahabi, hzam, mashru, aba). Use for \"what does talli mean\",\n    \"what's a hzam\".","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":"attire_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}}}}