{"openapi":"3.1.0","info":{"title":"Zafaf (Wedding) API","version":"0.1.0","description":"A fully local Arab wedding traditions & planning reference: rituals and customs by region (Levantine, Gulf/Khaleeji, Egyptian, Maghrebi), the marriage-contract custom (katb al-kitab) and mahr explained factually, the henna night and zaffa procession, an attire guide, gift customs, a planning checklist and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://zafaf.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/zafaf/docs"},"termsOfService":"https://connectorbay.com/zafaf/terms"},"servers":[{"url":"https://zafaf.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/zafaf/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/ritual_info":{"post":{"operationId":"ritual_info","summary":"A single Arab wedding ritual or custom's description, significance, and typical timing/sequence","description":"A single Arab wedding ritual or custom's description, significance, and typical timing/sequence\n    placement. Use for \"what is katb al-kitab\", \"what happens during the henna night\", \"when does the zaffa\n    happen\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A wedding ritual or custom's name, or a close alias.","examples":["katb al-kitab","laylat al-henna","zaffa","shabka"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"ritual_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/ritual_search":{"post":{"operationId":"ritual_search","summary":"Search Arab wedding rituals and customs by keyword across their name, description, significance and","description":"Search Arab wedding rituals and customs by keyword across their name, description, significance and\n    associated regions. Use for \"which customs involve music\", \"find rituals about the bride's procession\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A keyword to search across ritual names, descriptions, significance and associated regions.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"ritual_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/traditions_by_region":{"post":{"operationId":"traditions_by_region","summary":"A regional Arab wedding tradition's overview and distinctive notes (Levantine, Gulf/Khaleeji, Egyptian,","description":"A regional Arab wedding tradition's overview and distinctive notes (Levantine, Gulf/Khaleeji, Egyptian,\n    or Maghrebi), plus which of this connector's rituals are associated with that region. Use for \"what's\n    different about a Gulf wedding\", \"tell me about Moroccan wedding traditions\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A regional tradition.","examples":["Levantine","Gulf","Egyptian","Maghrebi"],"minLength":1,"title":"Region","type":"string"}},"required":["region"],"title":"traditions_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/wedding_timeline":{"post":{"operationId":"wedding_timeline","summary":"The typical end-to-end sequence of events across an Arab wedding celebration: engagement (khitba),","description":"The typical end-to-end sequence of events across an Arab wedding celebration: engagement (khitba),\n    the marriage contract (katb al-kitab), the henna night, wedding-day events (the zaffa, the walima), and\n    post-wedding customs — in order, with typical timing for each. A typical shape, not a fixed schedule; the\n    contract stage in particular can move earlier or later depending on family and country. Use for \"what's\n    the order of events at an Arab wedding\", \"walk me through a typical Arab wedding\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"wedding_timelineArguments","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_guide":{"post":{"operationId":"attire_guide","summary":"What's typically worn at an Arab wedding by role — bride, groom or guests — and how that varies across","description":"What's typically worn at an Arab wedding by role — bride, groom or guests — and how that varies across\n    Levantine, Gulf/Khaleeji, Egyptian and Maghrebi tradition, phrased as common convention. Omit role for the\n    full guide across all three. Use for \"what should the groom wear to a Khaleeji wedding\", \"what does a\n    Moroccan bride wear\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"role":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A role to get attire guidance for (bride, groom, or guests); omit for the full guide.","title":"Role"}},"title":"attire_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/music_and_zaffa_guide":{"post":{"operationId":"music_and_zaffa_guide","summary":"The zaffa wedding-procession tradition: typical instruments, its call-and-response singing style (no","description":"The zaffa wedding-procession tradition: typical instruments, its call-and-response singing style (no\n    lyrics reproduced), its connection to Levantine dabke, and regional variation (the Gulf's ardah, Egypt's\n    band-led scale, Maghrebi neggafa-led processions). Use for \"what instruments are used in a zaffa\", \"what's\n    the connection between dabke and the zaffa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"music_and_zaffa_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/gift_and_dowry_customs":{"post":{"operationId":"gift_and_dowry_customs","summary":"The mahr explained factually and neutrally — a customary, contractual gift from the groom to the","description":"The mahr explained factually and neutrally — a customary, contractual gift from the groom to the\n    bride agreed as part of the marriage contract, in whatever form and scale the couple and families agree,\n    with no universal or expected amount ever stated here — plus guest gift-giving customs (cash gifts, gold\n    from close family, return favors). Optionally pass a region for a region-specific note. Use for \"what is\n    the mahr\", \"how much should the mahr be\" (this connector explains what it is and how it's set, and\n    deliberately does not answer with a figure), \"what do guests typically give at an Arab wedding\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optionally, a region for a region-specific note (Levantine, Gulf, Egyptian, Maghrebi).","title":"Region"}},"title":"gift_and_dowry_customsArguments","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/planning_checklist":{"post":{"operationId":"planning_checklist","summary":"A full wedding-planning timeline checklist, from about six months out through the wedding day, covering","description":"A full wedding-planning timeline checklist, from about six months out through the wedding day, covering\n    venue, catering, invitations, attire and the specific touchpoints of these traditions — laylat al-henna,\n    the zaffa band, and the katb al-kitab paperwork and officiant. Use for \"give me an Arab wedding planning\n    checklist\", \"what should I be doing a month before my wedding\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"planning_checklistArguments","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/wedding_glossary":{"post":{"operationId":"wedding_glossary","summary":"Definitions of common Arab wedding terms (mahr, katb al-kitab, zaffa, laylat al-henna, dabke, ardah,","description":"Definitions of common Arab wedding terms (mahr, katb al-kitab, zaffa, laylat al-henna, dabke, ardah,\n    neggafa, and more). Use for \"what does mahr mean\", \"what's dabke\".","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":"wedding_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}}}}