Ritmo (Rhythm)

Ritmo (Rhythm) — connector documentation

• MCP endpoint: https://ritmo.connectorbay.com/mcp
• REST API: POST https://ritmo.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://ritmo.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://ritmo.connectorbay.com/health · Tool schemas: https://ritmo.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/ritmo · agent@connectorbay.com

Ritmo (Rhythm)

What Ritmo is for

The question that comes up whenever Brazilian music comes up in conversation — what actually is forró, where does axé come from, what's the difference between samba and pagode, what instrument makes that squeaking sound in a samba recording — answered from one hand-curated cultural and historical reference, not a music catalogue.

What it does

Origin, era, characteristics, key instruments and cultural context for twelve genres — samba, bossa nova, forró, sertanejo, MPB (Música Popular Brasileira), axé, funk carioca, choro, frevo, maracatu, pagode and brega (genre_info, genre_search); which genres are most associated with which Brazilian region — samba with Rio de Janeiro, forró with the Northeast, frevo and maracatu with Pernambuco, sertanejo with the countryside and Center-West, axé with Bahia, and more (genre_by_region); a guide to eight instruments — pandeiro, cuíca, berimbau, cavaquinho, surdo, agogô, tamborim and viola caipira — their family, how they're played, and typical genre association (instrument_guide); a plain-words description of each genre's basic rhythmic feel, like samba's syncopated 2/4 groove, without audio or notation (rhythm_pattern_guide); a brief chronological overview of how Brazilian popular music evolved, by approximate era (history_timeline); the dance style paired with a genre where one exists, such as samba dance, forró dance or frevo's demanding acrobatic style (dance_pairing); the musical role of Carnaval (samba schools and samba-enredo, trio elétrico, frevo and maracatu) and São João/Festa Junina (forró) (festival_guide); and a glossary of around a dozen Carnaval and samba terms — samba-enredo, batucada, bloco, cordão, roda de samba and more (music_glossary).

What it is not

Not a music catalogue, streaming service or artist directory — Ritmo is a cultural and historical reference about the genres themselves. It names no specific living artists and quotes no song lyrics anywhere in its data. For tracks, albums, artist profiles, charts or a live discography, use a music catalogue connector such as this platform's Tunes connector instead. Fully local and keyless: nothing is fetched from any upstream source and nothing about a query is stored.

Tools

Genres

genre_info — One Brazilian music genre's origin, era, characteristics, key instruments and cultural context. Use for "tell me about samba", "what is forró", "explain MPB". Args: name.

genre_search — Search Brazilian music genres by a free-text query. Use for "which genres come from Bahia", "what genre uses accordion". Args: query.

genre_by_region — Which Brazilian music genres are most associated with a given region (samba/Rio, forró/Northeast, frevo and maracatu/Pernambuco, sertanejo/countryside and center-west, axé/Bahia, and more). Use for "what music is from Pernambuco", "which genre is Bahia known for". Args: region.

Instruments & rhythm

instrument_guide — An instrument's family, how it's played, and its typical genre association, for eight instruments (pandeiro, cuíca, berimbau, cavaquinho, surdo, agogô, tamborim, viola caipira). Use for "how is a cuíca played", "what family is the berimbau in". Args: name.

rhythm_pattern_guide — A plain-words description of a genre's basic rhythmic feel (not audio or notation) — for example samba's syncopated 2/4 groove. Use for "how does samba's rhythm work", "describe the forró beat". Args: genre.

Culture

history_timeline — A brief chronological overview of the evolution of Brazilian popular music genres, by approximate era. Use for "give me a history of Brazilian music", "how did samba lead to bossa nova".

dance_pairing — The dance style associated with a genre, where one exists (samba dance, forró dance, frevo's acrobatic dance, and more). Use for "what dance goes with axé", "is there a dance for bossa nova". Args: genre.

festival_guide — The musical role of Carnaval (samba schools and samba-enredo in Rio, trio elétrico and axé in Bahia, frevo and maracatu in Pernambuco) and other major regional music-linked festivals (São João/Festa Junina and forró). Use for "what music plays at Carnaval", "what's the connection between forró and São João".

music_glossary — Definitions of common Brazilian music/Carnaval terms (samba-enredo, batucada, bloco, cordão, roda de samba, bateria, ala, enredo, quadra, trio elétrico, baile funk, roda de choro). Use for "what's a samba-enredo", "what does bloco mean". Args: term.

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/ritmo/support

Ritmo (Rhythm) — Privacy Policy

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

What Ritmo is. Ritmo (Rhythm) is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a hand-curated Brazilian music genre reference: genre profiles, an instrument guide, rhythmic-feel descriptions, a regional map, dance pairings, a history timeline, a festival guide, and a glossary. 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 genre name, a search query, a region, an instrument name, or a glossary term — 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 reference 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. Ritmo is a general-audience service operated by the adult using the assistant.

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

Ritmo (Rhythm) — Terms of Service

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

1. The Service. Ritmo (Rhythm) returns a hand-curated Brazilian music genre reference — genre profiles, an instrument guide, rhythmic-feel descriptions, a regional map, dance pairings, a history timeline, a festival guide, and a glossary — hand-curated as a cultural and historical reference. It is accessed through an AI assistant or directly over MCP or HTTP.
2. A reference, not a catalogue. Ritmo is an independent cultural and historical reference tool, not affiliated with or endorsed by any artist, label, samba school, festival organizer or government body. It does not provide track, album or artist data, streaming links, or lyrics, and names no specific living artists. For music catalogue or streaming information, use a dedicated music connector instead.
3. A hand-curated reference. Content reflects general, widely-documented cultural and historical knowledge as curated at build time; it is not a substitute for academic or ethnomusicological research, and regional traditions vary and continue to evolve beyond what is captured here.
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/ritmo

Ritmo (Rhythm) support

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

• MCP endpoint: https://ritmo.connectorbay.com/mcp
• REST API: https://ritmo.connectorbay.com/openapi.json
• Live status: https://ritmo.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. Ritmo (Rhythm) never asks for them.