Gíria

Gíria — connector documentation

• MCP endpoint: https://giria.connectorbay.com/mcp
• REST API: POST https://giria.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://giria.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
• Health: https://giria.connectorbay.com/health · Tool schemas: https://giria.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/giria · agent@connectorbay.com

What Gíria is for

The moment in every conversation with a Brazilian friend, in a telenovela, in a meme, or in a WhatsApp group where someone says "beleza", "bora", "mó legal", or "dar um jeitinho" and the literal dictionary translation makes no sense — answered from one hand-curated, everyday-language glossary, not a scroll through forum threads.

What it does

Look up over a hundred real, commonly used Brazilian Portuguese slang terms and everyday expressions: each one's definition, its literal meaning versus what it actually means in conversation, an example sentence in Portuguese with an English translation, and a formality note (slang_lookup); search by keyword across every term, definition and example (slang_search); pull a random term, optionally filtered to a category like greeting, praise, money, food, party, romance, football, or Carnival (random_slang, slang_by_category); get a deterministic phrase of the day, the same for everyone asking on a given date, with a full explanation (phrase_of_the_day); get a best-effort suggestion for the closest Brazilian slang equivalent to a common English casual phrase like "let's go" or "no big deal" (translate_hint); check whether a term is casual-only, needs care in formal settings, or is broadly fine anywhere (formality_check); see whether a term is nationwide or tied to a specific region — São Paulo, Rio de Janeiro, Bahia, the Northeast, the South (regional_note); and get the glossary's total term count and category breakdown (glossary_stats).

What it is not

Not a live dictionary API and not an academic linguistics reference — Gíria is a hand-curated glossary, verified as of the build date stated in its own data, written to be genuinely useful for an expat, a learner, or anyone curious about colloquial Brazilian Portuguese. Slang moves fast and varies by region, generation and social circle, so a term's tone or popularity can shift, and this glossary won't have tomorrow's newest meme term or a hyper-local expression from one specific city block. The dataset is kept family-friendly on purpose: mild slang and everyday expressions only, no profanity or slurs. For anything sensitive or high-stakes (a legal document, a formal letter), don't rely on slang register notes alone — ask a native speaker.

Tools

Lookup & Search

slang_lookup — Look up one Brazilian Portuguese slang term or everyday expression: its definition, its literal meaning versus what it actually/idiomatically means, an example sentence in Portuguese with an English translation, and a formality/register note. Use for "what does 'beleza' mean", "what does 'dar um jeitinho' actually mean". Args: term.

slang_search — Search across every term, definition, literal meaning and example sentence for a keyword. Use for "find slang about money", "any Brazilian slang for being embarrassed". Args: query.

Browse

random_slang — A random Brazilian Portuguese slang term, optionally filtered to one category. Use for "give me a random Brazilian slang word", "teach me a random football-slang term". Args: category.

slang_by_category — List every term in one category. Use for "show me Brazilian greeting slang", "list all football-derived Brazilian expressions". See glossary_stats for the full list of categories. Args: category.

phrase_of_the_day — A deterministic "phrase of the day" — the same term for everyone who asks on a given calendar date — with its full explanation. Use for "phrase of the day", "teach me a Brazilian slang word for today".

Translate & Register

translate_hint — Best-effort suggestion(s) for the closest Brazilian-Portuguese slang equivalent to a common English casual phrase or idiom, matched by keyword against this connector's own curated data — not a live translation service. Use for "what's the Brazilian slang for 'let's go'", "how would a Brazilian say 'that's cool'". Args: english_phrase.

formality_check — Flags whether a term is casual-only (friends/family, avoid formally), needs care in formal or professional settings even though it isn't profanity, or is broadly fine anywhere. Use for "is 'mano' okay to say to my boss", "can I use 'valeu' in a work email". Args: term.

regional_note — Whether a term is used nationwide or skews to a specific region (São Paulo, Rio de Janeiro, Bahia, the Northeast, the South, ...). Use for "is 'oxente' used everywhere in Brazil", "where is 'bah' from". Args: term.

About the Glossary

glossary_stats — Counts by category, the register (formality) breakdown, and the total term count in this glossary. Use for "how many slang terms do you know", "what categories does this cover".

Conventions

• Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
• Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
• Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/giria/support

Gíria — Privacy Policy

Effective 24 September 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Gíria is. Gíria is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a hand-curated Brazilian Portuguese slang and everyday-expression glossary: term lookups, keyword search, categories, a phrase of the day, English-to-slang translation hints, and formality/regional notes. You interact with your assistant; the assistant sends us only the arguments needed for that one lookup.

What we receive. The arguments of each tool call — a slang term, a search keyword, a category, or an English phrase — the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant, and a Pro API key if you have one), and standard server logs.

Everything is answered from a bundled, hand-curated glossary file and nothing is stored. No request is forwarded to any third party — there is no upstream call at all, live or otherwise — and no query is logged in request bodies, recorded, or used to train anything.

What we do not receive or store. We do not receive your conversation with the assistant or your name, and we do not build a profile from your queries: each request is answered independently and nothing carries over between requests. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting-provider access logs, which contain IP addresses and request paths but not request bodies, are retained for up to 30 days for security and abuse prevention.

Sub-processors. None — the entire dataset is bundled with the server and answered locally. Hosting: Vercel (United States regions).

Legal bases and your rights. Our processing is necessary to provide the service you request through your assistant. Because we store no personal data beyond short-lived logs, requests to access, correct or delete personal data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days. We do not sell or share personal information and do not use your data to train models.

Children. Gíria is a general-audience service operated by the adult using the assistant.

Changes. We will post changes here with a new effective date.

Gíria — Terms of Service

Effective 24 September 2026. These terms govern use of the Gíria connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Gíria returns a hand-curated Brazilian Portuguese slang and everyday-expression glossary — term lookups, keyword search, categories, a phrase of the day, English-to-slang translation hints, and formality/regional notes — from data hand-curated and verified at build time. It is accessed through an AI assistant or directly over MCP or HTTP.
2. Not an academic reference, and language moves fast. Gíria is an independent, informal reference tool, not affiliated with or endorsed by any dictionary publisher, government body, or linguistic institution. Slang usage, popularity and tone vary by region, generation and social circle, and shift over time; nothing in the Service should be relied on for legal, academic, or professional-translation purposes.
3. Family-friendly by design. The dataset is deliberately limited to mild, everyday slang and expressions — no profanity or slurs — and is not a complete inventory of Brazilian Portuguese colloquial speech.
4. Acceptable use. Automated use within the published rate limits is welcome.
5. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time.
6. Data. Our Privacy Policy describes what we process. In short: your query is answered from a bundled reference file, and nothing is stored.
7. Pro keys. Optional Pro API keys are issued at our discretion, are personal to the holder and may be revoked for abuse.
8. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss arising from use of or reliance on the Service. Our total liability is limited to US $100.
9. Governing law. California law; venue in San Mateo County, California.
10. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/giria

Gíria support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://giria.connectorbay.com/mcp
• REST API: https://giria.connectorbay.com/openapi.json
• Live status: https://giria.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Gíria never asks for them.