{"openapi":"3.1.0","info":{"title":"Sonido (Sound) API","version":"0.1.0","description":"A hand-curated Mexican music genre reference: origins, history, instrumentation, occasions and sub-styles, an instrument guide, a regional map, dance-style pairings, song-structure conventions, a festival/occasion guide and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://sonido.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/sonido/docs"},"termsOfService":"https://connectorbay.com/sonido/terms"},"servers":[{"url":"https://sonido.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/sonido/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/genre_info":{"post":{"operationId":"genre_info","summary":"One Mexican music genre's origin/region, history overview, typical instrumentation, typical occasions and","description":"One Mexican music genre's origin/region, history overview, typical instrumentation, typical occasions and\n    notable sub-styles. Use for \"tell me about mariachi\", \"what is banda\", \"explain son jarocho\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A genre name.","examples":["mariachi","banda","norteño","son jarocho"],"title":"Name","type":"string"}},"required":["name"],"title":"genre_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/genre_search":{"post":{"operationId":"genre_search","summary":"Search Mexican music genres by a free-text query. Use for \"which genres come from Jalisco\", \"what genre","description":"Search Mexican music genres by a free-text query. Use for \"which genres come from Jalisco\", \"what genre\n    uses accordion\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Free-text search over genre names, regions, eras, descriptions and instruments.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"genre_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/instrument_guide":{"post":{"operationId":"instrument_guide","summary":"An instrument's build, how it's played, its role and its typical genre association, for at least eight","description":"An instrument's build, how it's played, its role and its typical genre association, for at least eight\n    instruments (guitarrón, vihuela, requinto jarocho, trompeta, accordion, bajo sexto, tololoche, marimba,\n    tambora, jarana jarocha). Use for \"how is a guitarrón played\", \"what family is the bajo sexto in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"An instrument name.","examples":["guitarrón","vihuela","requinto","trompeta","accordion","bajo sexto"],"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/regional_origin_guide":{"post":{"operationId":"regional_origin_guide","summary":"Which Mexican music genres are most associated with a given region (Jalisco/mariachi and ranchera,","description":"Which Mexican music genres are most associated with a given region (Jalisco/mariachi and ranchera,\n    Sinaloa/banda, the northern border states/norteño and corrido, Veracruz/son jarocho, the Huasteca\n    region/huapango, and more). Use for \"what music is from Sinaloa\", \"which genre is Veracruz known for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A Mexican region or state.","examples":["Jalisco","Sinaloa","Norte","Veracruz","Huasteca"],"title":"Region","type":"string"}},"required":["region"],"title":"regional_origin_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/dance_style_guide":{"post":{"operationId":"dance_style_guide","summary":"The dance style associated with a genre, where one exists (zapateado for son jarocho and huapango,","description":"The dance style associated with a genre, where one exists (zapateado for son jarocho and huapango,\n    quebradita for banda, and more). Use for \"what dance goes with corrido\", \"is there a dance for huapango\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"genre":{"description":"A genre name.","examples":["son jarocho","huapango","banda","cumbia mexicana"],"title":"Genre","type":"string"}},"required":["genre"],"title":"dance_style_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/history_overview":{"post":{"operationId":"history_overview","summary":"A fuller, standalone history writeup for one Mexican music genre. Use for \"give me the history of","description":"A fuller, standalone history writeup for one Mexican music genre. Use for \"give me the history of\n    mariachi\", \"how did the corrido tradition develop\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"genre":{"description":"A genre name.","examples":["mariachi","corrido","huapango"],"title":"Genre","type":"string"}},"required":["genre"],"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/song_structure_guide":{"post":{"operationId":"song_structure_guide","summary":"A genre's general, typical structural conventions in plain words — verse-refrain, strophic storytelling,","description":"A genre's general, typical structural conventions in plain words — verse-refrain, strophic storytelling,\n    or call-and-response — with no lyrics reproduced. Use for \"how is a corrido structured\", \"what's the\n    typical form of a ranchera\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"genre":{"description":"A genre name.","examples":["corrido","ranchera","son jarocho"],"title":"Genre","type":"string"}},"required":["genre"],"title":"song_structure_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/festival_occasion_guide":{"post":{"operationId":"festival_occasion_guide","summary":"The typical occasions a genre is performed at (weddings, quinceañeras, serenatas, Independence Day, Día","description":"The typical occasions a genre is performed at (weddings, quinceañeras, serenatas, Independence Day, Día\n    de los Muertos) plus any named festival traditions tied to it. Use for \"when would I hear mariachi\", \"what\n    music plays at a quinceañera\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"genre":{"description":"A genre name.","examples":["mariachi","banda","cumbia mexicana"],"title":"Genre","type":"string"}},"required":["genre"],"title":"festival_occasion_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/music_glossary":{"post":{"operationId":"music_glossary","summary":"Definitions of common Mexican music terms (mariachi, banda, norteño, corrido, ranchera, huapango, son,","description":"Definitions of common Mexican music terms (mariachi, banda, norteño, corrido, ranchera, huapango, son,\n    zapateado, requinto, guitarrón, vihuela, grito, fandango, quinceañera). Use for \"what's a fandango\", \"what\n    does zapateado 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; omit to list all.","title":"Term"}},"title":"music_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}}}}