{"openapi":"3.1.0","info":{"title":"HistoryTimeline API","version":"0.1.0","description":"A hand-curated, genuinely global world-history reference: a date-range timeline query tool, an 'on this century' browsing tool, an era reference, and cause-and-effect notes for ten major turning points.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://historytimeline.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/historytimeline/docs"},"termsOfService":"https://connectorbay.com/historytimeline/terms"},"servers":[{"url":"https://historytimeline.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/historytimeline/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/era_reference":{"post":{"operationId":"era_reference","summary":"The six global historical eras (ancient, classical, medieval, early_modern, modern, contemporary)","description":"The six global historical eras (ancient, classical, medieval, early_modern, modern, contemporary)\n    with their year ranges and a global summary, or one era's detail and sample events. Use for \"give me an\n    overview of the medieval era\", \"what eras does this cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"era":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ancient | classical | medieval | early_modern | modern | contemporary. Omit to list all six.","title":"Era"}},"title":"era_referenceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/timeline_query":{"post":{"operationId":"timeline_query","summary":"Every event whose year falls within an inclusive date range, optionally filtered by region or tag.","description":"Every event whose year falls within an inclusive date range, optionally filtered by region or tag.\n    Use for \"list events between 1200 and 1500 CE in Asia\", \"what happened in Africa between 1000 and 1500\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_year":{"description":"Start of the date range, inclusive. Negative for BCE, e.g. -3100 for 3100 BCE.","title":"Start Year","type":"integer"},"end_year":{"description":"End of the date range, inclusive. Negative for BCE.","title":"End Year","type":"integer"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to one region, e.g. 'Africa', 'East Asia', 'Europe'.","title":"Region"},"tag":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to one tag, e.g. 'empire', 'religion', 'conflict', 'trade', 'technology'.","title":"Tag"}},"required":["start_year","end_year"],"title":"timeline_queryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/century_browser":{"post":{"operationId":"century_browser","summary":"An \"on this century\" browser: resolves a century number (and BCE/CE) to its year range and lists","description":"An \"on this century\" browser: resolves a century number (and BCE/CE) to its year range and lists\n    every event in it. Use for \"what happened in the 15th century\", \"show me the 5th century BCE\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"century":{"description":"The century number, e.g. 15 for the 15th century.","minimum":1,"title":"Century","type":"integer"},"bce":{"default":false,"description":"True for a BCE century (e.g. the 5th century BCE); false (default) for CE.","title":"Bce","type":"boolean"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to one region.","title":"Region"}},"required":["century"],"title":"century_browserArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/turning_point":{"post":{"operationId":"turning_point","summary":"Cause-and-effect notes for a major historical turning point, each with hand-curated causes, effects,","description":"Cause-and-effect notes for a major historical turning point, each with hand-curated causes, effects,\n    and a note on where historians' interpretations genuinely differ. Use for \"what caused the fall of the\n    Western Roman Empire\", \"what were the effects of the Columbian Exchange\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A turning point to look up, e.g. 'fall of Rome', 'Industrial Revolution'. Omit to list all ten.","title":"Query"}},"title":"turning_pointArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}