{"openapi":"3.1.0","info":{"title":"Prakriti (Constitution) API","version":"0.1.0","description":"A fully local Ayurveda traditional-wellness reference: a dosha constitution quiz, dosha characteristics and traditional balancing tips, the dinacharya and ritucharya routine frameworks, a traditional herb reference, the six tastes, a food-dosha guide, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://prakriti.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/prakriti/docs"},"termsOfService":"https://connectorbay.com/prakriti/terms"},"servers":[{"url":"https://prakriti.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/prakriti/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/dosha_quiz":{"post":{"operationId":"dosha_quiz","summary":"A short traditional Vata/Pitta/Kapha self-assessment quiz (8-10 questions on body frame, appetite, sleep,","description":"A short traditional Vata/Pitta/Kapha self-assessment quiz (8-10 questions on body frame, appetite, sleep,\n    temperament, skin, and more): call with no arguments for the questions, then call again with `answers` for a\n    tallied result. Use for \"what's my dosha\", \"am I Vata, Pitta, or Kapha\". This is a traditional self-assessment\n    for cultural and educational interest, not a medical or diagnostic tool.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"answers":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"default":null,"description":"Question-key to option-index (0-2) map, where 0=Vata, 1=Pitta, 2=Kapha for every question. Omit to get the questions first.","title":"Answers"}},"title":"dosha_quizArguments","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/dosha_info":{"post":{"operationId":"dosha_info","summary":"Traditional characteristics of Vata, Pitta, or Kapha: elements, qualities (guna), what each traditionally","description":"Traditional characteristics of Vata, Pitta, or Kapha: elements, qualities (guna), what each traditionally\n    governs, and commonly described physical and mental traits. Use for \"what does Pitta mean in Ayurveda\", \"what\n    are Kapha traits\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dosha":{"description":"Vata, Pitta, or Kapha.","examples":["Vata","Pitta","Kapha"],"title":"Dosha","type":"string"}},"required":["dosha"],"title":"dosha_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/balancing_tips":{"post":{"operationId":"balancing_tips","summary":"Traditional diet and lifestyle suggestions associated with balancing Vata, Pitta, or Kapha, phrased as what","description":"Traditional diet and lifestyle suggestions associated with balancing Vata, Pitta, or Kapha, phrased as what\n    Ayurvedic tradition says — never a treatment claim. Use for \"how do I balance Vata\", \"what should Pitta types\n    eat\". Always consult a qualified practitioner or your doctor before making significant diet or lifestyle\n    changes.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dosha":{"description":"Vata, Pitta, or Kapha.","examples":["Vata","Pitta","Kapha"],"title":"Dosha","type":"string"}},"required":["dosha"],"title":"balancing_tipsArguments","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/dinacharya_guide":{"post":{"operationId":"dinacharya_guide","summary":"The traditional Ayurvedic daily-routine framework (dinacharya): waking time, tongue scraping, oil pulling,","description":"The traditional Ayurvedic daily-routine framework (dinacharya): waking time, tongue scraping, oil pulling,\n    self-massage (abhyanga), exercise, and meal timing, described as cultural practice. Use for \"what's\n    dinacharya\", \"what's the Ayurvedic morning routine\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"dinacharya_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/ritucharya_guide":{"post":{"operationId":"ritucharya_guide","summary":"The traditional Ayurvedic seasonal-routine framework (ritucharya): diet and lifestyle adjustments across","description":"The traditional Ayurvedic seasonal-routine framework (ritucharya): diet and lifestyle adjustments across\n    the six seasons (ritus) of the Ayurvedic calendar. Use for \"what should I eat in monsoon season\", \"Ayurvedic\n    winter routine\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A season: spring, summer, monsoon, autumn, early winter/winter, or late winter — or the Sanskrit ritu name (Vasant, Grishma, Varsha, Sharad, Hemant, Shishira). Omit to list all six.","examples":["spring","monsoon","winter","Sharad"],"title":"Season"}},"title":"ritucharya_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/herb_reference":{"post":{"operationId":"herb_reference","summary":"Common herbs used in Ayurvedic tradition (turmeric, ashwagandha, tulsi/holy basil, triphala, brahmi, neem,","description":"Common herbs used in Ayurvedic tradition (turmeric, ashwagandha, tulsi/holy basil, triphala, brahmi, neem,\n    and more) with their traditionally described uses — labelled as traditional use, not an efficacy claim. Use\n    for \"what is ashwagandha traditionally used for\", \"what is triphala\". Not evaluated by any medical authority;\n    consult a doctor before use, especially if pregnant, nursing, or on medication.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A common Ayurvedic herb, by common or Sanskrit name. Omit to list all.","examples":["turmeric","ashwagandha","tulsi","triphala","brahmi","neem"],"title":"Name"}},"title":"herb_referenceArguments","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/taste_guide":{"post":{"operationId":"taste_guide","summary":"The six tastes (shad rasa — sweet, sour, salty, pungent, bitter, astringent) and their traditional effect","description":"The six tastes (shad rasa — sweet, sour, salty, pungent, bitter, astringent) and their traditional effect\n    on Vata, Pitta, and Kapha. Use for \"what are the six tastes in Ayurveda\", \"does bitter taste increase or\n    decrease Pitta\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"taste_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/food_dosha_guide":{"post":{"operationId":"food_dosha_guide","summary":"A common food's traditional dosha-effect classification (roughly 49 bundled foods) — whether Ayurvedic","description":"A common food's traditional dosha-effect classification (roughly 49 bundled foods) — whether Ayurvedic\n    tradition says it traditionally increases, decreases, or has a neutral effect on Vata, Pitta, and Kapha. Use\n    for \"is banana good or bad for Kapha\", \"what does Ayurveda say about eating tomatoes\". This is a traditional\n    classification, not nutritional or medical advice.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"food":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A common food. Omit to list the full bundled reference.","examples":["banana","ginger","yogurt","rice","chickpeas"],"title":"Food"}},"title":"food_dosha_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/ayurveda_glossary":{"post":{"operationId":"ayurveda_glossary","summary":"Definitions of core Ayurvedic terms (dosha, prakriti, vikriti, agni, ama, dinacharya, ritucharya, guna,","description":"Definitions of core Ayurvedic terms (dosha, prakriti, vikriti, agni, ama, dinacharya, ritucharya, guna,\n    rasa, ojas, dhatu, panchakarma). Use for \"what does agni mean\", \"what is vikriti\".","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":"ayurveda_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}}}}