{"openapi":"3.1.0","info":{"title":"Acento (Accent) API","version":"0.1.0","description":"A hand-curated reference to dialectal and vocabulary variation across the Spanish-speaking world: everyday-word variants by country, pronoun (tú/vos/usted) and phonetic (seseo/yeísmo) tendencies, formality and greeting norms, a false-friends glossary and a linguistics glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://acento.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/acento/docs"},"termsOfService":"https://connectorbay.com/acento/terms"},"servers":[{"url":"https://acento.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/acento/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/vocabulary_variant":{"post":{"operationId":"vocabulary_variant","summary":"The different everyday words used for one concept across the Spanish-speaking world, and which","description":"The different everyday words used for one concept across the Spanish-speaking world, and which\n    country or region uses each -- e.g. a drinking straw is \"popote\" in Mexico, \"pajilla\"/\"pitillo\" in\n    Colombia, \"sorbete\" in Argentina/Uruguay. Also matches on a specific variant word itself (searching\n    \"popote\" finds the whole \"straw\" entry). Use for \"what do they call a straw in Argentina\", \"words for\n    bus across Latin America\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"concept":{"description":"An everyday concept, in English or Spanish.","examples":["straw","bus","car","popcorn","swimming pool","computer","avocado"],"minLength":1,"title":"Concept","type":"string"}},"required":["concept"],"title":"vocabulary_variantArguments","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/pronoun_usage_guide":{"post":{"operationId":"pronoun_usage_guide","summary":"A region's second-person pronoun pattern: tú (tuteo) vs. vos (voseo) vs. usted for informal/formal","description":"A region's second-person pronoun pattern: tú (tuteo) vs. vos (voseo) vs. usted for informal/formal\n    singular \"you\", and vosotros (Spain) vs. ustedes (Latin America) for plural. Use for \"is it vos or tú in\n    Argentina\", \"do they use vosotros in Mexico\", \"when is usted used in Colombia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A country, or a broader region like 'Rioplatense' or 'Caribbean'.","examples":["Argentina","Spain","Costa Rica","Caribbean"],"minLength":1,"title":"Region","type":"string"}},"required":["region"],"title":"pronoun_usage_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_accent_info":{"post":{"operationId":"regional_accent_info","summary":"General, commonly-described phonetic tendencies for a country: seseo vs. distinción ('z'/soft-'c' vs.","description":"General, commonly-described phonetic tendencies for a country: seseo vs. distinción ('z'/soft-'c' vs.\n    's'), yeísmo and the Rioplatense žeísmo/sheísmo \"ll\"/\"y\" sound, aspiration or dropping of final /s/, and\n    other notable pronunciation patterns. Use for \"why do Argentines say 'll' like 'sh'\", \"do Cubans drop\n    the s sound\", \"is there a lisp in Spain\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country, or a broader region like 'Rioplatense' or 'Caribbean'.","examples":["Argentina","Cuba","Spain","Chile"],"minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"regional_accent_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/formality_guide":{"post":{"operationId":"formality_guide","summary":"General tendencies in formal/informal register use for a region -- how readily \"usted\" is used with","description":"General tendencies in formal/informal register use for a region -- how readily \"usted\" is used with\n    strangers, elders or peers, versus an informal default. Use for \"is usted used a lot in Costa Rica\",\n    \"how formal is Mexican Spanish with strangers\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A country, or a broader region like 'Rioplatense' or 'Central American'.","examples":["Mexico","Costa Rica","Colombia"],"minLength":1,"title":"Region","type":"string"}},"required":["region"],"title":"formality_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/greeting_guide":{"post":{"operationId":"greeting_guide","summary":"General greeting norms for a region -- cheek-kiss (besos) culture vs. handshake-more-common norms,","description":"General greeting norms for a region -- cheek-kiss (besos) culture vs. handshake-more-common norms,\n    and similar everyday social tendencies. Use for \"do people kiss hello in Spain\", \"is a handshake normal\n    greeting in Peru\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A country, or a broader region like 'Rioplatense' or 'Caribbean'.","examples":["Spain","Argentina","Mexico"],"minLength":1,"title":"Region","type":"string"}},"required":["region"],"title":"greeting_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/country_dialect_search":{"post":{"operationId":"country_dialect_search","summary":"Free-text search across the whole dataset by word or by country/region: matches everyday-vocabulary","description":"Free-text search across the whole dataset by word or by country/region: matches everyday-vocabulary\n    concepts and variants, plus countries whose accent, pronoun, formality or greeting notes mention the\n    query (e.g. searching \"voseo\" surfaces every voseo country). Use for \"which countries use vos\", \"find\n    everything about aspiration\", \"search for guagua\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A word, concept, country, region, or linguistic phenomenon (e.g. 'voseo', 'aspiration').","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"country_dialect_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/false_friend_glossary":{"post":{"operationId":"false_friend_glossary","summary":"Words that mean something different -- or carry a different register -- in different Spanish-speaking","description":"Words that mean something different -- or carry a different register -- in different Spanish-speaking\n    countries (e.g. \"coger\" is neutral \"to take\" in Spain but vulgar slang in Mexico; \"guagua\" means \"bus\" in\n    the Caribbean but \"baby\" in Chile/Peru/Bolivia/Ecuador). Flags each honestly, including where a word is\n    vulgar in some countries and completely ordinary in others, described informatively rather than\n    graphically. Use for \"is 'coger' a bad word\", \"what does 'guagua' mean\", \"words that mean different\n    things in different countries\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A word to check; omit to browse the full list.","title":"Term"}},"title":"false_friend_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/slang_overlap_note":{"post":{"operationId":"slang_overlap_note","summary":"Cross-references a term with its equivalents (from the vocabulary-variant dataset) and/or its","description":"Cross-references a term with its equivalents (from the vocabulary-variant dataset) and/or its\n    different meanings (from the false-friends dataset) across the Spanish-speaking world, and points to the\n    sibling jerga (Mexico) connector for deeper Mexican-slang coverage beyond plain dialect variation. Use\n    for \"what else could 'concha' mean\", \"what's the overlap for 'guagua' across countries\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"description":"A word to cross-reference across countries.","minLength":1,"title":"Term","type":"string"}},"required":["term"],"title":"slang_overlap_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/dialect_glossary":{"post":{"operationId":"dialect_glossary","summary":"Defines the linguistics terminology used throughout this connector: voseo, tuteo, seseo, distinción,","description":"Defines the linguistics terminology used throughout this connector: voseo, tuteo, seseo, distinción,\n    ceceo, yeísmo, lleísmo, žeísmo/sheísmo, aspiración, americanismo, dialecto, registro. Use for \"what's\n    voseo\", \"what does seseo mean\", \"what's the difference between dialecto and registro\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A linguistics term to look up (voseo, seseo, yeísmo, ...); omit to browse all.","title":"Term"}},"title":"dialect_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}}}}