{"openapi":"3.1.0","info":{"title":"Tapas (Small Plates) API","version":"0.1.0","description":"A hand-curated Spanish tapas culture & dish reference: 35 iconic tapas with region, category, key ingredients, serving style and drink pairing, a regional tapas-culture guide, bar etiquette, an ingredient spotlight, a history overview, a tapas-crawl planner, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://tapas.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/tapas/docs"},"termsOfService":"https://connectorbay.com/tapas/terms"},"servers":[{"url":"https://tapas.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/tapas/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/iconic_tapa_info":{"post":{"operationId":"iconic_tapa_info","summary":"One iconic tapa's description, key ingredients, typical serving style and the region it is most","description":"One iconic tapa's description, key ingredients, typical serving style and the region it is most\n    strongly associated with. Use for \"what is in tortilla española\", \"tell me about jamón ibérico\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A tapa name.","examples":["patatas bravas","tortilla española","jamón ibérico","gambas al ajillo"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"iconic_tapa_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/tapa_search":{"post":{"operationId":"tapa_search","summary":"Search iconic tapas by keyword across name, region, category, description and key ingredients. Use","description":"Search iconic tapas by keyword across name, region, category, description and key ingredients. Use\n    for \"tapas with octopus\", \"what has pimentón in it\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search across tapa name, region, category, description and key ingredients.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"tapa_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/regional_tapas_guide":{"post":{"operationId":"regional_tapas_guide","summary":"How tapas culture and etiquette differ by region — the Basque Country's self-served pintxo tradition","description":"How tapas culture and etiquette differ by region — the Basque Country's self-served pintxo tradition\n    (toothpicks counted at the end), Andalusia's free-tapa-with-a-drink custom, Madrid's tapeo bar-hopping,\n    Galicia's seafood raciones, and Catalonia's vermut hour. Use for \"how are pintxos different from tapas in\n    Andalusia\", \"what's tapas culture like in Madrid\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A Spanish region or city's tapas tradition.","examples":["Basque Country","Andalusia","Madrid","Galicia","Catalonia"],"title":"Region","type":"string"}},"required":["region"],"title":"regional_tapas_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/tapas_bar_etiquette":{"post":{"operationId":"tapas_bar_etiquette","summary":"General tapas-bar etiquette: how to order, standing at the barra versus sitting at a table, the","description":"General tapas-bar etiquette: how to order, standing at the barra versus sitting at a table, the\n    tapeo (bar-hopping) tradition, the tapa/media ración/ración portion ladder, and how paying and tipping\n    usually work. Use for \"how do I order tapas like a local\", \"what's a media ración\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"tapas_bar_etiquetteArguments","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/pairing_guide":{"post":{"operationId":"pairing_guide","summary":"The typical drink pairing (vermut, fino/manzanilla sherry, cerveza, tinto de verano, txakoli, sidra)","description":"The typical drink pairing (vermut, fino/manzanilla sherry, cerveza, tinto de verano, txakoli, sidra)\n    for a named tapa, with a short reason. Use for \"what should I drink with gambas al ajillo\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tapa":{"description":"A tapa name.","examples":["gambas al ajillo","jamón ibérico","patatas bravas","queso manchego"],"minLength":1,"title":"Tapa","type":"string"}},"required":["tapa"],"title":"pairing_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/ingredient_spotlight":{"post":{"operationId":"ingredient_spotlight","summary":"A deeper look at a key tapas ingredient — jamón ibérico's official four-seal grading system","description":"A deeper look at a key tapas ingredient — jamón ibérico's official four-seal grading system\n    (bellota, cebo de campo, cebo), queso manchego's aging categories (semicurado, curado, viejo), and the\n    basics of Spanish olive oil, pimentón and sherry vinegar. Use for \"what does bellota mean on a jamón\n    label\", \"what's the difference between curado and añejo manchego\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A Spanish tapas ingredient.","examples":["jamón ibérico","queso manchego","aceite de oliva","pimentón","vinagre de jerez"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"ingredient_spotlightArguments","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":"The commonly told tapas origin legends (a drink cover against flies/dust; a king's doctor's advice)","description":"The commonly told tapas origin legends (a drink cover against flies/dust; a king's doctor's advice)\n    presented explicitly as legend/folklore, not confirmed history, followed by a summary of tapas' real,\n    gradually spreading documented evolution as a bar-culture practice. Use for \"did tapas really start\n    because of a king\", \"where do tapas actually come from\".","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/tapas_crawl_planner":{"post":{"operationId":"tapas_crawl_planner","summary":"A balanced tapeo (tapas-crawl) plan for a given number of stops, suggesting a genuine variety of tapa","description":"A balanced tapeo (tapas-crawl) plan for a given number of stops, suggesting a genuine variety of tapa\n    categories — seafood, meat, potato, vegetable, cheese, egg, bread — rather than repeating the same kind\n    of plate back to back. Use for \"plan me a 5-stop tapas crawl\", \"help me order a varied round of tapas\n    for 4 people\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"number_of_stops":{"description":"How many bars/stops the tapas crawl should have.","maximum":30,"minimum":1,"title":"Number Of Stops","type":"integer"}},"required":["number_of_stops"],"title":"tapas_crawl_plannerArguments","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/tapas_glossary":{"post":{"operationId":"tapas_glossary","summary":"Definitions of tapas-culture terms (tapa, pincho/pintxo, ración, media ración, tapeo, barra, vermut,","description":"Definitions of tapas-culture terms (tapa, pincho/pintxo, ración, media ración, tapeo, barra, vermut,\n    DO/Denominación de Origen, montadito, chato, txikiteo, sobremesa). Use for \"what does tapeo mean\",\n    \"what's a montadito\".","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":"tapas_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}}}}