Punjabi Riddles

Punjabi Riddles — connector documentation

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

What Punjabi Riddles is for

The playful side of Punjabi oral tradition — a real folk riddle (ਬੁਝਾਰਤ) to puzzle over, a self-answering riddle-poem (ਮੁਕਰੀ) with its clever twist, or the sound-play packed into a riddle's opening line — from one hand-curated, verified reference, ready to guess and check.

What it does

25 real Punjabi folk riddles in Gurmukhi script, each verified against a real source (Punjabi Wikipedia's ਬੁਝਾਰਤਾਂ and ਮੁਕਰੀਆਂ articles), across seven categories — Nature & Sky, Household Objects, Animals, Body & Self, Food & Farming, Mukri (Self-Answering), and Wordplay. riddle_of_the_day and random_riddle surface one riddle at a time, answer included. riddles_by_category and categories_list browse by type. search_riddles finds riddles by keyword. check_answer fuzzy-matches a guess against the real answer, so close wording or a partial word still counts as correct — useful for an interactive guessing game. tongue_twisters and explain_wordplay surface short alliterative and reduplicative phrases from the riddle tradition — like ਗੋਲ ਮਟੋਲ (gol matol, "round and plump") or ਕਾਲੀ ਕਾਲੀ ਗਾਂ (kaali kaali gaā, "black, black cow") — and explain the sound pattern behind each one.

What it is not

Not a claim that Punjabi has a separately-documented "tongue-twister" genre distinct from its riddles: extensive searching turned up no verifiable canonical Punjabi tongue-twisters, so rather than invent any, this reference is honest about reusing genuinely alliterative phrases already present in its sourced riddles. Every riddle here is about wit, wordplay, and everyday objects — never about any group of people, caste, or community. It is not exhaustive; an entry that could not be verified against a real source was left out rather than guessed at. Fully local, zero upstream calls, nothing stored.

Tools

Browse

riddle_of_the_day — One Punjabi riddle, deterministically chosen by today's date so it's the same for everyone all day. The answer is included — use random_riddle if you want to guess first. Use for "Punjabi riddle of the day".

random_riddle — A randomly chosen Punjabi riddle, answer included. Use for "give me a random Punjabi riddle", "surprise me with a riddle". Args: seed.

riddles_by_category — Every riddle in one category. Use categories_list to see valid category names. Use for "Punjabi riddles about animals", "self-answering Punjabi riddle-poems". Args: category.

categories_list — Every riddle category with how many riddles are tagged under it. Use for "what categories of Punjabi riddles do you have".

Play

search_riddles — Keyword search across every riddle's Gurmukhi text, romanization, English hint, answer and category. Use for "Punjabi riddle about the moon", "riddle with answer comb". Args: query.

check_answer — Fuzzy-matches a guessed answer against a riddle's real answer — close wording, partial words, or a plausible synonym still count as correct. Use for "is 'lamp' the right answer to this riddle". Args: riddle_id, guess.

Wordplay

tongue_twisters — Short alliterative and reduplicative wordplay phrases drawn from the Punjabi oral riddle tradition — prized for their sound play (repeated consonants, rhyming doubled words) rather than attested as a separate canonical tongue-twister genre. Use for "Punjabi tongue twisters", "alliterative Punjabi phrases".

explain_wordplay — Explains the sound pattern — alliteration, reduplication, or rhyme — behind one wordplay phrase, and which riddle it comes from. Use for "explain the wordplay in this Punjabi phrase". Args: wordplay_id.

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

Punjabi Riddles — Privacy Policy

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

What Punjabi Riddles is. Punjabi Riddles is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a hand-curated Punjabi folk-riddle reference: riddle of the day, random riddle, category browsing, keyword search, fuzzy answer checking, and wordplay explanations. 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 riddle id, a keyword, a category name, or a guessed answer — 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 your guessed answers, 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. Punjabi Riddles is a general-audience service operated by the adult using the assistant.

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

Punjabi Riddles — Terms of Service

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

1. The Service. Punjabi Riddles returns a hand-curated reference of traditional Punjabi (Gurmukhi-script) folk riddles and wordplay — riddle text, hints, answers, category browsing, keyword search, fuzzy answer checking, and wordplay explanations — 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 claim of completeness. Punjabi Riddles is an independent reference tool, not affiliated with or endorsed by any government, institution, or organization. It draws on a limited, verified set of riddles and does not claim to represent the full oral riddle tradition.
3. Wit, not stereotype. Every riddle in this Service is about everyday objects, nature, or wordplay — never about any group of people, caste, 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, including any guessed answer, 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/punjabiriddles

Punjabi Riddles support

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

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