{"openapi":"3.1.0","info":{"title":"Flamenco (Song & Dance) API","version":"0.1.0","description":"A hand-curated Spanish flamenco reference: 15 major palos (styles) with compás, mood, origin and formality; a deeper compás guide; instrument guides (guitar, cajón, castanets, palmas, jaleo); the cantaor/bailaor/tocaor roles; a history overview with the Roma/Gitano community's role and UNESCO recognition; regional origins; a terminology glossary; and a festival guide.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://flamenco.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/flamenco/docs"},"termsOfService":"https://connectorbay.com/flamenco/terms"},"servers":[{"url":"https://flamenco.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/flamenco/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/palo_info":{"post":{"operationId":"palo_info","summary":"One flamenco palo's compás (rhythmic pattern), typical mood, geographic origin within Andalusia, and a","description":"One flamenco palo's compás (rhythmic pattern), typical mood, geographic origin within Andalusia, and a\n    difficulty/formality level, plus a short history note. Use for \"tell me about soleá\", \"what's bulería\",\n    \"where does malagueña come from\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A flamenco palo (style) name.","examples":["soleá","bulería","alegrías","seguiriya","tango flamenco","fandango","sevillanas","tarantos","malagueña","guajira","colombiana","farruca","tientos","verdiales","petenera"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"palo_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/palo_search":{"post":{"operationId":"palo_search","summary":"Keyword search across all 15 palos' names, rhythmic families, moods, geographic origins and history","description":"Keyword search across all 15 palos' names, rhythmic families, moods, geographic origins and history\n    notes. Use for \"which palos come from Cádiz\", \"which styles are cante jondo\", \"which palos are free\n    rhythm\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search across palo name, family, compás, mood, origin and history.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"palo_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/compas_guide":{"post":{"operationId":"compas_guide","summary":"A standalone, deeper explanation of one palo's compás — its rhythmic family, beat count and accent","description":"A standalone, deeper explanation of one palo's compás — its rhythmic family, beat count and accent\n    pattern, and whether it's typically danced. Use for \"what's the compás for bulería\", \"explain seguiriya's\n    rhythm\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"palo":{"description":"A flamenco palo name.","examples":["bulería","soleá","seguiriya","tientos"],"minLength":1,"title":"Palo","type":"string"}},"required":["palo"],"title":"compas_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/instrument_guide":{"post":{"operationId":"instrument_guide","summary":"One flamenco instrument or practice's role and technique — the guitarra flamenca (flamenco guitar),","description":"One flamenco instrument or practice's role and technique — the guitarra flamenca (flamenco guitar),\n    cajón, castañuelas (castanets), palmas (hand-clapping) or jaleo (vocal encouragement) — including where\n    it actually fits in the tradition. Use for \"how did the cajón get into flamenco\", \"are castanets used in\n    flamenco\", \"what are palmas sordas\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A flamenco instrument or practice.","examples":["guitarra flamenca","guitar","cajón","castañuelas","castanets","palmas","jaleo"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"instrument_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/role_explainer":{"post":{"operationId":"role_explainer","summary":"The cantaor/a (singer), bailaor/a (dancer) or tocaor/a (guitarist) — their role and the collaborative,","description":"The cantaor/a (singer), bailaor/a (dancer) or tocaor/a (guitarist) — their role and the collaborative,\n    call-and-response dynamic between them in a cuadro flamenco. Use for \"what does a bailaora do\", \"how do\n    the singer and guitarist work together in flamenco\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"role":{"description":"cantaor/a | bailaor/a | tocaor/a (or singer/dancer/guitarist).","examples":["cantaor","bailaora","tocaor","singer","dancer","guitarist"],"minLength":1,"title":"Role","type":"string"}},"required":["role"],"title":"role_explainerArguments","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/history_overview":{"post":{"operationId":"history_overview","summary":"Flamenco's origins in 18th/19th-century Andalusia, the Roma/Gitano community's central role in its","description":"Flamenco's origins in 18th/19th-century Andalusia, the Roma/Gitano community's central role in its\n    development, its 2010 UNESCO Intangible Cultural Heritage recognition, and its evolution into the modern\n    era. Use for \"where does flamenco come from\", \"is flamenco Roma culture\", \"when was flamenco recognized\n    by UNESCO\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"history_overviewArguments","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/regional_origin":{"post":{"operationId":"regional_origin","summary":"The Andalusian provinces and cities most associated with flamenco's development — Jerez de la","description":"The Andalusian provinces and cities most associated with flamenco's development — Jerez de la\n    Frontera, Cádiz, Sevilla, Triana and Málaga — and what each contributed. Use for \"where in Spain does\n    flamenco come from\", \"what's special about Jerez for flamenco\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"regional_originArguments","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/terminology_glossary":{"post":{"operationId":"terminology_glossary","summary":"Definitions of core flamenco terms (cante, cante jondo, cante chico, baile, toque, compás, palo,","description":"Definitions of core flamenco terms (cante, cante jondo, cante chico, baile, toque, compás, palo,\n    duende, jaleo, tablao, cuadro flamenco, gitano/gitana). Use for \"what does duende mean\", \"what's a\n    tablao\", \"what's the difference between cante jondo and cante chico\".","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. cante jondo, duende, jaleo, compás, palo, tablao, cuadro flamenco, gitano. Omit to list all.","title":"Term"}},"title":"terminology_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/festival_guide":{"post":{"operationId":"festival_guide","summary":"Well-known flamenco festivals and institutions — including the Bienal de Flamenco de Sevilla (founded","description":"Well-known flamenco festivals and institutions — including the Bienal de Flamenco de Sevilla (founded\n    1980), the Festival de Jerez, and the Instituto Andaluz del Flamenco. Use for \"what's the Bienal de\n    Flamenco\", \"are there flamenco festivals I can attend\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"festival_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}}}}