{"openapi":"3.0.3","info":{"title":"Gnist Context — NASA","description":"NASA open APIs — Astronomy Picture of the Day, Near Earth Objects, Mars Rover Photos, EPIC Earth imagery, and DONKI space weather events.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/nasa/`\n- **Toolkit page:** `/toolkits/nasa`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/nasa/search_apod":{"post":{"tags":["Science"],"summary":"search_apod","description":"Get NASA's Astronomy Picture of the Day with scientific explanations.\n\nReturns high-quality astronomy images or videos with detailed explanations\nfrom professional astronomers. Data goes back to June 1995.\n\nExamples:\n    search_apod() -> today's picture\n    search_apod(date=\"2024-01-01\") -> specific date\n    search_apod(start_date=\"2024-01-01\", end_date=\"2024-01-07\") -> date range\n    search_apod(count=5) -> 5 random pictures","operationId":"nasa_search_apod","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Specific date (YYYY-MM-DD). Omit for today's picture."},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start date for a date range (YYYY-MM-DD)."},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End date for a date range (YYYY-MM-DD)."},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Return N random APOD entries (1-100). Cannot combine with date/start_date."}},"type":"object"}}}}}},"/rest/nasa/search_neo":{"post":{"tags":["Science"],"summary":"search_neo","description":"Search Near Earth Objects (asteroids and comets) by date range.\n\nReturns orbital data, size estimates, close approach distances, velocities,\nand whether each object is classified as potentially hazardous.\n\nMaximum 7-day range per query. Use for asteroid tracking, impact risk\nassessment, and space situational awareness.\n\nExamples:\n    search_neo(\"2024-01-01\", \"2024-01-07\") -> week of NEO data","operationId":"nasa_search_neo","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"start_date":{"description":"Start date (YYYY-MM-DD).","type":"string"},"end_date":{"description":"End date (YYYY-MM-DD), max 7 days from start.","type":"string"}},"required":["start_date","end_date"],"type":"object"}}}}}},"/rest/nasa/search_mars_photos":{"post":{"tags":["Science"],"summary":"search_mars_photos","description":"Search Mars Rover photos from Curiosity, Opportunity, Spirit, and Perseverance.\n\nEach rover has different cameras. Common cameras:\n- FHAZ/RHAZ: Front/Rear Hazard Avoidance (all rovers)\n- NAVCAM: Navigation Camera (all rovers)\n- MAST: Mast Camera (Curiosity)\n- PANCAM: Panoramic Camera (Opportunity, Spirit)\n\nExamples:\n    search_mars_photos(\"curiosity\", sol=1000) -> Curiosity photos from sol 1000\n    search_mars_photos(\"perseverance\", earth_date=\"2024-01-15\", camera=\"NAVCAM\")","operationId":"nasa_search_mars_photos","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"rover":{"description":"Rover name: curiosity, opportunity, spirit, or perseverance.","type":"string"},"sol":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Martian sol (day) number. Default 1000 if neither sol nor earth_date given."},"earth_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Earth date (YYYY-MM-DD). Alternative to sol."},"camera":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Camera abbreviation: FHAZ, RHAZ, MAST, CHEMCAM, MAHLI, NAVCAM, PANCAM, etc."},"page":{"default":1,"description":"Page number (25 results per page). Default 1.","type":"integer"}},"required":["rover"],"type":"object"}}}}}},"/rest/nasa/get_epic_imagery":{"post":{"tags":["Science"],"summary":"get_epic_imagery","description":"Get NASA EPIC full-disc Earth photographs from DSCOVR satellite at L1 point.\n\nReturns metadata and image URLs for full-color photographs of the\nsunlit side of Earth, taken from 1 million miles away. Available in\nnatural color and contrast-enhanced versions.\n\nExamples:\n    get_epic_imagery() -> most recent natural color images\n    get_epic_imagery(collection=\"enhanced\") -> enhanced images\n    get_epic_imagery(date=\"2024-01-15\") -> specific date","operationId":"nasa_get_epic_imagery","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"collection":{"default":"natural","description":"Image collection: 'natural' (color) or 'enhanced' (contrast-enhanced).","type":"string"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date (YYYY-MM-DD). Omit for most recent images."}},"type":"object"}}}}}},"/rest/nasa/search_space_weather":{"post":{"tags":["Science"],"summary":"search_space_weather","description":"Search NASA DONKI space weather events.\n\nThe Space Weather Database Of Notifications, Knowledge, Information\n(DONKI) tracks solar and geomagnetic events that affect Earth.\n\nEvent types:\n- CME: Coronal Mass Ejections — solar plasma eruptions\n- GST: Geomagnetic Storms — disturbances in Earth's magnetosphere\n- FLR: Solar Flares — electromagnetic radiation bursts\n- IPS: Interplanetary Shocks — shock waves in solar wind\n- SEP: Solar Energetic Particles — high-energy particle events\n- MPC: Magnetopause Crossings\n- RBE: Radiation Belt Enhancements\n- HSS: High Speed Streams — fast solar wind streams\n\nExamples:\n    search_space_weather(\"CME\", \"2024-01-01\", \"2024-01-31\")\n    search_space_weather(\"FLR\", \"2024-03-01\", \"2024-03-15\")","operationId":"nasa_search_space_weather","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"event_type":{"description":"Event type: CME (Coronal Mass Ejection), GST (Geomagnetic Storm), FLR (Solar Flare), IPS (Interplanetary Shock), SEP (Solar Energetic Particle), MPC (Magnetopause Crossing), RBE (Radiation Belt Enhancement), HSS (High Speed Stream).","type":"string"},"start_date":{"description":"Start date (YYYY-MM-DD).","type":"string"},"end_date":{"description":"End date (YYYY-MM-DD).","type":"string"}},"required":["event_type","start_date","end_date"],"type":"object"}}}}}},"/rest/nasa/report_feedback":{"post":{"tags":["Science"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"nasa_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Science","description":"Data sources: Science"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}