{"openapi":"3.1.0","info":{"title":"Jerga (Slang) API","version":"0.1.0","description":"A hand-curated Mexican Spanish slang and colloquialism dictionary: term lookups, keyword search, category browsing, a phrase of the day, regional-variant notes, English-to-slang translation hints, example sentences, formality/register checks and a full glossary browse.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://jerga.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/jerga/docs"},"termsOfService":"https://connectorbay.com/jerga/terms"},"servers":[{"url":"https://jerga.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/jerga/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/slang_lookup":{"post":{"operationId":"slang_lookup","summary":"Look up one Mexican Spanish slang term or expression: its definition, its literal meaning versus","description":"Look up one Mexican Spanish slang term or expression: its definition, its literal meaning versus\n    what it actually/idiomatically means, an example sentence in Spanish with an English translation, its\n    category, and a formality/register note. Use for \"what does 'no manches' mean\", \"what does 'qué onda'\n    actually mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"description":"A Mexican Spanish slang term or expression.","examples":["no manches","chamba","qué onda"],"minLength":1,"title":"Term","type":"string"}},"required":["term"],"title":"slang_lookupArguments","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_search":{"post":{"operationId":"slang_search","summary":"Keyword search across every term's name, definitions, example sentences and register notes. Use for","description":"Keyword search across every term's name, definitions, example sentences and register notes. Use for\n    \"find slang about money\", \"any terms about being broke\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword(s) to search for across terms, definitions, example sentences and register notes.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"slang_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/phrase_of_the_day":{"post":{"operationId":"phrase_of_the_day","summary":"Today's phrase of the day — a deterministic pick (seeded by today's date, so it's the same for","description":"Today's phrase of the day — a deterministic pick (seeded by today's date, so it's the same for\n    everyone and stable across calls today) with a full explanation. Use for \"what's today's Mexican slang\n    phrase of the day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"phrase_of_the_dayArguments","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/browse_by_category":{"post":{"operationId":"browse_by_category","summary":"Every term in one category. Use for \"list all the greetings\", \"show me the money slang\", \"what are","description":"Every term in one category. Use for \"list all the greetings\", \"show me the money slang\", \"what are\n    some regionalisms\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"A category: greetings, exclamations, food, money, insults-playful, school-work, or regional.","title":"Category","type":"string"}},"required":["category"],"title":"browse_by_categoryArguments","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_variant_lookup":{"post":{"operationId":"regional_variant_lookup","summary":"Whether a term is used nationwide, or skews to a specific region (CDMX, Norteño, Yucatán, Sinaloa,","description":"Whether a term is used nationwide, or skews to a specific region (CDMX, Norteño, Yucatán, Sinaloa,\n    and more). Use for \"is 'qué pex' a Northern Mexico thing\", \"where is 'way' used\", \"is 'chido' used\n    nationwide\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"description":"A Mexican Spanish slang term or expression.","minLength":1,"title":"Term","type":"string"}},"required":["term"],"title":"regional_variant_lookupArguments","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/translate_hint":{"post":{"operationId":"translate_hint","summary":"Best-effort suggestion(s) for the closest Mexican-Spanish slang equivalent to a common English casual","description":"Best-effort suggestion(s) for the closest Mexican-Spanish slang equivalent to a common English casual\n    phrase or concept, matched by keyword against this connector's own curated data — not a live translation\n    service. Use for \"how do I say 'I'm broke' in Mexican slang\", \"what's the Mexican slang for 'what's\n    up'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"english_phrase":{"description":"A common English casual phrase, idiom or concept.","examples":["no big deal","I'm broke","what's up","how embarrassing"],"minLength":1,"title":"English Phrase","type":"string"}},"required":["english_phrase"],"title":"translate_hintArguments","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/example_usage":{"post":{"operationId":"example_usage","summary":"One or more example sentences for a term, each in Spanish with an English gloss. Use for \"give me an","description":"One or more example sentences for a term, each in Spanish with an English gloss. Use for \"give me an\n    example sentence with 'chamba'\", \"how would I use 'no mames' in a sentence\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"description":"A Mexican Spanish slang term or expression.","minLength":1,"title":"Term","type":"string"}},"required":["term"],"title":"example_usageArguments","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_check":{"post":{"operationId":"formality_check","summary":"Flags a term's register: neutral colloquial (fine anywhere casual), playful (light teasing, no real","description":"Flags a term's register: neutral colloquial (fine anywhere casual), playful (light teasing, no real\n    offense), vulgar-but-common (mild profanity, everyday among friends but skip it formally), or\n    context-dependent / avoid-with-strangers (can land as an insult or as banter depending on tone and who\n    you're talking to). Use for \"is 'güey' okay to say to my boss\", \"is 'no mames' rude\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"description":"A Mexican Spanish slang term or expression.","minLength":1,"title":"Term","type":"string"}},"required":["term"],"title":"formality_checkArguments","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_glossary":{"post":{"operationId":"slang_glossary","summary":"Browse the full glossary: every term with its category and a short meaning, sorted alphabetically,","description":"Browse the full glossary: every term with its category and a short meaning, sorted alphabetically,\n    when no term is given; or one term's full entry, glossary-style, when a term is given. Use for \"show me\n    the whole slang glossary\", \"give me the glossary entry for 'lana'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional: a specific term to look up glossary-style. Omit to browse the full glossary alphabetically.","title":"Term"}},"title":"slang_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}}}}