{"openapi":"3.1.0","info":{"title":"Vivah (Wedding) API","version":"0.1.0","description":"A fully local Indian wedding rituals & planning reference: ritual meanings, significance and sequence-placement, regional variation, a planning checklist, a guest-list estimator, a budget guide, an attire guide, gift etiquette and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://vivah.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/vivah/docs"},"termsOfService":"https://connectorbay.com/vivah/terms"},"servers":[{"url":"https://vivah.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/vivah/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 wedding ritual's description, significance, and typical timing/sequence placement. Use for \"what","description":"A single wedding ritual's description, significance, and typical timing/sequence placement. Use for \"what\n    is the haldi ceremony\", \"what happens during kanyadaan\", \"when does vidaai happen\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A ritual's name, or a close alias.","examples":["haldi","saat phere","kanyadaan","vidaai"],"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 wedding rituals by keyword across their name, description, significance and associated","description":"Search wedding rituals by keyword across their name, description, significance and associated\n    traditions. Use for \"which rituals involve fire\", \"find rituals about the bride leaving home\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A keyword to search across ritual names, descriptions, significance and traditions.","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/rituals_by_region":{"post":{"operationId":"rituals_by_region","summary":"A regional wedding tradition's overview and distinctive ritual notes (North Indian/Hindi-belt, Punjabi,","description":"A regional wedding tradition's overview and distinctive ritual notes (North Indian/Hindi-belt, Punjabi,\n    Bengali, Gujarati, Marathi, Tamil/South Indian, or Kashmiri Pandit), plus which of this connector's rituals\n    are associated with that region. Use for \"what's different about a Bengali wedding\", \"Punjabi wedding\n    traditions\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A regional tradition.","examples":["Punjabi","Bengali","Tamil","Kashmiri Pandit"],"minLength":1,"title":"Region","type":"string"}},"required":["region"],"title":"rituals_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_checklist":{"post":{"operationId":"wedding_checklist","summary":"A wedding-planning timeline checklist covering venue, catering, invitations, attire and rituals booking,","description":"A wedding-planning timeline checklist covering venue, catering, invitations, attire and rituals booking,\n    from about six months out through the wedding day. Pass months_before to get just the closest milestone, or\n    omit it for the full timeline. Use for \"what should I be doing 3 months before my wedding\", \"give me a full\n    wedding planning checklist\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"months_before":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"How many months before the wedding (0 = day-of; fractional values like 0.5 for '2 weeks before' are fine). Omit for the full timeline.","title":"Months Before"}},"title":"wedding_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/guest_list_estimator":{"post":{"operationId":"guest_list_estimator","summary":"A rough, capacity-based suggested invite count across a few no-show scenarios. A planning aid only, not a","description":"A rough, capacity-based suggested invite count across a few no-show scenarios. A planning aid only, not a\n    guarantee of attendance. Use for \"how many people should I invite for a 300-seat hall\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"venue_capacity":{"description":"The venue's seating or standing capacity.","exclusiveMinimum":0,"title":"Venue Capacity","type":"integer"}},"required":["venue_capacity"],"title":"guest_list_estimatorArguments","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/budget_breakdown_guide":{"post":{"operationId":"budget_breakdown_guide","summary":"A rough, percentage-based allocation of a total wedding budget across venue, catering, attire, decor,","description":"A rough, percentage-based allocation of a total wedding budget across venue, catering, attire, decor,\n    photography, jewelry and miscellaneous. A general starting-point guideline, not a fixed rule or financial\n    advice. Use for \"how should I split a 20 lakh wedding budget\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"total_budget":{"description":"The total wedding budget, in any currency — the tool only returns percentages and proportional amounts.","exclusiveMinimum":0,"title":"Total Budget","type":"number"}},"required":["total_budget"],"title":"budget_breakdown_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/attire_guide":{"post":{"operationId":"attire_guide","summary":"What's typically worn at a given wedding ceremony (colors and attire style), phrased as common","description":"What's typically worn at a given wedding ceremony (colors and attire style), phrased as common\n    convention — real choices vary by region, family and personal taste. Use for \"what should I wear to a\n    haldi ceremony\", \"what color is worn at an Indian wedding\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ceremony":{"description":"A wedding ceremony/event.","examples":["haldi","mehendi","sangeet","wedding","reception","roka"],"minLength":1,"title":"Ceremony","type":"string"}},"required":["ceremony"],"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/gift_etiquette_guide":{"post":{"operationId":"gift_etiquette_guide","summary":"Traditional Indian wedding gift-giving norms — odd-denomination cash gifts, jewelry customs, return","description":"Traditional Indian wedding gift-giving norms — odd-denomination cash gifts, jewelry customs, return\n    gifts and more — phrased as common custom, not a universal rule. Use for \"how much cash should I gift at an\n    Indian wedding\", \"wedding gift etiquette\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"gift_etiquette_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/wedding_glossary":{"post":{"operationId":"wedding_glossary","summary":"Definitions of common Indian wedding terms (baraat, shagun, trousseau, mandap, pheras, vidaai, and","description":"Definitions of common Indian wedding terms (baraat, shagun, trousseau, mandap, pheras, vidaai, and\n    more). Use for \"what does baraat mean\", \"what's a mandap\".","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}}}}