{"openapi":"3.1.0","info":{"title":"Adab (Literature) API","version":"0.1.0","description":"A fully local reference of classical and modern Arabic literature: the adab concept, poetic forms, classical and modern poets, the maqama genre, modern literature landmarks, literary eras, thematic genres, and a glossary, in original hand-written prose.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://adab.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/adab/docs"},"termsOfService":"https://connectorbay.com/adab/terms"},"servers":[{"url":"https://adab.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/adab/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/poet_info":{"post":{"operationId":"poet_info","summary":"A classical or modern Arabic poet's biography, era, and thematic significance -- factual, never with","description":"A classical or modern Arabic poet's biography, era, and thematic significance -- factual, never with\n    quoted verse. Use for \"tell me about Al-Mutanabbi\", \"who was Al-Khansa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A classical or modern Arabic poet's name.","examples":["Al-Mutanabbi","Imru' al-Qais","Mahmoud Darwish"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"poet_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/poet_search":{"post":{"operationId":"poet_search","summary":"Keyword search across poet names, eras, contexts, and significance notes. Use for \"which poets wrote","description":"Keyword search across poet names, eras, contexts, and significance notes. Use for \"which poets wrote\n    in Andalusia\", \"find poets known for love poetry\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search across poet names, eras, and significance notes.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"poet_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/adab_concept_guide":{"post":{"operationId":"adab_concept_guide","summary":"The classical Arabic \"adab\" concept explained -- the ideal fusing literary refinement with ethics","description":"The classical Arabic \"adab\" concept explained -- the ideal fusing literary refinement with ethics\n    and good manners, and how its meaning shifted from pre-Islamic custom through Abbasid belles-lettres to\n    today's everyday sense of \"literature.\" Use for \"what does adab mean\", \"explain the adab concept\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"adab_concept_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/poetic_form_info":{"post":{"operationId":"poetic_form_info","summary":"A classical poetic form's structure and significance: the qasida's three-part nasib/rahil/gharad","description":"A classical poetic form's structure and significance: the qasida's three-part nasib/rahil/gharad\n    structure, or the Mu'allaqat (\"Hanging Odes\") anthology and its legend -- structural and historical\n    description only, no verse text. Use for \"explain the structure of a qasida\", \"what are the\n    Mu'allaqat\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"qasida | muallaqat (the Hanging Odes)","minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"poetic_form_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/maqama_genre_guide":{"post":{"operationId":"maqama_genre_guide","summary":"The maqama literary genre explained: rhymed-prose (saj') narrative built around a fixed narrator and","description":"The maqama literary genre explained: rhymed-prose (saj') narrative built around a fixed narrator and\n    a recurring roguish protagonist, originated by Al-Hamadhani and brought to its height by Al-Hariri of\n    Basra. Use for \"what is a maqama\", \"who invented the maqama genre\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"maqama_genre_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/modern_literature_landmarks_info":{"post":{"operationId":"modern_literature_landmarks_info","summary":"Naguib Mahfouz's 1988 Nobel Prize in Literature -- the first for a writer in the Arabic language --","description":"Naguib Mahfouz's 1988 Nobel Prize in Literature -- the first for a writer in the Arabic language --\n    and a brief note on the modern Arabic novel's development. Use for \"when did Naguib Mahfouz win the\n    Nobel Prize\", \"how did the modern Arabic novel develop\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"modern_literature_landmarks_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/literary_era_overview":{"post":{"operationId":"literary_era_overview","summary":"One era's periodization, description, and key figures -- pre-Islamic (Jahiliyyah), Abbasid Golden","description":"One era's periodization, description, and key figures -- pre-Islamic (Jahiliyyah), Abbasid Golden\n    Age, Andalusian, Nahda, or modern -- or the full list of eras if none is given. Use for \"what happened\n    in the Abbasid Golden Age\", \"list the eras of Arabic literature\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"era":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"pre-Islamic/Jahiliyyah, Abbasid, Andalusian, Nahda, or modern. Omit for the full list of eras.","title":"Era"}},"title":"literary_era_overviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/themes_and_genres_guide":{"post":{"operationId":"themes_and_genres_guide","summary":"The common classical thematic genres of Arabic poetry -- madih (praise), hija (satire), ritha","description":"The common classical thematic genres of Arabic poetry -- madih (praise), hija (satire), ritha\n    (elegy), ghazal (love poetry), fakhr (boasting), wasf (description), and zuhd (asceticism) -- explained\n    as literary conventions, never illustrated with quoted lines. Use for \"what is ghazal poetry\", \"what\n    does hija mean in Arabic poetry\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"themes_and_genres_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/literary_glossary":{"post":{"operationId":"literary_glossary","summary":"About a dozen terms central to Arabic literary tradition -- the full glossary if no term is given, or","description":"About a dozen terms central to Arabic literary tradition -- the full glossary if no term is given, or\n    one term's definition. Use for \"what does diwan mean\", \"list some Arabic literary terms\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up, such as 'diwan' or 'qafiya'. Omit for the full glossary.","title":"Term"}},"title":"literary_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}