{"openapi":"3.1.0","info":{"title":"Abjad (Numerals) API","version":"0.1.0","description":"A fully local reference and calculator for Arabic numeral systems: Eastern/Western Arabic digit conversion, the traditional abjad letter-value system, Arabic number spelling, and verified Al-Khwarizmi history.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://abjad.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/abjad/docs"},"termsOfService":"https://connectorbay.com/abjad/terms"},"servers":[{"url":"https://abjad.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/abjad/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/to_eastern_arabic_numerals":{"post":{"operationId":"to_eastern_arabic_numerals","summary":"Convert a Western numeral (0-9) to Eastern Arabic-Indic digits (٠-٩) — the digits actually used for","description":"Convert a Western numeral (0-9) to Eastern Arabic-Indic digits (٠-٩) — the digits actually used for\n    writing numbers across most of the Arab world today. Use for \"convert 2026 to Arabic numerals\", \"write 42\n    in Eastern Arabic digits\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"number":{"description":"A Western number, as an int or digit string (sign and . or , separators allowed).","examples":["2026","42","-7.5"],"title":"Number","type":"string"}},"required":["number"],"title":"to_eastern_arabic_numeralsArguments","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/to_western_numerals":{"post":{"operationId":"to_western_numerals","summary":"Convert Eastern Arabic-Indic digits (٠-٩) back to Western numerals (0-9). Use for \"what number is","description":"Convert Eastern Arabic-Indic digits (٠-٩) back to Western numerals (0-9). Use for \"what number is\n    ٤٢\", \"convert ٢٠٢٦ to Western digits\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"eastern_arabic_string":{"description":"Eastern Arabic-Indic digit string (٠-٩); Persian/Urdu variant digits (۰-۹) are also accepted.","examples":["٢٠٢٦","٤٢"],"title":"Eastern Arabic String","type":"string"}},"required":["eastern_arabic_string"],"title":"to_western_numeralsArguments","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/numeral_systems_info":{"post":{"operationId":"numeral_systems_info","summary":"Explains the Eastern Arabic vs. Western Arabic numeral naming and history — including the genuine irony","description":"Explains the Eastern Arabic vs. Western Arabic numeral naming and history — including the genuine irony\n    that what English calls \"Arabic numerals\" (0-9) are the Western Arabic/Maghrebi descendant forms, not what\n    most Arabic speakers write, and that the underlying decimal system originated in India. Use for \"why are\n    they called Arabic numerals\", \"what's the difference between Eastern and Western Arabic numerals\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"numeral_systems_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/abjad_value":{"post":{"operationId":"abjad_value","summary":"Computes the traditional abjad numerical value of Arabic text: the sum of each letter's inherited","description":"Computes the traditional abjad numerical value of Arabic text: the sum of each letter's inherited\n    numeric value (ا=1, ب=2 ... غ=1000). Diacritics and non-letter characters are ignored. Use for \"abjad value\n    of a name\", \"what does this phrase add up to in abjad\", \"hisab al-jummal of بسم الله\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"text":{"description":"Arabic text (a word, name, or phrase) to sum.","examples":["محمد","بسم الله"],"title":"Text","type":"string"}},"required":["text"],"title":"abjad_valueArguments","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/abjad_letter_info":{"post":{"operationId":"abjad_letter_info","summary":"One Arabic letter's traditional abjad numeric value and name. Use for \"what's the abjad value of ب\",","description":"One Arabic letter's traditional abjad numeric value and name. Use for \"what's the abjad value of ب\",\n    \"abjad value of ك\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"letter":{"description":"A single Arabic letter.","examples":["ب","ك","ر"],"title":"Letter","type":"string"}},"required":["letter"],"title":"abjad_letter_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/abjad_system_info":{"post":{"operationId":"abjad_system_info","summary":"Historical explanation of the abjad system: the abjad-hawwaz letter order, its traditional uses for","description":"Historical explanation of the abjad system: the abjad-hawwaz letter order, its traditional uses for\n    numbering, chronograms (dates encoded in a phrase's letter-sum) and numerology — distinct from the modern\n    digit systems. Use for \"how does the abjad system work\", \"what is a chronogram\", \"history of abjad\n    numerals\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"abjad_system_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/al_khwarizmi_info":{"post":{"operationId":"al_khwarizmi_info","summary":"A verified, factual biography of Muhammad ibn Musa al-Khwarizmi — the 9th-century Baghdad scholar","description":"A verified, factual biography of Muhammad ibn Musa al-Khwarizmi — the 9th-century Baghdad scholar\n    behind both the word \"algorithm\" (from a Latinization of his name) and \"algebra\" (from al-jabr, his\n    treatise's title) — and his role transmitting the Hindu-Arabic numeral system to Europe. Use for \"who was\n    al-Khwarizmi\", \"where does the word algorithm come from\", \"who invented algebra\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"al_khwarizmi_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/number_word_info":{"post":{"operationId":"number_word_info","summary":"Spells out a number (0-999) in Arabic script and transliteration — ones, teens, tens and hundreds,","description":"Spells out a number (0-999) in Arabic script and transliteration — ones, teens, tens and hundreds,\n    with the ones-and-tens order and wa- (and) joining that Arabic grammar uses. Use for \"how do you say 47 in\n    Arabic\", \"spell out 235 in Arabic\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"number":{"description":"A whole number from 0 to 999.","maximum":999,"minimum":0,"title":"Number","type":"integer"},"language":{"default":"arabic","description":"Only 'arabic' is supported.","title":"Language","type":"string"}},"required":["number"],"title":"number_word_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/numeral_glossary":{"post":{"operationId":"numeral_glossary","summary":"Definitions of numeral-and-abjad terms (abjad, chronogram, sifr, ghubar numerals, hisab al-jummal,","description":"Definitions of numeral-and-abjad terms (abjad, chronogram, sifr, ghubar numerals, hisab al-jummal,\n    al-jabr, algorism, House of Wisdom, and more). Use for \"what does sifr mean\", \"what is a ghubar numeral\",\n    \"what does al-jabr mean\".","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; omit to list all.","title":"Term"}},"title":"numeral_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}}}}