{"openapi":"3.1.0","info":{"title":"Quill API","version":"0.1.0","description":"A fully local Western/Latin-script calligraphy reference: seven major script traditions from Roman capitals to the modern brush-lettering revival, broad-edge/pointed-pen/brush tool-family technique guides, historical context (the Carolingian reform, monastic scriptoria, the printing press), practice basics, letterform anatomy, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://quill.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/quill/docs"},"termsOfService":"https://connectorbay.com/quill/terms"},"servers":[{"url":"https://quill.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/quill/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 Western/Latin-script calligraphy tradition's history, characteristics, and typical use — covers Roman","description":"One Western/Latin-script calligraphy tradition's history, characteristics, and typical use — covers Roman\n    Capitals, Uncial, Carolingian Minuscule, Gothic/Blackletter, Italic/Chancery Cursive, Copperplate/Spencerian,\n    and Modern Brush Lettering & Pointed-Pen Calligraphy. Use for \"what is Carolingian minuscule\", \"history of\n    blackletter\", \"what is Spencerian script\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A Western calligraphy script's name or alias.","examples":["Roman Capitals","Uncial","Carolingian Minuscule","Blackletter","Italic","Copperplate","Spencerian","brush lettering"],"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 Western calligraphy scripts by partial name, alias, or a word from their description or use.","description":"Search all Western calligraphy scripts by partial name, alias, or a word from their description or use.\n    Use for \"which script was used for the Gutenberg Bible\", \"scripts used in Renaissance Italy\".","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":"Western calligraphy scripts grouped by era — Roman, early medieval, Gothic, Renaissance/Italic, or","description":"Western calligraphy scripts grouped by era — Roman, early medieval, Gothic, Renaissance/Italic, or\n    modern. Use for \"what scripts came from the Roman era\", \"which scripts are Gothic\", \"which scripts are\n    modern\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"era":{"description":"Roman | early medieval | Gothic | Renaissance/Italic | modern.","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/tool_family_guide":{"post":{"operationId":"tool_family_guide","summary":"The broad-edge pen, pointed-pen, and brush tool families used across calligraphy history, and how their","description":"The broad-edge pen, pointed-pen, and brush tool families used across calligraphy history, and how their\n    stroke-width techniques genuinely differ (pen angle vs. hand pressure). Use for \"difference between\n    broad-edge and pointed-pen calligraphy\", \"what pen do I need for Copperplate\", \"how does brush lettering\n    work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"family":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"broad_edge | pointed_pen | brush. Omit to list all three.","title":"Family"}},"title":"tool_family_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/historical_context_info":{"post":{"operationId":"historical_context_info","summary":"Historical context for Western calligraphy: the Carolingian reform under Charlemagne and Alcuin of York,","description":"Historical context for Western calligraphy: the Carolingian reform under Charlemagne and Alcuin of York,\n    the role of monastic scriptoria in preserving and standardizing scripts, and the printing press's historical\n    impact on hand lettering. Use for \"was the Carolingian reform really under Charlemagne\", \"what is a\n    scriptorium\", \"how did the printing press affect calligraphy\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"carolingian_reform | monastic_scriptoria | printing_press_impact. Omit to list all.","title":"Topic"}},"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/practice_basics_guide":{"post":{"operationId":"practice_basics_guide","summary":"General beginner guidance on paper, ink, and nib/pen selection for modern calligraphy practice, plus","description":"General beginner guidance on paper, ink, and nib/pen selection for modern calligraphy practice, plus\n    general beginner tips. Use for \"what paper should I use for calligraphy\", \"what ink is best for a pointed\n    pen\", \"how do I start learning calligraphy\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"paper | ink | nib_and_pen_selection | beginner_guidance. Omit for all topics plus a general note.","title":"Topic"}},"title":"practice_basics_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/letterform_anatomy_guide":{"post":{"operationId":"letterform_anatomy_guide","summary":"Calligraphy and typography letterform anatomy terms — x-height, ascender, descender, cap height,","description":"Calligraphy and typography letterform anatomy terms — x-height, ascender, descender, cap height,\n    baseline, counter, serif, stroke contrast, ductus, minim, majuscule, minuscule, swash, and versal. Use for\n    \"what does x-height mean\", \"what is a counter in typography\", \"what's the difference between majuscule and\n    minuscule\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"letterform_anatomy_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_revival_info":{"post":{"operationId":"modern_revival_info","summary":"A factual note on modern brush lettering and pointed-pen calligraphy's popularity resurgence since","description":"A factual note on modern brush lettering and pointed-pen calligraphy's popularity resurgence since\n    roughly the 2010s, and how it connects historically to 19th-century pointed-pen penmanship. General\n    commentary on the trend only, with no discussion of any specific living artist. Use for \"is modern\n    calligraphy popular again\", \"why is brush lettering trendy\", \"how does brush lettering relate to\n    Spencerian script\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"modern_revival_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/calligraphy_glossary":{"post":{"operationId":"calligraphy_glossary","summary":"Definitions of common Western calligraphy and lettering terms (nib, ductus, versal, majuscule, minuscule,","description":"Definitions of common Western calligraphy and lettering terms (nib, ductus, versal, majuscule, minuscule,\n    x-height, serif, counter, broad-edge pen, pointed pen, faux calligraphy, scriptorium, and more). Use for\n    \"what does ductus mean\", \"what is a versal\", \"what's faux calligraphy\".","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}}}}