{"openapi":"3.0.3","info":{"title":"Gnist Context — Historical Figures","description":"Curated database of notable historical figures — leaders, scientists, artists, philosophers, and explorers.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/historical-figures/`\n- **Toolkit page:** `/toolkits/historical-figures`\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-figures/get_historical_figure":{"post":{"tags":["Education"],"summary":"get_historical_figure","description":"Get detailed information about a historical figure by ID.\n\nReturns biographical data including birth/death years, nationality, field, era, and description.","operationId":"historical_figures_get_historical_figure","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":{"figure_id":{"description":"Slug ID of the historical figure (e.g. 'julius-caesar', 'albert-einstein').","type":"string"}},"required":["figure_id"],"type":"object"}}}}}},"/rest/historical-figures/search_historical_figures":{"post":{"tags":["Education"],"summary":"search_historical_figures","description":"Search historical figures by keyword.\n\nSearches across names, achievements, and descriptions. Case-insensitive.","operationId":"historical_figures_search_historical_figures","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 name, known_for, or 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-figures/list_figures_by_field":{"post":{"tags":["Education"],"summary":"list_figures_by_field","description":"List historical figures by their field of achievement.\n\nValid fields include: Politics & Leadership, Science & Mathematics, Arts & Literature,\nPhilosophy, Military, Exploration, Religion, Activism, Business & Economics.","operationId":"historical_figures_list_figures_by_field","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":{"field":{"description":"Field of achievement (e.g. 'Science & Mathematics', 'Arts & Literature', 'Philosophy').","type":"string"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of results (default: 50, max: 100)."}},"required":["field"],"type":"object"}}}}}},"/rest/historical-figures/list_figures_by_era":{"post":{"tags":["Education"],"summary":"list_figures_by_era","description":"List historical figures by historical era.\n\nValid eras: Ancient, Medieval, Renaissance, Early Modern, Modern, Contemporary.","operationId":"historical_figures_list_figures_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":"Historical era (e.g. 'Ancient', 'Medieval', 'Renaissance', 'Modern', '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-figures/list_figures_by_nationality":{"post":{"tags":["Education"],"summary":"list_figures_by_nationality","description":"List historical figures by nationality.\n\nPartial matching — e.g. 'american' matches 'American', 'Serbian-American', etc.","operationId":"historical_figures_list_figures_by_nationality","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":{"nationality":{"description":"Nationality to filter by (case-insensitive, partial match).","type":"string"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of results (default: 50, max: 100)."}},"required":["nationality"],"type":"object"}}}}}},"/rest/historical-figures/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_figures_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."}}}}