{"openapi":"3.1.0","info":{"title":"Vastu API","version":"0.1.0","description":"A fully local Vastu Shastra home/office design reference: ideal room directions, the eight directions plus center, entrance guidance, dosha remedies, the five-element framework, plot-shape guidance, color suggestions, a glossary and pre-purchase checklists.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://vastu.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/vastu/docs"},"termsOfService":"https://connectorbay.com/vastu/terms"},"servers":[{"url":"https://vastu.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/vastu/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/room_placement":{"post":{"operationId":"room_placement","summary":"The traditional ideal direction(s) for a room or zone, the rationale behind it, common alternatives, and","description":"The traditional ideal direction(s) for a room or zone, the rationale behind it, common alternatives, and\n    directions to avoid where the tradition specifies them. Use for \"which direction should my kitchen face\",\n    \"where should the pooja room go\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"room":{"description":"A room or zone type.","examples":["kitchen","master bedroom","pooja room","toilet","study room","main entrance","staircase","living room","dining room","guest bedroom"],"title":"Room","type":"string"}},"required":["room"],"title":"room_placementArguments","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/direction_guide":{"post":{"operationId":"direction_guide","summary":"A direction's traditional Vastu significance: its ruling element, its guardian deity (Dikpala) in the","description":"A direction's traditional Vastu significance: its ruling element, its guardian deity (Dikpala) in the\n    generic tradition, and what's traditionally favorable to place there. Use for \"what does the northeast\n    represent in Vastu\", \"what governs the southwest corner\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"direction":{"description":"One of the 8 main directions, or center/Brahmasthan.","examples":["north","northeast","east","southeast","south","southwest","west","northwest","center"],"title":"Direction","type":"string"}},"required":["direction"],"title":"direction_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/entrance_analysis":{"post":{"operationId":"entrance_analysis","summary":"Guidance for a main door or plot that faces a given direction — how favorable the tradition considers it,","description":"Guidance for a main door or plot that faces a given direction — how favorable the tradition considers it,\n    which portion of the wall is generally preferred, and a high-level note on the traditional 32-entrance (pada)\n    system. Use for \"is a south-facing house bad Vastu\", \"which part of the east wall should the door be on\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"facing_direction":{"description":"The direction the main door or plot faces.","examples":["north","east","southeast","south","southwest","west","northwest"],"title":"Facing Direction","type":"string"}},"required":["facing_direction"],"title":"entrance_analysisArguments","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/vastu_dosha_remedies":{"post":{"operationId":"vastu_dosha_remedies","summary":"Common traditional remedies for a stated Vastu dosha (layout imbalance) — searches roughly 20 commonly","description":"Common traditional remedies for a stated Vastu dosha (layout imbalance) — searches roughly 20 commonly\n    discussed issues and their traditional remedy suggestions. Use for \"how do I fix a toilet in the northeast\",\n    \"remedy for a missing corner\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"issue":{"description":"A Vastu imbalance (dosha) to search for.","examples":["toilet in northeast","kitchen in northwest","missing corner","beam above bed","main door facing south"],"title":"Issue","type":"string"}},"required":["issue"],"title":"vastu_dosha_remediesArguments","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/element_balance":{"post":{"operationId":"element_balance","summary":"The Pancha Bhoota (five-element) framework: which directions and rooms one element traditionally governs,","description":"The Pancha Bhoota (five-element) framework: which directions and rooms one element traditionally governs,\n    its associated qualities, and a short balancing tip. Use for \"what does the fire element govern in Vastu\",\n    \"which rooms belong to the water element\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"element":{"description":"One of the five elements (Pancha Bhoota).","examples":["earth","water","fire","air","space"],"title":"Element","type":"string"}},"required":["element"],"title":"element_balanceArguments","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/plot_shape_guide":{"post":{"operationId":"plot_shape_guide","summary":"Traditional guidance for a plot or building shape — whether it's considered auspicious as-is or generally","description":"Traditional guidance for a plot or building shape — whether it's considered auspicious as-is or generally\n    needs a remedy, and why. Use for \"is an L-shaped plot bad Vastu\", \"is a triangular plot okay\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"shape":{"description":"A plot or building shape.","examples":["square","rectangular","L-shaped","triangular","irregular","circular"],"title":"Shape","type":"string"}},"required":["shape"],"title":"plot_shape_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/color_guide":{"post":{"operationId":"color_guide","summary":"Traditionally suggested colors for a room, or for a direction. Use for \"what color should I paint my","description":"Traditionally suggested colors for a room, or for a direction. Use for \"what color should I paint my\n    kitchen\", \"best colors for the southwest corner\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"room_or_direction":{"description":"A room type or a direction.","examples":["kitchen","master bedroom","pooja room","north","southeast","southwest"],"title":"Room Or Direction","type":"string"}},"required":["room_or_direction"],"title":"color_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/vastu_glossary":{"post":{"operationId":"vastu_glossary","summary":"Definitions of core Vastu terms (Brahmasthan, Vastu Purusha Mandala, dosha, pada, Pancha Bhoota, Dikpala,","description":"Definitions of core Vastu terms (Brahmasthan, Vastu Purusha Mandala, dosha, pada, Pancha Bhoota, Dikpala,\n    Ishanya, Nairutya, ...). Use for \"what is Brahmasthan\", \"what does dosha mean in Vastu\".","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":"vastu_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}},"/v1/tools/checklist":{"post":{"operationId":"checklist","summary":"A quick pre-purchase or pre-construction Vastu checklist for an apartment, an independent house, or an","description":"A quick pre-purchase or pre-construction Vastu checklist for an apartment, an independent house, or an\n    office, pulling together the most commonly cited checks. Use for \"give me a Vastu checklist before buying a\n    flat\", \"what should I check for Vastu before building a house\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"property_type":{"description":"apartment | independent_house | office","examples":["apartment","independent house","office"],"title":"Property Type","type":"string"}},"required":["property_type"],"title":"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}}}}