Education
Data source: Curated dataset (Wikipedia, academic sources)
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/historical-events/
claude_desktop_config.json
{
"mcpServers": {
"gnist-historical-events": {
"url": "https://context.gnist.ai/mcp/historical-events/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/historical-events/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_historical_event", "arguments": {"event_id": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/historical-events/
6 endpoints available:
GET /rest/historical-events/get_historical_eventGET /rest/historical-events/search_historical_eventsGET /rest/historical-events/list_events_by_eraGET /rest/historical-events/list_events_by_categoryGET /rest/historical-events/list_events_by_year_rangeGET /rest/historical-events/report_feedback
Shell
curl "https://context.gnist.ai/rest/historical-events/get_historical_event?event_id=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/historical-events/get_historical_event",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"event_id": "example"
},
)
print(resp.json())
Command Line
Command
gc historical-events
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (6)
get_historical_eventGet a single historical event by its ID.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | required | Event slug ID (e.g. 'moon-landing-1969', 'magna-carta'). |
search_historical_eventsSearch historical events by keyword.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search keyword — matches event title and description. |
limit | any | optional | Maximum number of results (default: 20, max: 100). |
list_events_by_eraList historical events filtered by era.
| Parameter | Type | Required | Description |
|---|---|---|---|
era | string | required | Era name: Ancient, Medieval, Early Modern, Modern, or Contemporary. |
limit | any | optional | Maximum number of results (default: 50, max: 100). |
list_events_by_categoryList historical events filtered by category.
| Parameter | Type | Required | Description |
|---|---|---|---|
category | string | required | Category: War & Conflict, Science & Technology, Politics, Exploration, Culture, Economics, Religion, or Natural Disaster. |
limit | any | optional | Maximum number of results (default: 50, max: 100). |
list_events_by_year_rangeList historical events within a year range (inclusive).
| Parameter | Type | Required | Description |
|---|---|---|---|
start_year | integer | required | Start year (use negative values for BCE, e.g. -500). |
end_year | integer | required | End year (use negative values for BCE, e.g. -100). |
limit | any | optional | Maximum number of results (default: 50, max: 100). |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |