{"openapi":"3.1.0","info":{"title":"Kitefight API","version":"0.1.0","description":"A fully local, hand-curated reference on competitive kite-flying and kite-fighting traditions (South Asian patang/manjha dueling, Afghan gudiparan bazi, Thai chula-pakpao, Japanese rokkaku battles, Brazilian pipa/cerol flying, Korean yeonnalligi, Chinese display-kite culture, and modern sport-kite competition), kite types, festivals, a glossary, beginner tips, and genuine, prominent safety and regulation coverage of glass-coated cutting line.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://kitefight.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/kitefight/docs"},"termsOfService":"https://connectorbay.com/kitefight/terms"},"servers":[{"url":"https://kitefight.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/kitefight/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/tradition_info":{"post":{"operationId":"tradition_info","summary":"Full, respectful detail on one real kite-fighting/flying tradition: overview, cultural context, typical","description":"Full, respectful detail on one real kite-fighting/flying tradition: overview, cultural context, typical\n    kites, related festivals and terms, and a safety notice when the tradition uses cutting line. Omit name to\n    list every tradition covered. Use for \"tell me about Afghan kite fighting\", \"what is patangbazi\", \"how does\n    Thai chula-pakpao work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A kite-fighting or kite-flying tradition's name, alias, or region; omit to list every tradition.","examples":["South Asian patang","gudiparan bazi","chula pakpao","rokkaku"],"title":"Name"}},"title":"tradition_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/kite_type_info":{"post":{"operationId":"kite_type_info","summary":"Full detail on one kite type: origin, structure/build, typical purpose, and difficulty. Omit name to list","description":"Full detail on one kite type: origin, structure/build, typical purpose, and difficulty. Omit name to list\n    every kite type covered. Use for \"what is a rokkaku kite\", \"what's a good beginner kite\", \"how is a chula\n    kite built\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A kite type's name or alias; omit to list every kite type.","examples":["patang","rokkaku","delta kite","box kite"],"title":"Name"}},"title":"kite_type_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/festival_info":{"post":{"operationId":"festival_info","summary":"Full detail on one real kite-flying festival: region, timing, description, and a festival-specific safety","description":"Full detail on one real kite-flying festival: region, timing, description, and a festival-specific safety\n    note where relevant. Omit name to list every festival covered. Use for \"when is Uttarayan\", \"what happens at\n    the Hamamatsu Kite Festival\", \"is Basant still celebrated with kites\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A kite-flying festival's name, alias, or region; omit to list every festival.","examples":["Makar Sankranti","Hamamatsu Kite Festival","Bali Kite Festival"],"title":"Name"}},"title":"festival_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/term_glossary":{"post":{"operationId":"term_glossary","summary":"Definitions of kite-flying and kite-fighting terms across traditions — manjha, patang, dhil dena,","description":"Definitions of kite-flying and kite-fighting terms across traditions — manjha, patang, dhil dena,\n    gudiparan bazi, tar, chula, pakpao, rokkaku, cerol, bridle, spine and spar, tail, and more. Use for \"what\n    does manjha mean\", \"what's the difference between chula and pakpao\", \"what is a bridle\".","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.","examples":["manjha","dhil dena","chula","bridle"],"title":"Term"}},"title":"term_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/safety_consideration":{"post":{"operationId":"safety_consideration","summary":"Genuine, prominent safety information on kite-fighting hazards — above all, glass-/abrasive-coated","description":"Genuine, prominent safety information on kite-fighting hazards — above all, glass-/abrasive-coated\n    cutting line (manjha, tar, cerol), which has caused serious injuries and deaths to bystanders and\n    motorcyclists, severely injures and kills birds, and can cut the flyer's own hands. Also covers power lines,\n    traffic, rooftops, severe weather, line disposal, and safer uncoated-line alternatives. Omit topic to list\n    every topic covered. Use for \"is manjha dangerous\", \"what are the risks of kite fighting\", \"is there a safer\n    kite line\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A safety topic to look up; omit to list all covered topics.","examples":["bystander injuries","bird injury","safer alternatives","power lines"],"title":"Topic"}},"title":"safety_considerationArguments","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/regulation_note":{"post":{"operationId":"regulation_note","summary":"Factual, hedged notes on where glass-/abrasive-coated kite line or kite flying itself has been","description":"Factual, hedged notes on where glass-/abrasive-coated kite line or kite flying itself has been\n    restricted or banned (India, Pakistan/Punjab, Brazil) plus generic airspace/altitude rules — not legal\n    advice, and rules change over time. Omit topic to list every topic covered. Use for \"is manjha legal in\n    India\", \"was kite flying banned in Pakistan\", \"can I fly a kite near an airport\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A jurisdiction or regulatory topic to look up; omit to list all covered topics.","examples":["India","Pakistan Punjab","Brazil","airspace"],"title":"Topic"}},"title":"regulation_noteArguments","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/find_kite_for_purpose":{"post":{"operationId":"find_kite_for_purpose","summary":"Suggests 1-4 suitable kite types for a stated purpose, keyword-matched against each kite type's tagged","description":"Suggests 1-4 suitable kite types for a stated purpose, keyword-matched against each kite type's tagged\n    purposes. Use for \"what kite should a beginner fly\", \"best kite for dueling\", \"what kite is stable in strong\n    wind\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"purpose":{"description":"A goal or purpose, in plain language.","examples":["easy for a beginner","aerial dueling","stable in strong wind","team battle","precision aerobatics"],"minLength":1,"title":"Purpose","type":"string"}},"required":["purpose"],"title":"find_kite_for_purposeArguments","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/beginner_tips":{"post":{"operationId":"beginner_tips","summary":"A curated, safety-forward shortlist of tips for someone new to kite flying, ordered from most to least","description":"A curated, safety-forward shortlist of tips for someone new to kite flying, ordered from most to least\n    essential. Use for \"how do I start kite flying safely\", \"tips for a first-time kite flyer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"default":5,"description":"How many tips to return.","maximum":10,"minimum":1,"title":"Count","type":"integer"}},"title":"beginner_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}}}}