{"openapi":"3.1.0","info":{"title":"Zakhrafa (Ornament) API","version":"0.1.0","description":"A fully local Islamic/Arab geometric ornament and pattern-design reference: 14 pattern families and topics, n-fold symmetry systems, the arabesque/geometric distinction, muqarnas vaulting, regional tilework traditions, and historical context.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://zakhrafa.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/zakhrafa/docs"},"termsOfService":"https://connectorbay.com/zakhrafa/terms"},"servers":[{"url":"https://zakhrafa.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/zakhrafa/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/pattern_family_info":{"post":{"operationId":"pattern_family_info","summary":"One geometric pattern family's construction principle, symmetry type and common name — covers 14","description":"One geometric pattern family's construction principle, symmetry type and common name — covers 14\n    pattern families and topics, from girih star patterns and n-fold symmetry systems to tessellation\n    principles, interlace strapwork, arabesque and muqarnas. Use for \"what is girih\", \"what's an 8-fold\n    pattern\", \"what is interlace strapwork\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A geometric pattern family's name or alias.","examples":["girih","sixfold","muqarnas","arabesque","tessellation","interlace"],"title":"Name","type":"string"}},"required":["name"],"title":"pattern_family_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/pattern_search":{"post":{"operationId":"pattern_search","summary":"Search all geometric pattern families by partial name, alias, or a word from their description or","description":"Search all geometric pattern families by partial name, alias, or a word from their description or\n    construction principle. Use for \"patterns based on pentagons\", \"which pattern uses two overlapping\n    squares\", \"star patterns found in domes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial name, alias, or a word from a pattern family's description, common name or construction principle.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"pattern_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/patterns_by_symmetry":{"post":{"operationId":"patterns_by_symmetry","summary":"Geometric pattern families grouped by n-fold rotational symmetry — 6-fold, 8-fold, 10-fold or 12-fold","description":"Geometric pattern families grouped by n-fold rotational symmetry — 6-fold, 8-fold, 10-fold or 12-fold\n    systems (and 5-fold for the quasi-periodic girih-tile family). Use for \"what are 8-fold patterns\", \"show\n    me 12-fold symmetry patterns\", \"which patterns have 10-fold symmetry\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"fold":{"description":"An n-fold rotational symmetry order: 6, 8, 10 or 12 (also accepts 5 for fivefold/quasi-periodic patterns).","examples":["6","8","10","12","eightfold","12-fold"],"title":"Fold","type":"string"}},"required":["fold"],"title":"patterns_by_symmetryArguments","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/arabesque_vs_geometric_guide":{"post":{"operationId":"arabesque_vs_geometric_guide","summary":"Clearly explains the distinction between arabesque (vegetal/biomorphic scrollwork ornament) and","description":"Clearly explains the distinction between arabesque (vegetal/biomorphic scrollwork ornament) and\n    geometric ornament (measured, compass-and-straightedge polygon construction) — two design traditions that\n    are often confused, especially since they are frequently combined in the same composition. Use for\n    \"what's the difference between arabesque and geometric patterns\", \"is arabesque geometric\", \"what is\n    islimi\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"arabesque_vs_geometric_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/muqarnas_guide":{"post":{"operationId":"muqarnas_guide","summary":"The three-dimensional honeycomb/stalactite vaulting ornament explained — its structural function","description":"The three-dimensional honeycomb/stalactite vaulting ornament explained — its structural function\n    bridging a square room to a round dome, its purely decorative uses, where it is typically found\n    (entrances, dome interiors, corners, niches), materials, and regional variation, described architecturally\n    rather than theologically. Use for \"what is muqarnas\", \"how does muqarnas work structurally\", \"where is\n    muqarnas used\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"muqarnas_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/construction_method_guide":{"post":{"operationId":"construction_method_guide","summary":"The general compass-and-straightedge construction principle for building a basic star pattern —","description":"The general compass-and-straightedge construction principle for building a basic star pattern —\n    conceptual and descriptive (how a circle is divided and connected to generate a star shape), not a full\n    step-by-step technical tutorial with exact coordinates or angle tables. Optionally pass a specific n-fold\n    system for a construction note on that system. Use for \"how are Islamic star patterns constructed\", \"how\n    do you draw an 8-pointed star\", \"compass and straightedge geometric pattern method\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pattern":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional: a specific n-fold system to get a construction note for (6-fold, 8-fold, 10-fold, or 12-fold). Omit for the general conceptual walkthrough.","title":"Pattern"}},"title":"construction_method_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/regional_tilework_info":{"post":{"operationId":"regional_tilework_info","summary":"Zellige (Maghrebi), Andalusian, and Persian-influenced regional tilework traditions — technique,","description":"Zellige (Maghrebi), Andalusian, and Persian-influenced regional tilework traditions — technique,\n    pattern character and typical architectural context, described typologically. Use for \"what is zellige\",\n    \"how is Andalusian tilework different from zellige\", \"what is haft rangi tile technique\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A regional tilework tradition's name.","examples":["zellige","andalusian","persian","maghrebi","alhambra"],"title":"Region","type":"string"}},"required":["region"],"title":"regional_tilework_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/historical_context_info":{"post":{"operationId":"historical_context_info","summary":"A general historical-development note on Islamic geometric ornament — Umayyad-era origins, Abbasid and","description":"A general historical-development note on Islamic geometric ornament — Umayyad-era origins, Abbasid and\n    later elaboration into denser star systems and muqarnas, its documented historical connection to\n    Islamic-era mathematical scholarship (including a specific named 10th-century treatise on geometric\n    constructions for craftsmen), and modern mathematical re-analysis of historical patterns. Use for \"when\n    did Islamic geometric patterns develop\", \"is there a math connection to Islamic geometric art\", \"history\n    of girih patterns\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"historical_context_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/ornament_glossary":{"post":{"operationId":"ornament_glossary","summary":"Definitions of common geometric-ornament terms (zakhrafa, girih, arabesque, muqarnas, zellige, tawriq,","description":"Definitions of common geometric-ornament terms (zakhrafa, girih, arabesque, muqarnas, zellige, tawriq,\n    islimi, interlace/strapwork, n-fold symmetry, handasa, mihrab). Use for \"what does girih mean\", \"what's\n    tawriq\", \"what does zakhrafa 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":"ornament_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}}}}