Hikaya (Story)

Hikaya (Story) — connector documentation

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

What Hikaya (Story) is for

"Hikaya" (حكاية) is the Arabic word for a story. This connector is a fully local reference of Arab and Middle Eastern folk-tale tradition — the public-domain framework and historical tale titles of One Thousand and One Nights (Alf Layla wa-Layla), the Juha/Goha trickster-and-wise-fool anecdotes told across the region, and shorter regional folklore — gathered in one place with original, hand-written summaries instead of a scroll through a dozen retelling sites of uneven quality and accuracy.

What it does

A classic tale's origin/collection, an original brief plot summary, and its moral or theme (tale_info); a keyword search across titles, characters and morals (tale_search); every tale from one collection — 1001 Nights, Juha tales, or regional folklore (tales_by_collection); a factual explanation of the Scheherazade/Shahrazad frame narrative that structures the whole of One Thousand and One Nights (frame_story_explainer); a brief, original retelling of a classic Juha/Goha anecdote, by topic or picked at random (juha_anecdote); background on recurring characters and archetypes — Scheherazade, Shahryar, Aladdin, the Jinni of the Lamp, Sindbad, Ali Baba, Morgiana, Juha, Luqman al-Hakim, and Hatim al-Ta'i (character_info); the common morals found across these tales, grouped by theme (moral_lessons); factual background on the hakawati, the traditional Arab oral storyteller (storytelling_tradition_info); and a glossary of about a dozen terms central to this storytelling tradition (folklore_glossary).

What it is not

Not a verbatim reproduction of any single published translation. The specific tales named here — Aladdin, Ali Baba, Sindbad, and the rest — are centuries-old and firmly in the public domain, and every summary, character note, and background note here is written fresh, in the publisher's own original prose, citing only the traditional tale and character names that are themselves part of the public-domain tradition. No summary here is drawn from a modern copyrighted collection, a specific living author's retelling, or the exact wording of any historical translator (Burton, Lane, Haddawy, or otherwise). It is also not an exhaustive or scholarly critical edition: 18 hand-picked tales and 12 Juha anecdotes chosen for how widely they are known and how clear their point is, not a complete inventory of Arab oral tradition.

Tools

Lookup

tale_info — A classic tale's origin/collection, a brief original-prose plot summary, and its moral or theme. Use for "tell me about Sindbad the Sailor", "what happens in the City of Brass". Args: title.

tale_search — Keyword search across tale titles, characters, and morals. Use for "find tales that feature a jinni", "which stories involve a merchant". Args: query.

Nights

tales_by_collection — Every tale from one collection: 1001 Nights, Juha tales, or regional folklore. Use for "list some 1001 Nights stories", "give me the Juha tales". Args: collection.

frame_story_explainer — The Scheherazade/Shahrazad frame narrative that structures One Thousand and One Nights, explained factually. Use for "what is the frame story of 1001 Nights", "why does Scheherazade tell stories".

Juha

juha_anecdote — A brief, original-prose retelling of a classic Juha/Goha trickster-and-wise-fool anecdote, chosen by topic, or a random pick if no topic is given. Use for "tell me a Juha story", "give me a Juha anecdote about greed". Args: topic.

Reference

character_info — Background on a recurring character or archetype — Scheherazade, Shahryar, Aladdin, the Jinni of the Lamp, Sindbad, Ali Baba, Morgiana, Juha, Luqman al-Hakim, or Hatim al-Ta'i — who they are, which tale(s) they appear in, and their key traits. Use for "who is Scheherazade", "what is Juha like". Args: name.

moral_lessons — Common morals and lessons found across these tales, grouped by theme — the full list if no theme is given, or one theme's explanation plus the tales and anecdotes that teach it. Use for "what morals do these tales teach", "find lessons about generosity". Args: theme.

storytelling_tradition_info — Factual background on the hakawati, the traditional Arab oral storyteller. Use for "what is a hakawati", "how were these stories traditionally performed".

folklore_glossary — About a dozen terms central to Arab storytelling tradition — the full glossary if no term is given, or one term's definition. Use for "what does hakawati mean", "list some storytelling terms". 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/hikaya/support

Hikaya (Story) — Privacy Policy

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

What Hikaya (Story) is. Hikaya (Story) is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a fully local reference of Arab/Middle Eastern folk tales — tale summaries, the 1001 Nights frame story, Juha anecdotes, characters, moral lessons, the hakawati storytelling tradition, and a folklore 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 tale title, a search keyword, a collection name, a Juha topic, a character name, a moral theme, 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 bundled, hand-written reference files 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. Hikaya (Story) is a general-audience service operated by the adult using the assistant; some tale summaries reference violence, deception, or peril in the way that traditional folklore commonly does, and a parent's own judgment about age-appropriateness applies.

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

Hikaya (Story) — Terms of Service

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

1. The Service. Hikaya (Story) returns a fully local reference of Arab/Middle Eastern folk-tale tradition — original summaries of the public-domain framework and historical tale titles of One Thousand and One Nights (Alf Layla wa-Layla), Juha/Goha trickster anecdotes, and regional Arab folklore, plus character background, a moral-lessons glossary, hakawati storytelling background, and a folklore-terms glossary. It is accessed through an AI assistant or directly over MCP or HTTP.
2. Original retellings of public-domain folklore. The specific tales and anecdotes named here are ancient and public domain; every summary is written fresh by the publisher and is not a reproduction of any single historical translator's copyrighted text, and no summary here is drawn from a modern copyrighted collection or a specific living author's retelling. The Service is an independent reference tool, not a critical or scholarly edition, and does not claim to be an exhaustive or historically definitive account of any tradition.
3. Not a cultural or religious authority. This Service offers a general-interest folklore reference, not an authoritative religious, historical, or academic account of Arab or Islamic culture; consult a qualified source for those purposes.
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 bundled reference files, 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/hikaya

Hikaya (Story) support

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

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