Malayalam Riddles

Malayalam Riddles — connector documentation

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

What Malayalam Riddles is for

The moment a Malayalam riddle (kadamkatha) comes up — from a grandparent, a school game, or just curiosity about how the language plays with everyday objects — answered with the real riddle, its real answer, and why the wordplay actually works, not a guess.

What it does

71 hand-curated Malayalam riddles (കടങ്കഥകൾ, kadamkathakal) plus 7 tongue twisters, each with genuine Malayalam-script text checked against a published collection, a romanized transliteration, an English gloss, and — for riddles — an answer (in Malayalam, transliterated, and in English) and a short explanation of the metaphor or wordplay that makes the riddle work. A deterministic riddle of the day (riddle_of_the_day) and a random pick (random_riddle, optionally within a category and optionally with the answer hidden for a real guessing game); browsing by category (riddles_by_category, categories_list); keyword search (search_riddles); the tongue twisters (tongue_twisters); fuzzy answer-checking that accepts close English or Malayalam guesses (check_answer); and a full wordplay breakdown for any riddle (explain_wordplay).

What it is not

Not a scholarly corpus and not an attempt at strict academic transliteration (IAST/ISO-15919) — romanization here is simple and practical. Not built around stereotypes: the humor and cleverness in this collection comes entirely from wordplay and metaphor — a hearth-loving cat, a "golden lamp" that's really the sun, a "blind pig" that's really a louse — never from jokes about any group of people. These riddles are traditional folk wordplay, shared cultural heritage across Kerala's many communities, not owned by any one group. Fully local, zero upstream calls, nothing stored.

Tools

Daily & Random

riddle_of_the_day — A deterministic 'riddle of the day' — the same Malayalam riddle, with its answer and explanation, for everyone who asks on a given date. Use for "give me today's Malayalam riddle". Args: date.

random_riddle — A random Malayalam riddle, optionally limited to one category, with the answer optionally hidden for a guessing game (pair with check_answer). Use for "give me a random Malayalam riddle to solve". Args: category, hide_answer, seed.

Browse & Search

riddles_by_category — Every riddle filed under one category. Use categories_list to see valid category names. Use for "list Malayalam riddles about animals", "show me riddles about food and plants". Args: category.

search_riddles — Keyword search across every riddle's text, transliteration, English gloss, answer and category. Use for "find a Malayalam riddle about the moon", "riddles whose answer is an egg". Args: query.

categories_list — Every riddle category with how many riddles are filed under each. Use for "what categories of Malayalam riddles do you have".

Play & Explain

check_answer — Fuzzy-checks a free-text guess (English or Malayalam, exact or approximate) against a riddle's real answer, returning whether it counts as correct and a similarity score. Use for "does 'nose' answer this riddle", "check my guess for this kadamkatha". Args: riddle, guess.

explain_wordplay — The full breakdown of one riddle: its Malayalam text, transliteration, English gloss, answer, and an explanation of the metaphor or wordplay that makes it work. Use for "explain this Malayalam riddle", "why is the answer to this kadamkatha what it is". Args: riddle.

tongue_twisters — Every Malayalam tongue twister in this reference, each with its Malayalam script, transliteration, and English translation. Use for "give me a Malayalam tongue twister", "something hard to say fast in Malayalam".

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

Malayalam Riddles — Privacy Policy

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

What Malayalam Riddles is. Malayalam Riddles is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a hand-curated Malayalam riddle and tongue-twister reference: a riddle of the day, a random riddle, browsing by category, keyword search, tongue twisters, fuzzy answer-checking, and a wordplay explainer. 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 category name, a search keyword, a riddle id or transliteration, a guessed answer, an optional date or seed — 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 (including any guess you make with check_answer) 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. Malayalam Riddles is a general-audience service operated by the adult using the assistant.

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

Malayalam Riddles — Terms of Service

Effective 25 September 2026. These terms govern use of the Malayalam Riddles connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Malayalam Riddles returns a hand-curated reference of Malayalam riddles and tongue twisters — Malayalam script, romanized transliteration, English gloss, answers and wordplay explanations, searchable and browsable by category — from data curated and verified as of the build date stated in its own data. It is accessed through an AI assistant or directly over MCP or HTTP.
2. A reference, not a scholarly corpus. Malayalam Riddles is an independent reference tool, not affiliated with or endorsed by any government, institution, or organization. Transliteration is a simple practical romanization, not a formal academic standard.
3. Traditional folk content. These riddles and tongue twisters are traditional folk wordplay, communal and not owned by any single author or community.
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/malayalamriddles

Malayalam Riddles support

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

• MCP endpoint: https://malayalamriddles.connectorbay.com/mcp
• REST API: https://malayalamriddles.connectorbay.com/openapi.json
• Live status: https://malayalamriddles.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. Malayalam Riddles never asks for them.