{"openapi":"3.1.0","info":{"title":"Nritya (Dance) API","version":"0.1.0","description":"A hand-curated Indian classical dance reference: form profiles for all eight Sangeet Natak Akademi–recognized forms, a hasta mudra reference, costume guides, traditional learning paths, performance structures, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://nritya.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/nritya/docs"},"termsOfService":"https://connectorbay.com/nritya/terms"},"servers":[{"url":"https://nritya.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/nritya/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/dance_form_info":{"post":{"operationId":"dance_form_info","summary":"One classical dance form's state of origin, style characteristics, typical costume, music-accompaniment","description":"One classical dance form's state of origin, style characteristics, typical costume, music-accompaniment\n    tradition (Carnatic, Hindustani, or a distinct regional tradition), and a brief history note. Use for \"tell\n    me about Bharatanatyam\", \"where does Odissi come from\", \"what music accompanies Kathak\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"One of the eight classical forms.","examples":["Bharatanatyam","Kathak","Odissi","Kuchipudi","Manipuri","Mohiniyattam","Kathakali","Sattriya"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"dance_form_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/dance_form_search":{"post":{"operationId":"dance_form_search","summary":"Keyword search across all eight forms' names, states of origin, style characteristics, music tradition","description":"Keyword search across all eight forms' names, states of origin, style characteristics, music tradition\n    and history notes. Use for \"which dance form comes from Kerala\", \"which forms use Carnatic music\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search across form name, origin state, style, music tradition and history.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"dance_form_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/mudra_info":{"post":{"operationId":"mudra_info","summary":"One hand-gesture (hasta mudra)'s name meaning, hand formation, and typical symbolic use. Use for \"what","description":"One hand-gesture (hasta mudra)'s name meaning, hand formation, and typical symbolic use. Use for \"what\n    does the Pataka mudra mean\", \"how do you form the Anjali mudra\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A hasta mudra name.","examples":["Pataka","Tripataka","Ardhachandra","Mayura","Hamsasya","Anjali","Katakamukha"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"mudra_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/mudra_search":{"post":{"operationId":"mudra_search","summary":"Keyword search across all mudras' names, meanings, hand formations and symbolic uses. Use for \"which","description":"Keyword search across all mudras' names, meanings, hand formations and symbolic uses. Use for \"which\n    mudra represents a peacock\", \"find mudras used for a flower\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search across mudra name, meaning, formation and symbolic use.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"mudra_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/dance_glossary":{"post":{"operationId":"dance_glossary","summary":"Definitions of core Indian classical dance terms (adavu, tala, abhinaya, nritta, nritya, natya, tandava,","description":"Definitions of core Indian classical dance terms (adavu, tala, abhinaya, nritta, nritya, natya, tandava,\n    lasya, mudra, gharana, guru-shishya parampara, navarasa, rasa, margam) — including a clear explanation of\n    how nritta (pure rhythm), nritya (expressive dance, this connector's namesake) and natya (full dramatic\n    theatre) relate to and differ from one another. Use for \"what's the difference between nritta and nritya\",\n    \"what does tandava mean\".","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, e.g. adavu, tala, abhinaya, nritta, nritya, natya, tandava, lasya, gharana. Omit to list all.","title":"Term"}},"title":"dance_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/costume_guide":{"post":{"operationId":"costume_guide","summary":"A dance form's typical costume elements in detail — garment, jewelry, hair/makeup, and other notable","description":"A dance form's typical costume elements in detail — garment, jewelry, hair/makeup, and other notable\n    items. Use for \"what's the costume for Odissi\", \"what does a Kathakali performer wear\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dance_form":{"description":"One of the eight classical forms.","examples":["Bharatanatyam","Kathak","Odissi","Kuchipudi","Manipuri","Mohiniyattam","Kathakali","Sattriya"],"minLength":1,"title":"Dance Form","type":"string"}},"required":["dance_form"],"title":"costume_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/learning_path_guide":{"post":{"operationId":"learning_path_guide","summary":"The traditional general stages of learning a classical dance form — basic adavus/steps and posture, then","description":"The traditional general stages of learning a classical dance form — basic adavus/steps and posture, then\n    item-based repertoire of increasing complexity, then a full margam or milestone performance — plus that\n    form's own name and description for its debut milestone where one is conventionally used. Use for \"how does\n    someone learn Bharatanatyam\", \"what's the arangetram\", \"how is Kathak training structured\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dance_form":{"description":"One of the eight classical forms.","examples":["Bharatanatyam","Kathak","Odissi","Kuchipudi","Manipuri","Mohiniyattam","Kathakali","Sattriya"],"minLength":1,"title":"Dance Form","type":"string"}},"required":["dance_form"],"title":"learning_path_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/performance_structure":{"post":{"operationId":"performance_structure","summary":"The typical repertoire order for a full traditional performance of a classical dance form (for example","description":"The typical repertoire order for a full traditional performance of a classical dance form (for example\n    Bharatanatyam's margam: Alarippu, Jatiswaram, Shabdam, Varnam, Padam, Tillana). Use for \"what's the\n    traditional order of a Bharatanatyam performance\", \"what happens during a Kathakali show\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dance_form":{"description":"One of the eight classical forms.","examples":["Bharatanatyam","Kathak","Odissi","Kuchipudi","Manipuri","Mohiniyattam","Kathakali","Sattriya"],"minLength":1,"title":"Dance Form","type":"string"}},"required":["dance_form"],"title":"performance_structureArguments","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/random_mudra":{"post":{"operationId":"random_mudra","summary":"A random hasta mudra from this dataset — good for a \"mudra of the day\" prompt. Use for \"give me a mudra","description":"A random hasta mudra from this dataset — good for a \"mudra of the day\" prompt. Use for \"give me a mudra\n    of the day\", \"surprise me with a mudra\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Optional seed for a reproducible pick.","title":"Seed"}},"title":"random_mudraArguments","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}}}}