{"openapi":"3.0.3","info":{"title":"Gnist Context — Historical Events","description":"Curated database of major historical events — wars, discoveries, revolutions, and milestones across all eras.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/historical-events/`\n- **Toolkit page:** `/toolkits/historical-events`\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/historical-events/get_historical_event":{"post":{"tags":["Education"],"summary":"get_historical_event","description":"Get a single historical event by its ID.\n\nReturns detailed information including title, date, era, category, region,\ndescription, and significance.","operationId":"historical_events_get_historical_event","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_id":{"description":"Event slug ID (e.g. 'moon-landing-1969', 'magna-carta').","type":"string"}},"required":["event_id"],"type":"object"}}}}}},"/rest/historical-events/search_historical_events":{"post":{"tags":["Education"],"summary":"search_historical_events","description":"Search historical events by keyword.\n\nSearches across event titles and descriptions. Case-insensitive. Results are\nsorted chronologically.","operationId":"historical_events_search_historical_events","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":{"query":{"description":"Search keyword — matches event title and description.","type":"string"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of results (default: 20, max: 100)."}},"required":["query"],"type":"object"}}}}}},"/rest/historical-events/list_events_by_era":{"post":{"tags":["Education"],"summary":"list_events_by_era","description":"List historical events filtered by era.\n\nValid eras: Ancient, Medieval, Early Modern, Modern, Contemporary.\nResults are sorted chronologically.","operationId":"historical_events_list_events_by_era","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":{"era":{"description":"Era name: Ancient, Medieval, Early Modern, Modern, or Contemporary.","type":"string"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of results (default: 50, max: 100)."}},"required":["era"],"type":"object"}}}}}},"/rest/historical-events/list_events_by_category":{"post":{"tags":["Education"],"summary":"list_events_by_category","description":"List historical events filtered by category.\n\nValid categories: War & Conflict, Science & Technology, Politics, Exploration,\nCulture, Economics, Religion, Natural Disaster. Results sorted chronologically.","operationId":"historical_events_list_events_by_category","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":{"category":{"description":"Category: War & Conflict, Science & Technology, Politics, Exploration, Culture, Economics, Religion, or Natural Disaster.","type":"string"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of results (default: 50, max: 100)."}},"required":["category"],"type":"object"}}}}}},"/rest/historical-events/list_events_by_year_range":{"post":{"tags":["Education"],"summary":"list_events_by_year_range","description":"List historical events within a year range (inclusive).\n\nUse negative years for BCE dates. Results sorted chronologically.","operationId":"historical_events_list_events_by_year_range","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_year":{"description":"Start year (use negative values for BCE, e.g. -500).","type":"integer"},"end_year":{"description":"End year (use negative values for BCE, e.g. -100).","type":"integer"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of results (default: 50, max: 100)."}},"required":["start_year","end_year"],"type":"object"}}}}}},"/rest/historical-events/report_feedback":{"post":{"tags":["Education"],"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":"historical_events_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":"Education","description":"Data sources: Education"}],"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."}}}}