{"openapi":"3.1.0","info":{"title":"Cosmos API","version":"0.1.0","description":"NASA images; exoplanets; asteroids, comets and close approaches; stars and deep-sky objects; space weather and solar activity; spaceflight news; astronauts.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://cosmos.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/cosmos/docs"},"termsOfService":"https://connectorbay.com/cosmos/terms"},"servers":[{"url":"https://cosmos.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/cosmos/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/nasa_images":{"post":{"operationId":"nasa_images","summary":"Search NASA's Image and Video Library (140,000+ public-domain items): title, date, center, description, keywords,","description":"Search NASA's Image and Video Library (140,000+ public-domain items): title, date, center, description, keywords,\n    thumbnail and page link. Use for \"photos of Apollo 11\", \"videos of the Artemis launch\", \"Hubble images of the\n    Pillars of Creation\", \"JPL images of Europa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Search words.","examples":["Apollo 11","Jupiter Great Red Spot","Hubble deep field"],"title":"Query","type":"string"},"media_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"image | video | audio (default all)","title":"Media Type"},"year_from":{"anyOf":[{"maximum":2100,"minimum":1900,"type":"integer"},{"type":"null"}],"default":null,"title":"Year From"},"year_to":{"anyOf":[{"maximum":2100,"minimum":1900,"type":"integer"},{"type":"null"}],"default":null,"title":"Year To"},"center":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"NASA center code: JSC, KSC, GSFC, JPL, MSFC, ARC, HQ, LRC, GRC…","title":"Center"},"max_results":{"default":10,"maximum":25,"minimum":1,"title":"Max Results","type":"integer"},"page":{"default":1,"maximum":50,"minimum":1,"title":"Page","type":"integer"}},"required":["query"],"title":"nasa_imagesArguments","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/nasa_asset":{"post":{"operationId":"nasa_asset","summary":"Full-size files for one NASA library item (original, large, medium, small; video/audio media and captions)","description":"Full-size files for one NASA library item (original, large, medium, small; video/audio media and captions)\n    plus its metadata. Use for \"give me the full-resolution version of that image\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"nasa_id":{"description":"NASA media id from nasa_images.","examples":["as11-40-5874","PIA23623"],"title":"Nasa Id","type":"string"}},"required":["nasa_id"],"title":"nasa_assetArguments","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/exoplanet_search":{"post":{"operationId":"exoplanet_search","summary":"Search 6,000+ confirmed exoplanets (NASA Exoplanet Archive composite parameters): name, host, discovery","description":"Search 6,000+ confirmed exoplanets (NASA Exoplanet Archive composite parameters): name, host, discovery\n    method/year/facility, orbit, radius and mass (Earth and Jupiter units), equilibrium temperature, size class,\n    star properties and distance. Use for \"nearest Earth-size planets\", \"temperate planets within 50 light-years\",\n    \"planets found by JWST\", \"TRAPPIST-1 system\", \"planets discovered in 2025 by TESS\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Planet name or part.","examples":["TRAPPIST-1","Kepler-452"],"title":"Name"},"host":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Host star name or part.","examples":["Proxima"],"title":"Host"},"year":{"anyOf":[{"maximum":2100,"minimum":1989,"type":"integer"},{"type":"null"}],"default":null,"description":"Discovery year.","title":"Year"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"transit | rv | imaging | microlensing | timing | astrometry | ttv","title":"Method"},"facility":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Discovery facility, e.g. Kepler, TESS, JWST, HARPS.","title":"Facility"},"radius_min":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Min radius in Earth radii.","title":"Radius Min"},"radius_max":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Max radius in Earth radii.","title":"Radius Max"},"mass_max":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Max mass in Earth masses.","title":"Mass Max"},"period_max":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Max orbital period in days.","title":"Period Max"},"distance_max_ly":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Max distance from Earth in light-years.","title":"Distance Max Ly"},"temperate":{"default":false,"description":"Only rocky-ish planets (≤2.5 R⊕) with equilibrium temperature 180–310 K.","title":"Temperate","type":"boolean"},"sort":{"default":"nearest","description":"nearest | newest | smallest | largest | coolest | name","title":"Sort","type":"string"},"max_results":{"default":10,"maximum":50,"minimum":1,"title":"Max Results","type":"integer"}},"title":"exoplanet_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/exoplanet":{"post":{"operationId":"exoplanet","summary":"One exoplanet in full, plus the other planets of its system. Use for \"tell me about Proxima Centauri b\",","description":"One exoplanet in full, plus the other planets of its system. Use for \"tell me about Proxima Centauri b\",\n    \"how big is Kepler-452 b\", \"what's TRAPPIST-1 e like\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Planet name.","examples":["Proxima Cen b","Kepler-452 b","TRAPPIST-1 e"],"title":"Name","type":"string"}},"required":["name"],"title":"exoplanetArguments","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/exoplanet_stats":{"post":{"operationId":"exoplanet_stats","summary":"Counts of confirmed exoplanets by discovery year, method or facility, with the running total. Use for \"how many","description":"Counts of confirmed exoplanets by discovery year, method or facility, with the running total. Use for \"how many\n    exoplanets are known\", \"how many were discovered last year\", \"which telescope found the most\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"by":{"default":"year","description":"year | method | facility","title":"By","type":"string"},"max_results":{"default":20,"maximum":60,"minimum":1,"title":"Max Results","type":"integer"}},"title":"exoplanet_statsArguments","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/small_body":{"post":{"operationId":"small_body","summary":"One asteroid or comet from JPL's Small-Body Database: orbit class and elements, period, Earth MOID, NEO and","description":"One asteroid or comet from JPL's Small-Body Database: orbit class and elements, period, Earth MOID, NEO and\n    potentially-hazardous flags, size, albedo, rotation, spectral type, and its Earth close approaches (past and\n    future, with distance in lunar distances and km). Use for \"is Apophis dangerous\", \"how big is Bennu\", \"when\n    does Halley's comet return\", \"what is 2024 YR4\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Asteroid or comet name, number or designation.","examples":["Apophis","433","Bennu","1P/Halley","2024 YR4"],"title":"Name","type":"string"}},"required":["name"],"title":"small_bodyArguments","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/close_approaches":{"post":{"operationId":"close_approaches","summary":"Asteroid and comet close approaches to Earth (or another planet) in a date window: name, date/time, distance","description":"Asteroid and comet close approaches to Earth (or another planet) in a date window: name, date/time, distance\n    in lunar distances / km / AU, relative speed, absolute magnitude and diameter (measured or estimated range).\n    Use for \"asteroids passing closer than the Moon this month\", \"anything big coming close this year\",\n    \"close approaches to Mars in 2027\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"days":{"default":30,"description":"Window length from today (or from date_from).","maximum":365,"minimum":1,"title":"Days","type":"integer"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD (default today).","title":"Date From"},"max_distance_ld":{"default":10,"description":"Max approach distance in lunar distances (1 LD = 384,400 km).","exclusiveMinimum":0,"maximum":100,"title":"Max Distance Ld","type":"number"},"body":{"default":"Earth","description":"Earth | Moon | Mars | Venus | Mercury | Jupiter…","title":"Body","type":"string"},"hazardous_only":{"default":false,"description":"Only potentially hazardous asteroids.","title":"Hazardous Only","type":"boolean"},"min_size_h":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Only bodies brighter than this absolute magnitude H (smaller H = larger; 22 ≈ 140 m, 25 ≈ 40 m).","title":"Min Size H"},"max_results":{"default":20,"maximum":50,"minimum":1,"title":"Max Results","type":"integer"}},"title":"close_approachesArguments","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/sky_object":{"post":{"operationId":"sky_object","summary":"A star or deep-sky object from SIMBAD: object type, spectral type, coordinates (RA/Dec), parallax and distance","description":"A star or deep-sky object from SIMBAD: object type, spectral type, coordinates (RA/Dec), parallax and distance\n    in light-years, radial velocity or redshift, proper motion, V/B/J/K magnitudes, naked-eye visibility and\n    cross-identifiers. Use for \"how far is Betelgeuse\", \"what type of star is Vega\", \"where is M31 in the sky\",\n    \"what is NGC 7000\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Star, galaxy, nebula, cluster or catalogue id.","examples":["Betelgeuse","M31","NGC 7000","Sirius","Vega","HD 209458"],"title":"Name","type":"string"}},"required":["name"],"title":"sky_objectArguments","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/space_weather":{"post":{"operationId":"space_weather","summary":"Space weather right now from NOAA SWPC: NOAA scales (R radio blackout, S solar radiation, G geomagnetic) with","description":"Space weather right now from NOAA SWPC: NOAA scales (R radio blackout, S solar radiation, G geomagnetic) with\n    the 3-day scale outlook, recent Kp values and any storm level, real-time solar wind (speed, Bt, Bz), 10.7 cm\n    radio flux, and watches/warnings/alerts issued in the last 3 days. Use for \"is there a geomagnetic storm\",\n    \"aurora chances tonight\", \"any solar storm warnings\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"space_weatherArguments","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/space_weather_forecast":{"post":{"operationId":"space_weather_forecast","summary":"NOAA SWPC's 3-day forecast: Kp by 3-hour block for each day with storm levels, max Kp per day, radio blackout","description":"NOAA SWPC's 3-day forecast: Kp by 3-hour block for each day with storm levels, max Kp per day, radio blackout\n    and solar radiation storm probabilities, and the forecasters' text; optionally the 27-day outlook. Use for \"will\n    there be aurora this weekend\", \"geomagnetic forecast for the next 3 days\", \"quiet or active Sun next month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"outlook_27_day":{"default":false,"description":"Also include the 27-day outlook (daily F10.7, A index, largest Kp).","title":"Outlook 27 Day","type":"boolean"}},"title":"space_weather_forecastArguments","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/solar_activity":{"post":{"operationId":"solar_activity","summary":"The Sun's activity: solar flares in the last 7 days (count, strongest, latest, M/X count), monthly sunspot","description":"The Sun's activity: solar flares in the last 7 days (count, strongest, latest, M/X count), monthly sunspot\n    numbers for the past year with the Solar Cycle 25 peak so far, the 12-month prediction, and today's numbered\n    active regions with size and location. Use for \"any big flares this week\", \"where are we in the solar cycle\",\n    \"how many sunspots are there today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"solar_activityArguments","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/spaceflight_news":{"post":{"operationId":"spaceflight_news","summary":"Latest spaceflight news from 40+ outlets (Spaceflight News API): title, outlet, time, summary, link, image, and","description":"Latest spaceflight news from 40+ outlets (Spaceflight News API): title, outlet, time, summary, link, image, and\n    linked launches/events. Use for \"latest SpaceX news\", \"what's new with Artemis\", \"ESA news this week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Words to search titles/summaries.","examples":["Artemis","Starship","ISRO"],"title":"Search"},"site":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Outlet name, e.g. NASA, SpaceNews, Ars Technica, ESA, Spaceflight Now.","title":"Site"},"kind":{"default":"articles","description":"articles | blogs | reports","title":"Kind","type":"string"},"max_results":{"default":10,"maximum":30,"minimum":1,"title":"Max Results","type":"integer"}},"title":"spaceflight_newsArguments","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/astronaut":{"post":{"operationId":"astronaut","summary":"An astronaut's record from Launch Library 2: agency, nationality, status, dates, time in space and on EVA,","description":"An astronaut's record from Launch Library 2: agency, nationality, status, dates, time in space and on EVA,\n    number of flights with mission list, bio and links. Use for \"how long has Peggy Whitson spent in space\", \"which\n    missions did Sunita Williams fly\", \"who is Rakesh Sharma\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Astronaut name (or part).","examples":["Peggy Whitson","Sunita Williams","Rakesh Sharma"],"title":"Name","type":"string"}},"required":["name"],"title":"astronautArguments","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}}}}