{"openapi":"3.1.0","info":{"title":"Ensign API","version":"0.1.0","description":"A fully local world flags, national symbols, and vexillology reference: worded flag descriptions for a broad, globally-diverse set of UN member states, color-symbolism patterns, national bird/flower/motto/anthem reference, a vexillology glossary, and flag-design-principle facts.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://ensign.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/ensign/docs"},"termsOfService":"https://connectorbay.com/ensign/terms"},"servers":[{"url":"https://ensign.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/ensign/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/flag_description":{"post":{"operationId":"flag_description","summary":"A country's national flag described entirely in words: colors, composition/layout, symbols, official","description":"A country's national flag described entirely in words: colors, composition/layout, symbols, official\n    proportions, adoption date, and (where well-documented) its symbolic meaning. Text-only -- no image is\n    rendered. Use for \"describe the flag of Kenya\", \"what does the Brazilian flag look like\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country's name, official name, or common abbreviation.","examples":["Japan","United States","South Africa","UK"],"minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"flag_descriptionArguments","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/flag_search":{"post":{"operationId":"flag_search","summary":"Search flags by a color, symbol, or design-pattern keyword against each flag's own colors, symbols,","description":"Search flags by a color, symbol, or design-pattern keyword against each flag's own colors, symbols,\n    patterns and description. Use for \"which flags have a star\", \"which flags show an eagle\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A color, symbol, or pattern keyword.","examples":["star","cross","eagle","green"],"minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"flag_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/flags_by_color":{"post":{"operationId":"flags_by_color","summary":"Every bundled flag whose design includes the given color. Use for \"which countries have a green flag\",","description":"Every bundled flag whose design includes the given color. Use for \"which countries have a green flag\",\n    \"list flags with the color gold\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"color":{"description":"A color name.","examples":["red","green","gold","blue"],"minLength":1,"title":"Color","type":"string"}},"required":["color"],"title":"flags_by_colorArguments","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/flags_by_pattern":{"post":{"operationId":"flags_by_pattern","summary":"Every bundled flag matching a design pattern -- tricolour/bicolour, cross, saltire, Nordic (Scandinavian)","description":"Every bundled flag matching a design pattern -- tricolour/bicolour, cross, saltire, Nordic (Scandinavian)\n    cross, canton, or a single-color field with a central emblem, among others. Use for \"which flags are\n    tricolours\", \"which countries use a saltire\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pattern":{"description":"A design pattern.","examples":["tricolour","saltire","nordic cross","canton","single color field with emblem"],"minLength":1,"title":"Pattern","type":"string"}},"required":["pattern"],"title":"flags_by_patternArguments","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/color_symbolism_guide":{"post":{"operationId":"color_symbolism_guide","summary":"General, widely-documented vexillological patterns for what a color commonly represents across many","description":"General, widely-documented vexillological patterns for what a color commonly represents across many\n    flags (courage, the sky, land, and so on) -- general tendencies, never an invented specific meaning for one\n    flag. Use for \"what does red usually mean on a flag\", \"why are so many flags red white and blue\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A color to look up; omit to list all covered colors.","title":"Color"}},"title":"color_symbolism_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/national_symbol_info":{"post":{"operationId":"national_symbol_info","summary":"A country's national anthem name and, where well-documented, its official or widely-recognized national","description":"A country's national anthem name and, where well-documented, its official or widely-recognized national\n    bird, flower, and motto -- factual reference only, with unofficial/traditional items clearly labeled as\n    such. Use for \"does Japan have a national flower\", \"what's Kenya's national motto\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country's name, official name, or common abbreviation.","minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"national_symbol_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/vexillology_glossary":{"post":{"operationId":"vexillology_glossary","summary":"A fourteen-term glossary of real vexillological/heraldic terminology used to describe flag design.","description":"A fourteen-term glossary of real vexillological/heraldic terminology used to describe flag design.\n    Use for \"what is a saltire\", \"what does canton mean on a flag\", \"what is fimbriation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"canton | fess | pale | bend | saltire | chevron | tricolour | fimbriation | field | charge | roundel | nordic_cross | hoist_and_fly | defacement; omit to list all fourteen terms.","title":"Term"}},"title":"vexillology_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}},"/v1/tools/flag_design_principles_guide":{"post":{"operationId":"flag_design_principles_guide","summary":"General, verified flag-design facts: NAVA's \"Good Flag, Bad Flag\" five basic principles of flag design,","description":"General, verified flag-design facts: NAVA's \"Good Flag, Bad Flag\" five basic principles of flag design,\n    plus notable documented facts (the world's only non-quadrilateral national flag, the two square national\n    flags, the oldest continuously used flag design, and common design \"families\" like Nordic crosses and\n    Pan-African colors). Use for \"what makes a good flag design\", \"is there a standard flag shape\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"flag_design_principles_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/search":{"post":{"operationId":"search","summary":"General search across every reference entry in this connector -- countries/flags, the vexillology","description":"General search across every reference entry in this connector -- countries/flags, the vexillology\n    glossary, color-symbolism patterns, and flag-design facts. Use when you're not sure which specific tool\n    fits, e.g. \"saltire\", \"Ethiopia\", \"pan-african colors\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Any keyword: a country, color, symbol, vexillology term, or design concept.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"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}}}}