{"openapi":"3.1.0","info":{"title":"Naskh (Calligraphy) API","version":"0.1.0","description":"A fully local Arabic calligraphy reference: seven major script styles, tools of the trade, practice guidance and the nuqta proportion system, historically significant calligraphers, the 2021 UNESCO Intangible Cultural Heritage inscription, and contemporary applications.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://naskh.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/naskh/docs"},"termsOfService":"https://connectorbay.com/naskh/terms"},"servers":[{"url":"https://naskh.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/naskh/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/script_info":{"post":{"operationId":"script_info","summary":"One calligraphy script style's history, characteristics, and typical use — covers Naskh, Thuluth,","description":"One calligraphy script style's history, characteristics, and typical use — covers Naskh, Thuluth,\n    Diwani, Kufic, Ruq'ah, Nasta'liq, and Maghrebi. Use for \"what is Thuluth script\", \"history of Kufic\",\n    \"what is Diwani used for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A calligraphy script style's name or alias.","examples":["Naskh","Thuluth","Diwani","Kufic","Ruq'ah","Nasta'liq","Maghrebi"],"title":"Name","type":"string"}},"required":["name"],"title":"script_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/script_search":{"post":{"operationId":"script_search","summary":"Search all calligraphy script styles by partial name, alias, or a word from their description or use.","description":"Search all calligraphy script styles by partial name, alias, or a word from their description or use.\n    Use for \"which script is used for Quran chapter headings\", \"scripts used in Ottoman documents\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial name, alias, or a word from a script's description, characteristics, or typical use.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"script_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/scripts_by_era":{"post":{"operationId":"scripts_by_era","summary":"Calligraphy script styles grouped by era — early Islamic, Abbasid, Ottoman, Persian/Timurid,","description":"Calligraphy script styles grouped by era — early Islamic, Abbasid, Ottoman, Persian/Timurid,\n    Andalusian/Maghrebi, or the scripts still in wide contemporary use. Use for \"what scripts came from the\n    early Islamic period\", \"which scripts are Ottoman\", \"which scripts are still used today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"era":{"description":"early Islamic | Abbasid | Ottoman | Persian/Timurid | Andalusian/Maghrebi | contemporary.","title":"Era","type":"string"}},"required":["era"],"title":"scripts_by_eraArguments","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/tools_guide":{"post":{"operationId":"tools_guide","summary":"The traditional tools of Arabic calligraphy: qalam (reed pen) preparation and cutting, traditional ink","description":"The traditional tools of Arabic calligraphy: qalam (reed pen) preparation and cutting, traditional ink\n    (midad) preparation, and paper treatment (ahar sizing). Use for \"how do you cut a qalam\", \"how is\n    traditional calligraphy ink made\", \"what is ahar paper\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"tools_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/practice_guide":{"post":{"operationId":"practice_guide","summary":"General practice guidance for learning Arabic calligraphy, including the historical dot (nuqta)","description":"General practice guidance for learning Arabic calligraphy, including the historical dot (nuqta)\n    proportion system used to standardize letterforms, and beginner or intermediate-level guidance. Use for\n    \"how do I start learning Arabic calligraphy\", \"what is the nuqta proportion system\", \"intermediate\n    calligraphy practice tips\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"level":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"beginner | intermediate. Omit for the proportion system and general guidance only.","title":"Level"}},"title":"practice_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/famous_calligraphers_info":{"post":{"operationId":"famous_calligraphers_info","summary":"Strictly biographical, historical facts — dates, role, and calligraphic significance — for a small","description":"Strictly biographical, historical facts — dates, role, and calligraphic significance — for a small\n    set of historically significant calligraphers: Ibn Muqla, Ibn al-Bawwab, Yaqut al-Musta'simi, Hamid\n    Aytaç, and Hashim al-Baghdadi. No living calligrapher is covered. Use for \"who was Ibn Muqla\", \"tell me\n    about Yaqut al-Musta'simi\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A calligrapher's name or alias; omit to list all.","examples":["Ibn Muqla","Ibn al-Bawwab","Yaqut al-Musta'simi","Hamid Aytaç","Hashim al-Baghdadi"],"title":"Name"}},"title":"famous_calligraphers_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/unesco_heritage_info":{"post":{"operationId":"unesco_heritage_info","summary":"The 2021 UNESCO Intangible Cultural Heritage inscription of Arabic calligraphy — the inscription","description":"The 2021 UNESCO Intangible Cultural Heritage inscription of Arabic calligraphy — the inscription\n    date, the list it sits on, and the sixteen nominating countries. Use for \"is Arabic calligraphy\n    UNESCO-listed\", \"when was Arabic calligraphy UNESCO-listed\", \"which countries nominated Arabic\n    calligraphy for UNESCO\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"unesco_heritage_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/modern_usage_guide":{"post":{"operationId":"modern_usage_guide","summary":"Contemporary applications of Arabic calligraphy — logo design, digital typography, and calligraffiti","description":"Contemporary applications of Arabic calligraphy — logo design, digital typography, and calligraffiti\n    street art — described factually. Use for \"how is calligraphy used in logo design today\", \"what is\n    calligraffiti\", \"how does calligraphy influence digital Arabic fonts\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"modern_usage_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/calligraphy_glossary":{"post":{"operationId":"calligraphy_glossary","summary":"Definitions of common Arabic calligraphy terms (khatt, qalam, midad, nuqta, thuluth, naskh, diwani,","description":"Definitions of common Arabic calligraphy terms (khatt, qalam, midad, nuqta, thuluth, naskh, diwani,\n    kufic, jali, ahar, mashq, ijazah, calligraffiti). Use for \"what does nuqta mean\", \"what is khatt\", \"what's\n    ahar paper\".","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":"calligraphy_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}}}}