{"openapi":"3.1.0","info":{"title":"Nisba (Names) API","version":"0.1.0","description":"A fully local Arabic given-names and naming-convention reference: 60+ common Arabic given names (male, female and unisex) with meaning and origin notes, the traditional Arabic naming structure (ism, nasab, kunya, nisba, laqab) with a worked example, kunya and nisba custom guides, a general naming-trend pattern note, and a ten-term naming glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://nisba.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/nisba/docs"},"termsOfService":"https://connectorbay.com/nisba/terms"},"servers":[{"url":"https://nisba.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/nisba/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/name_info":{"post":{"operationId":"name_info","summary":"Look up one Arabic given name: its Arabic script, meaning, gender association, root/etymology note,","description":"Look up one Arabic given name: its Arabic script, meaning, gender association, root/etymology note,\n    and a short usage note. Use for \"what does the name Layla mean\", \"is Sami a boy's or girl's name\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"An Arabic given name, in script or transliteration (exact or partial).","examples":["Layla","ليلى","Yusuf"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"name_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/name_search":{"post":{"operationId":"name_search","summary":"Search every name's transliteration, Arabic text, meaning, origin note and meaning categories for a","description":"Search every name's transliteration, Arabic text, meaning, origin note and meaning categories for a\n    keyword. Use for \"Arabic names that mean light\", \"any name related to gazelles\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A meaning keyword (e.g. 'light', 'hope', 'gazelle') or a name to search for.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"name_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/names_by_meaning_category":{"post":{"operationId":"names_by_meaning_category","summary":"List every name tagged with one meaning theme -- light, strength, beauty, nature, virtue, wisdom,","description":"List every name tagged with one meaning theme -- light, strength, beauty, nature, virtue, wisdom,\n    nobility, generosity, joy, love, peace, abundance, or faith. Use for \"Arabic names that mean strength\",\n    \"names about nature for a girl\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"A meaning theme, e.g. light, strength, beauty, nature, virtue, wisdom, nobility, generosity, joy, love, peace, abundance, faith.","minLength":1,"title":"Category","type":"string"}},"required":["category"],"title":"names_by_meaning_categoryArguments","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/names_by_gender":{"post":{"operationId":"names_by_gender","summary":"List every name in one gender group -- male, female, or unisex. Use for \"list of Arabic boys'","description":"List every name in one gender group -- male, female, or unisex. Use for \"list of Arabic boys'\n    names\", \"unisex Arabic names\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gender":{"description":"male, female, or unisex.","minLength":1,"title":"Gender","type":"string"}},"required":["gender"],"title":"names_by_genderArguments","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/naming_structure_guide":{"post":{"operationId":"naming_structure_guide","summary":"Explains the five traditional parts of an Arabic name -- ism (personal name), nasab (patronymic,","description":"Explains the five traditional parts of an Arabic name -- ism (personal name), nasab (patronymic,\n    ibn/bint), kunya (teknonym, Abu/Umm), nisba (attributive name from origin, tribe or profession) and\n    laqab (epithet) -- with a fully worked fictional example name showing every part. Use for \"explain ism\n    nasab kunya nisba laqab\", \"how are traditional Arabic names structured\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"naming_structure_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/kunya_guide":{"post":{"operationId":"kunya_guide","summary":"Explains the kunya (Abu/Umm) teknonym custom -- how it's built, how and why it's used, and generic","description":"Explains the kunya (Abu/Umm) teknonym custom -- how it's built, how and why it's used, and generic\n    illustrative examples. Use for \"what is a kunya\", \"why do people say Abu Khalid instead of a first\n    name\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"kunya_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/nisba_guide":{"post":{"operationId":"nisba_guide","summary":"Explains the nisba attributive-surname custom -- an Arabic name formed from a place, tribe or","description":"Explains the nisba attributive-surname custom -- an Arabic name formed from a place, tribe or\n    profession, usually ending in -i/-iyya -- with generic illustrative examples. Use for \"why do some\n    Arabic surnames end in -i\", \"what is a nisba\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"nisba_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/popular_names_by_decade_note":{"post":{"operationId":"popular_names_by_decade_note","summary":"A general, qualitative, clearly-caveated note on Arabic naming-trend patterns -- which kinds of","description":"A general, qualitative, clearly-caveated note on Arabic naming-trend patterns -- which kinds of\n    names tend to stay popular, and how naming style varies by region -- never sourced ranking or\n    statistical data. Use for \"are classical Arabic names still popular\", \"how do Arabic naming trends\n    vary by country\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"popular_names_by_decade_noteArguments","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/naming_glossary":{"post":{"operationId":"naming_glossary","summary":"A short glossary of ten terms about Arabic personal-naming structure: ism, nasab, kunya, nisba,","description":"A short glossary of ten terms about Arabic personal-naming structure: ism, nasab, kunya, nisba,\n    laqab, ibn/bint, Abu/Umm, shuhra, silsila, and the definite article al-. Use for \"what does nisba\n    mean\", \"what's the difference between a laqab and a kunya\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ism | nasab | kunya | nisba | laqab | ibn_bint | abu_umm | shuhra | silsila | al_tarif; omit to list all ten terms.","title":"Term"}},"title":"naming_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}}}}