{"openapi":"3.1.0","info":{"title":"Starlore API","version":"0.1.0","description":"A hand-curated constellation guide and mythology reference: all 88 official IAU constellations with origin stories, notable stars, viewing-season/hemisphere guidance, the zodiac as astronomy, well-known asterisms, and an astronomy glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://starlore.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/starlore/docs"},"termsOfService":"https://connectorbay.com/starlore/terms"},"servers":[{"url":"https://starlore.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/starlore/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/constellation_info":{"post":{"operationId":"constellation_info","summary":"One constellation's mythology and cultural origin story, notable stars, general best-viewing season, and","description":"One constellation's mythology and cultural origin story, notable stars, general best-viewing season, and\n    which hemisphere it's best seen from. Use for \"tell me about Orion\", \"what's the story behind Cassiopeia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Constellation name, abbreviation, or Latin genitive.","examples":["Orion","Ori","Ursa Major","Crux"],"title":"Name","type":"string"}},"required":["name"],"title":"constellation_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/constellation_search":{"post":{"operationId":"constellation_search","summary":"Search all 88 constellations by partial name, meaning, or a keyword from their mythology or notes. Use","description":"Search all 88 constellations by partial name, meaning, or a keyword from their mythology or notes. Use\n    for \"which constellation is about a hunter\", \"find constellations with dragon myths\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial name, meaning, or a myth/culture keyword.","examples":["hunter","twins","crown","dragon"],"minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"constellation_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/constellations_by_season":{"post":{"operationId":"constellations_by_season","summary":"General, qualitative guide to which constellations are prominent in a given season and hemisphere.","description":"General, qualitative guide to which constellations are prominent in a given season and hemisphere.\n    Reference-level guidance only, not a live ephemeris — exact visibility depends on latitude, date, and time\n    of night; for precise current sky positions see the sibling connectors Skywatch or Cosmos. Use for \"what\n    constellations can I see in winter\", \"spring constellations in the southern hemisphere\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"spring | summer | autumn (or fall) | winter","title":"Season","type":"string"},"hemisphere":{"default":"northern","description":"northern | southern","title":"Hemisphere","type":"string"}},"required":["season"],"title":"constellations_by_seasonArguments","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/constellations_by_hemisphere":{"post":{"operationId":"constellations_by_hemisphere","summary":"Constellations best seen only from the northern hemisphere, only from the southern hemisphere, or from","description":"Constellations best seen only from the northern hemisphere, only from the southern hemisphere, or from\n    both. Use for \"which constellations can I only see from the southern hemisphere\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"hemisphere":{"description":"northern | southern | both","title":"Hemisphere","type":"string"}},"required":["hemisphere"],"title":"constellations_by_hemisphereArguments","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/mythology_story":{"post":{"operationId":"mythology_story","summary":"The fuller cultural and mythological story behind a constellation's name, standalone (a focused subset","description":"The fuller cultural and mythological story behind a constellation's name, standalone (a focused subset\n    of constellation_info). Original prose, not lifted from any specific retelling. Use for \"what's the myth\n    behind Scorpius\", \"why is it called the Southern Cross\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"constellation":{"description":"Constellation name.","examples":["Perseus","Scorpius"],"title":"Constellation","type":"string"}},"required":["constellation"],"title":"mythology_storyArguments","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/star_info":{"post":{"operationId":"star_info","summary":"Brief facts for a notable named star: which constellation it's in, its approximate brightness rank among","description":"Brief facts for a notable named star: which constellation it's in, its approximate brightness rank among\n    naked-eye stars, and a notable fact. Use for \"tell me about Betelgeuse\", \"how bright is Sirius\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A notable named star.","examples":["Sirius","Betelgeuse","Polaris"],"title":"Name","type":"string"}},"required":["name"],"title":"star_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/zodiac_constellations":{"post":{"operationId":"zodiac_constellations","summary":"The 13 constellations the ecliptic (the Sun's apparent yearly path) actually passes through, in order,","description":"The 13 constellations the ecliptic (the Sun's apparent yearly path) actually passes through, in order,\n    with approximate current sun-transit dates. Presented as astronomy, not astrology — includes a note\n    distinguishing this from the traditional 12-sign astrological calendar. Use for \"which constellations does\n    the sun pass through\", \"is Ophiuchus really the 13th zodiac sign\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"zodiac_constellationsArguments","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/asterism_guide":{"post":{"operationId":"asterism_guide","summary":"Well-known star patterns that are NOT official constellations — which constellation(s) they belong to or","description":"Well-known star patterns that are NOT official constellations — which constellation(s) they belong to or\n    span, their stars, and a clear explanation of the asterism-vs-constellation distinction. Use for \"is the Big\n    Dipper a constellation\", \"what stars make up the Summer Triangle\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A well-known asterism, e.g. Big Dipper, Summer Triangle, Orion's Belt, Northern Cross. Omit to list all.","title":"Name"}},"title":"asterism_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/astronomy_glossary":{"post":{"operationId":"astronomy_glossary","summary":"Definitions of core astronomy terms used throughout this connector (asterism, circumpolar, magnitude,","description":"Definitions of core astronomy terms used throughout this connector (asterism, circumpolar, magnitude,\n    ecliptic, IAU, zodiac, and more). Use for \"what does circumpolar mean\", \"what's the ecliptic\".","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":"astronomy_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}}}}