Tools (6)

get_historical_event
search_historical_events
list_events_by_era
list_events_by_category
list_events_by_year_range
report_feedback

get_historical_event

Get a single historical event by its ID.

Returns detailed information including title, date, era, category, region,
description, and significance.

Parameter	Type	Required	Description
`event_id`	`string`	required	Event slug ID (e.g. 'moon-landing-1969', 'magna-carta').

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_historical_event",
    "arguments": {
      "event_id": "example"
    }
  }
}

search_historical_events

Search historical events by keyword.

Searches across event titles and descriptions. Case-insensitive. Results are
sorted chronologically.

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).

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "search_historical_events",
    "arguments": {
      "query": "example"
    }
  }
}

list_events_by_era

List historical events filtered by era.

Valid eras: Ancient, Medieval, Early Modern, Modern, Contemporary.
Results are sorted chronologically.

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).

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "list_events_by_era",
    "arguments": {
      "era": "example"
    }
  }
}

list_events_by_category

List historical events filtered by category.

Valid categories: War & Conflict, Science & Technology, Politics, Exploration,
Culture, Economics, Religion, Natural Disaster. Results sorted chronologically.

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).

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "list_events_by_category",
    "arguments": {
      "category": "example"
    }
  }
}

list_events_by_year_range

List historical events within a year range (inclusive).

Use negative years for BCE dates. Results sorted chronologically.

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).

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "list_events_by_year_range",
    "arguments": {
      "start_year": 1,
      "end_year": 1
    }
  }
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "report_feedback",
    "arguments": {
      "feedback": "example"
    }
  }
}

Quick Start

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"}}}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/historical-events/",
    headers={"Gnist-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_historical_event",
    "arguments": {
      "event_id": "example"
    }
  }
},
)
print(resp.json())