{"openapi":"3.1.0","info":{"title":"Chronicle API","version":"0.1.0","description":"On this day, today in history, anniversaries, a year's events, Wikipedia summaries and search, quote of the day.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://chronicle.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/chronicle/docs"},"termsOfService":"https://connectorbay.com/chronicle/terms"},"servers":[{"url":"https://chronicle.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/chronicle/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/on_this_day":{"post":{"operationId":"on_this_day","summary":"Notable events, births, deaths or holidays on a calendar date, from Wikipedia — each with year, text and","description":"Notable events, births, deaths or holidays on a calendar date, from Wikipedia — each with year, text and\n    linked articles; filter by year or range. Use for \"what happened on 15 August\", \"who was born on 2 October\",\n    \"events on 9 November in the 20th century\", \"holidays on 1 May\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"month":{"maximum":12,"minimum":1,"title":"Month","type":"integer"},"day":{"maximum":31,"minimum":1,"title":"Day","type":"integer"},"kind":{"default":"events","description":"events | births | deaths | holidays | selected (Wikipedia's picks)","title":"Kind","type":"string"},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Only this year (negative for BC).","title":"Year"},"year_from":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"From this year.","title":"Year From"},"year_to":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Up to this year.","title":"Year To"},"max_results":{"default":15,"maximum":60,"minimum":1,"title":"Max Results","type":"integer"}},"required":["month","day"],"title":"on_this_dayArguments","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/today_in_history":{"post":{"operationId":"today_in_history","summary":"Today's date in history: Wikipedia's selected events, round-number anniversaries (25/50/75/100… years ago","description":"Today's date in history: Wikipedia's selected events, round-number anniversaries (25/50/75/100… years ago\n    today), notable births and deaths, and holidays. Use for \"today in history\", \"anniversaries today\", \"any\n    famous birthdays today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"timezone_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IANA zone for the local date, e.g. Asia/Kolkata (default UTC).","title":"Timezone Name"},"max_results":{"default":10,"maximum":30,"minimum":1,"title":"Max Results","type":"integer"}},"title":"today_in_historyArguments","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/years_ago":{"post":{"operationId":"years_ago","summary":"What happened exactly N years ago on a date (default today): events, births and deaths from that year. Use","description":"What happened exactly N years ago on a date (default today): events, births and deaths from that year. Use\n    for \"what happened 50 years ago today\", \"100 years ago on 4 July\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"years":{"description":"How many years back.","examples":[50,100],"maximum":3000,"minimum":1,"title":"Years","type":"integer"},"month":{"anyOf":[{"maximum":12,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"title":"Month"},"day":{"anyOf":[{"maximum":31,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"title":"Day"},"timezone_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IANA zone for 'today' (default UTC).","title":"Timezone Name"}},"required":["years"],"title":"years_agoArguments","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/year_events":{"post":{"operationId":"year_events","summary":"The events of a year, month by month, from the Wikipedia year page — dated bullet points with the people and","description":"The events of a year, month by month, from the Wikipedia year page — dated bullet points with the people and\n    places involved. Use for \"what happened in 1969\", \"events of March 1947\", \"the year 1066\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"year":{"description":"Year (negative for BC).","examples":[1969,1947],"maximum":2100,"minimum":-3000,"title":"Year","type":"integer"},"month":{"anyOf":[{"maximum":12,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Restrict to a month.","title":"Month"},"max_results":{"default":40,"maximum":120,"minimum":1,"title":"Max Results","type":"integer"}},"required":["year"],"title":"year_eventsArguments","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/wiki_summary":{"post":{"operationId":"wiki_summary","summary":"A Wikipedia summary: the lead paragraph, short description, image, link — plus birth/death years for people","description":"A Wikipedia summary: the lead paragraph, short description, image, link — plus birth/death years for people\n    and coordinates for places. Falls back to search when the exact title is not found. Use for \"who was Ada\n    Lovelace\", \"what is the French Revolution\", \"tell me about Hampi\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"description":"Article title or a person, place, event or thing.","examples":["Ada Lovelace","French Revolution","Photosynthesis"],"title":"Topic","type":"string"}},"required":["topic"],"title":"wiki_summaryArguments","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/wiki_search":{"post":{"operationId":"wiki_search","summary":"Search Wikipedia article titles and text: title, snippet, article size and link. Use to find the right","description":"Search Wikipedia article titles and text: title, snippet, article size and link. Use to find the right\n    article before wiki_summary, or for \"Wikipedia articles about X\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Search words.","examples":["Apollo 11 landing","Chola dynasty temples"],"title":"Query","type":"string"},"max_results":{"default":6,"maximum":15,"minimum":1,"title":"Max Results","type":"integer"}},"required":["query"],"title":"wiki_searchArguments","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/quote":{"post":{"operationId":"quote","summary":"Quote of the day, or a random quotation, with its author (ZenQuotes). Use for \"quote of the day\", \"give me an","description":"Quote of the day, or a random quotation, with its author (ZenQuotes). Use for \"quote of the day\", \"give me an\n    inspiring quote\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"kind":{"default":"today","description":"today | random","title":"Kind","type":"string"}},"title":"quoteArguments","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}}}}