{"contract":"knowledge/1.2.0","packet_schema":"4ort.packet/1","tools":[{"name":"get_entity_packet","title":"Get evidence packets","description":"Facts about one or more known things (people, companies, places, works, products) with per-fact citation: source dataset, source record URL, edition, licence and required credit line, qualifiers (start/end dates, roles), a reference-support band, and explicit unknowns. Use it for any factual question about a named entity ('when was X born', 'who is the CEO of Y', 'population of Z'), including several entities at once to compare them. Accepts names, so you do not need resolve_entity first. Pass `fields` to get only the properties you need.","inputSchema":{"additionalProperties":false,"properties":{"entities":{"description":"1 to 10 entities: an entity_id (slug), a Wikidata Q-id, a 4ort UUID, or a plain name (resolved to the best match; the resolution is reported)","items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Entities","type":"array"},"fields":{"anyOf":[{"items":{"type":"string"},"maxItems":30,"type":"array"},{"type":"null"}],"default":null,"description":"Only these properties: P-codes ('P569') or English property labels ('date of birth', 'population'). Omit for the entity's main facts. A field we do not hold comes back in unknowns with its reason","title":"Fields"},"max_facts":{"default":30,"description":"Upper bound on facts per entity (size bound)","maximum":120,"minimum":1,"title":"Max Facts","type":"integer"}},"required":["entities"],"type":"object"},"outputSchema":{"$defs":{"AsOf":{"properties":{"copy_written_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When our stored row was last written for ANY reason (UTC ISO). Not a statement refresh: use claims_refreshed_at for that","title":"Copy Written At"},"last_source_edit_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Latest Wikidata edit to this item our edit stream recorded (UTC ISO)","title":"Last Source Edit Seen"},"stale_possible":{"default":false,"description":"Wikidata items: true unless our statements were checked against Wikidata (claims_refreshed_at) after the latest edit we saw. Other sources: true when the source recorded an edit after our copy was written","title":"Stale Possible","type":"boolean"},"claims_refreshed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When we last checked this item's statements against Wikidata and matched its revision (UTC ISO); null = not checked since 2026-10-25, when tracking began","title":"Claims Refreshed At"},"source_revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"The Wikidata revision id our statements matched at claims_refreshed_at","title":"Source Revision"}},"title":"AsOf","type":"object"},"Citation":{"description":"Where one fact comes from and what you may do with it.","properties":{"source":{"description":"Source-registry key, e.g. 'wikidata', 'geonames' (see get_source_info)","title":"Source","type":"string"},"source_name":{"description":"Human name of the source dataset","title":"Source Name","type":"string"},"source_record":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"URL of the record inside the source that states this fact","title":"Source Record"},"source_edition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Edition of that record we serve (ISO time or the dataset's edition label)","title":"Source Edition"},"edition_basis":{"description":"claims_refreshed_at: when we last checked this item's statements against the source and matched its revision (the value was current then); lake_edition: the dataset release we loaded; derived_at: when 4ort derived the claim; copy_written_at: when our row was last written, which is NOT a statement refresh (kept for older clients); unknown: not recorded","enum":["claims_refreshed_at","copy_written_at","lake_edition","derived_at","unknown"],"title":"Edition Basis","type":"string"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Licence of the source dataset; null = unknown, never assumed","title":"Licence"},"licence_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Licence Url"},"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Credit line the licence requires when you reuse the fact; null = none required","title":"Attribution"},"references":{"description":"The source's own references for this statement (at most 2)","items":{"$ref":"#/$defs/Reference"},"title":"References","type":"array"}},"required":["source","source_name","edition_basis"],"title":"Citation","type":"object"},"EvidencePacket":{"description":"One entity's facts with per-field provenance.","properties":{"schema_version":{"const":"4ort.packet/1","default":"4ort.packet/1","title":"Schema Version","type":"string"},"entity":{"$ref":"#/$defs/PacketEntity"},"status":{"description":"complete: every selected fact is here; truncated: see omitted","enum":["complete","truncated"],"title":"Status","type":"string"},"as_of":{"$ref":"#/$defs/AsOf"},"facts":{"items":{"$ref":"#/$defs/Fact"},"title":"Facts","type":"array"},"unknowns":{"items":{"$ref":"#/$defs/Unknown"},"title":"Unknowns","type":"array"},"omitted":{"$ref":"#/$defs/Omitted"},"licences":{"items":{"$ref":"#/$defs/PacketLicence"},"title":"Licences","type":"array"},"routes":{"$ref":"#/$defs/PacketRoutes"},"trust_rules":{"additionalProperties":{"type":"string"},"description":"Text of every trust rule id used by facts[].trust.basis","title":"Trust Rules","type":"object"},"notes":{"items":{"type":"string"},"title":"Notes","type":"array"}},"required":["entity","status","as_of","facts","routes"],"title":"EvidencePacket","type":"object"},"Fact":{"properties":{"field":{"description":"Property P-code, e.g. 'P569'","title":"Field","type":"string"},"label":{"description":"Property label, e.g. 'date of birth'","title":"Label","type":"string"},"value":{"description":"Display value (Q-ids resolved to labels, dates to their precision)","title":"Value","type":"string"},"value_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Wikidata Q-id when the value is an item","title":"Value Id"},"value_raw":{"default":null,"description":"The value exactly as the source stores it","title":"Value Raw"},"rank":{"default":"normal","enum":["preferred","normal","deprecated"],"title":"Rank","type":"string"},"current":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"False when an end time qualifier (P582) is set; null when the source gives no period","title":"Current"},"qualifiers":{"items":{"$ref":"#/$defs/Qualifier"},"title":"Qualifiers","type":"array"},"layer":{"default":"source","description":"source: stated by the cited dataset; derived: a claim 4ort derived from cited evidence","enum":["source","derived"],"title":"Layer","type":"string"},"citation":{"$ref":"#/$defs/Citation"},"trust":{"$ref":"#/$defs/Trust"}},"required":["field","label","value","citation","trust"],"title":"Fact","type":"object"},"Omitted":{"properties":{"facts":{"default":0,"description":"Facts left out by max_facts or the size bound","title":"Facts","type":"integer"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"Omitted","type":"object"},"PacketEntity":{"properties":{"entity_id":{"description":"Stable 4ort id to pass to other tools (slug, else UUID)","title":"Entity Id","type":"string"},"kg_uuid":{"title":"Kg Uuid","type":"string"},"wikidata_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Wikidata Id"},"name":{"title":"Name","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"4ort entity page","title":"Url"}},"required":["entity_id","kg_uuid","name"],"title":"PacketEntity","type":"object"},"PacketLicence":{"properties":{"source":{"title":"Source","type":"string"},"source_name":{"title":"Source Name","type":"string"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Licence"},"licence_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Licence Url"},"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Required credit line; null = none","title":"Attribution"},"fields":{"description":"P-codes in this packet that this licence covers","items":{"type":"string"},"title":"Fields","type":"array"}},"required":["source","source_name","licence","licence_url","fields"],"title":"PacketLicence","type":"object"},"PacketRoutes":{"description":"Where to go next. A route is a destination, not evidence.","properties":{"entity_page":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Entity Page"},"packet_api":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"This packet over REST (ETag; If-None-Match gives a free 304)","title":"Packet Api"},"facts_jsonld":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Facts Jsonld"},"changes_api":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Changes Api"},"attention_api":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Attention Api"},"wikidata":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Wikidata"},"official_website":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Official Website"}},"title":"PacketRoutes","type":"object"},"Qualifier":{"properties":{"field":{"description":"Qualifier property P-code, e.g. P580 (start time)","title":"Field","type":"string"},"label":{"title":"Label","type":"string"},"value":{"description":"Display value","title":"Value","type":"string"}},"required":["field","label","value"],"title":"Qualifier","type":"object"},"Reference":{"description":"One of the source's own references for a statement (Wikidata reference block).\nFields the source does not give are left out of the JSON (all are optional).","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Reference URL (P854), when the source gives one","title":"Url"},"stated_in":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Work the source cites (P248), as a label","title":"Stated In"},"stated_in_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Wikidata Q-id of that work","title":"Stated In Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Title of the cited work (P1476)","title":"Title"},"retrieved":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When the source retrieved it (P813), YYYY-MM-DD","title":"Retrieved"},"imported_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Wikimedia project the statement was imported from (P143); not an independent source","title":"Imported From"}},"title":"Reference","type":"object"},"Resolution":{"properties":{"input":{"description":"What you passed","title":"Input","type":"string"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"What it resolved to","title":"Entity Id"},"method":{"description":"id: matched a slug/Q-id/UUID; name: resolved a name","enum":["id","name"],"title":"Method","type":"string"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Confidence"},"alternatives":{"description":"Other entity_ids the name could mean","items":{"type":"string"},"title":"Alternatives","type":"array"}},"required":["input","method"],"title":"Resolution","type":"object"},"Trust":{"properties":{"band":{"description":"high / medium / low reference support, or unscored","enum":["high","medium","low","unscored"],"title":"Band","type":"string"},"basis":{"description":"Id of the rule that produced the band; its text is in the packet's trust_rules","title":"Basis","type":"string"},"calibrated":{"default":false,"description":"True only for a measured probability. Always false today","title":"Calibrated","type":"boolean"}},"required":["band","basis"],"title":"Trust","type":"object"},"Unknown":{"properties":{"field":{"description":"The P-code or the field name you asked for","title":"Field","type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Label"},"status":{"description":"not_in_our_sources: we hold no statement (absence is not evidence of no value); no_value: the source states there is none; unknown_value: the source states a value exists but is unknown; only_deprecated: the source holds values but marks every one deprecated; unknown_field: we could not map your field name to a property","enum":["not_in_our_sources","no_value","unknown_value","only_deprecated","unknown_field"],"title":"Status","type":"string"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note"}},"required":["field","status"],"title":"Unknown","type":"object"}},"properties":{"contract":{"default":"knowledge/1.2.0","title":"Contract","type":"string"},"packets":{"items":{"$ref":"#/$defs/EvidencePacket"},"title":"Packets","type":"array"},"resolutions":{"items":{"$ref":"#/$defs/Resolution"},"title":"Resolutions","type":"array"},"not_found":{"description":"Inputs that matched no served entity","items":{"type":"string"},"title":"Not Found","type":"array"}},"required":["packets","resolutions"],"type":"object"},"annotations":{"title":"Get evidence packets","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest":{"method":"GET","path":"/api/v1/knowledge/get_entity_packet"},"keyed":false,"examples":[{"entities":["Douglas Adams"],"fields":["date of birth"]},{"entities":["Q312","Q2283"],"fields":["P169","P1128"]}]},{"name":"search_knowledge","title":"Search the knowledge graph and index","description":"Open-ended question or topic search. Returns the evidence packet of the entity the query is about (when there is one), web pages from the 4ort index, and the top destinations to fetch next. Use it when the question is not about one named entity you can pass to get_entity_packet, or when you also want pages. status 'no_coverage' means use another provider.","inputSchema":{"additionalProperties":false,"properties":{"query":{"description":"A question or topic in natural language, e.g. 'who founded Anthropic'","maxLength":200,"minLength":1,"title":"Query","type":"string"},"limit_pages":{"default":5,"description":"Web pages from the 4ort index to include","maximum":15,"minimum":0,"title":"Limit Pages","type":"integer"}},"required":["query"],"type":"object"},"outputSchema":{"$defs":{"AsOf":{"properties":{"copy_written_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When our stored row was last written for ANY reason (UTC ISO). Not a statement refresh: use claims_refreshed_at for that","title":"Copy Written At"},"last_source_edit_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Latest Wikidata edit to this item our edit stream recorded (UTC ISO)","title":"Last Source Edit Seen"},"stale_possible":{"default":false,"description":"Wikidata items: true unless our statements were checked against Wikidata (claims_refreshed_at) after the latest edit we saw. Other sources: true when the source recorded an edit after our copy was written","title":"Stale Possible","type":"boolean"},"claims_refreshed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When we last checked this item's statements against Wikidata and matched its revision (UTC ISO); null = not checked since 2026-10-25, when tracking began","title":"Claims Refreshed At"},"source_revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"The Wikidata revision id our statements matched at claims_refreshed_at","title":"Source Revision"}},"title":"AsOf","type":"object"},"Citation":{"description":"Where one fact comes from and what you may do with it.","properties":{"source":{"description":"Source-registry key, e.g. 'wikidata', 'geonames' (see get_source_info)","title":"Source","type":"string"},"source_name":{"description":"Human name of the source dataset","title":"Source Name","type":"string"},"source_record":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"URL of the record inside the source that states this fact","title":"Source Record"},"source_edition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Edition of that record we serve (ISO time or the dataset's edition label)","title":"Source Edition"},"edition_basis":{"description":"claims_refreshed_at: when we last checked this item's statements against the source and matched its revision (the value was current then); lake_edition: the dataset release we loaded; derived_at: when 4ort derived the claim; copy_written_at: when our row was last written, which is NOT a statement refresh (kept for older clients); unknown: not recorded","enum":["claims_refreshed_at","copy_written_at","lake_edition","derived_at","unknown"],"title":"Edition Basis","type":"string"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Licence of the source dataset; null = unknown, never assumed","title":"Licence"},"licence_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Licence Url"},"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Credit line the licence requires when you reuse the fact; null = none required","title":"Attribution"},"references":{"description":"The source's own references for this statement (at most 2)","items":{"$ref":"#/$defs/Reference"},"title":"References","type":"array"}},"required":["source","source_name","edition_basis"],"title":"Citation","type":"object"},"EvidencePacket":{"description":"One entity's facts with per-field provenance.","properties":{"schema_version":{"const":"4ort.packet/1","default":"4ort.packet/1","title":"Schema Version","type":"string"},"entity":{"$ref":"#/$defs/PacketEntity"},"status":{"description":"complete: every selected fact is here; truncated: see omitted","enum":["complete","truncated"],"title":"Status","type":"string"},"as_of":{"$ref":"#/$defs/AsOf"},"facts":{"items":{"$ref":"#/$defs/Fact"},"title":"Facts","type":"array"},"unknowns":{"items":{"$ref":"#/$defs/Unknown"},"title":"Unknowns","type":"array"},"omitted":{"$ref":"#/$defs/Omitted"},"licences":{"items":{"$ref":"#/$defs/PacketLicence"},"title":"Licences","type":"array"},"routes":{"$ref":"#/$defs/PacketRoutes"},"trust_rules":{"additionalProperties":{"type":"string"},"description":"Text of every trust rule id used by facts[].trust.basis","title":"Trust Rules","type":"object"},"notes":{"items":{"type":"string"},"title":"Notes","type":"array"}},"required":["entity","status","as_of","facts","routes"],"title":"EvidencePacket","type":"object"},"Fact":{"properties":{"field":{"description":"Property P-code, e.g. 'P569'","title":"Field","type":"string"},"label":{"description":"Property label, e.g. 'date of birth'","title":"Label","type":"string"},"value":{"description":"Display value (Q-ids resolved to labels, dates to their precision)","title":"Value","type":"string"},"value_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Wikidata Q-id when the value is an item","title":"Value Id"},"value_raw":{"default":null,"description":"The value exactly as the source stores it","title":"Value Raw"},"rank":{"default":"normal","enum":["preferred","normal","deprecated"],"title":"Rank","type":"string"},"current":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"False when an end time qualifier (P582) is set; null when the source gives no period","title":"Current"},"qualifiers":{"items":{"$ref":"#/$defs/Qualifier"},"title":"Qualifiers","type":"array"},"layer":{"default":"source","description":"source: stated by the cited dataset; derived: a claim 4ort derived from cited evidence","enum":["source","derived"],"title":"Layer","type":"string"},"citation":{"$ref":"#/$defs/Citation"},"trust":{"$ref":"#/$defs/Trust"}},"required":["field","label","value","citation","trust"],"title":"Fact","type":"object"},"Omitted":{"properties":{"facts":{"default":0,"description":"Facts left out by max_facts or the size bound","title":"Facts","type":"integer"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"Omitted","type":"object"},"PacketEntity":{"properties":{"entity_id":{"description":"Stable 4ort id to pass to other tools (slug, else UUID)","title":"Entity Id","type":"string"},"kg_uuid":{"title":"Kg Uuid","type":"string"},"wikidata_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Wikidata Id"},"name":{"title":"Name","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"4ort entity page","title":"Url"}},"required":["entity_id","kg_uuid","name"],"title":"PacketEntity","type":"object"},"PacketLicence":{"properties":{"source":{"title":"Source","type":"string"},"source_name":{"title":"Source Name","type":"string"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Licence"},"licence_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Licence Url"},"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Required credit line; null = none","title":"Attribution"},"fields":{"description":"P-codes in this packet that this licence covers","items":{"type":"string"},"title":"Fields","type":"array"}},"required":["source","source_name","licence","licence_url","fields"],"title":"PacketLicence","type":"object"},"PacketRoutes":{"description":"Where to go next. A route is a destination, not evidence.","properties":{"entity_page":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Entity Page"},"packet_api":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"This packet over REST (ETag; If-None-Match gives a free 304)","title":"Packet Api"},"facts_jsonld":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Facts Jsonld"},"changes_api":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Changes Api"},"attention_api":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Attention Api"},"wikidata":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Wikidata"},"official_website":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Official Website"}},"title":"PacketRoutes","type":"object"},"Page":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"url":{"title":"Url","type":"string"},"host":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Host"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Snippet"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"As Of"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Page rights; third-party pages are the publisher's, not 4ort's","title":"Licence"}},"required":["url"],"title":"Page","type":"object"},"Qualifier":{"properties":{"field":{"description":"Qualifier property P-code, e.g. P580 (start time)","title":"Field","type":"string"},"label":{"title":"Label","type":"string"},"value":{"description":"Display value","title":"Value","type":"string"}},"required":["field","label","value"],"title":"Qualifier","type":"object"},"Reference":{"description":"One of the source's own references for a statement (Wikidata reference block).\nFields the source does not give are left out of the JSON (all are optional).","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Reference URL (P854), when the source gives one","title":"Url"},"stated_in":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Work the source cites (P248), as a label","title":"Stated In"},"stated_in_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Wikidata Q-id of that work","title":"Stated In Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Title of the cited work (P1476)","title":"Title"},"retrieved":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When the source retrieved it (P813), YYYY-MM-DD","title":"Retrieved"},"imported_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Wikimedia project the statement was imported from (P143); not an independent source","title":"Imported From"}},"title":"Reference","type":"object"},"RouteOut":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"url":{"title":"Url","type":"string"},"host":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Host"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"query (a search URL on that site), page, api or route","title":"Kind"},"match":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why this destination was chosen","title":"Match"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Licence"},"as_of_basis":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"As Of Basis"}},"required":["url"],"title":"RouteOut","type":"object"},"Trust":{"properties":{"band":{"description":"high / medium / low reference support, or unscored","enum":["high","medium","low","unscored"],"title":"Band","type":"string"},"basis":{"description":"Id of the rule that produced the band; its text is in the packet's trust_rules","title":"Basis","type":"string"},"calibrated":{"default":false,"description":"True only for a measured probability. Always false today","title":"Calibrated","type":"boolean"}},"required":["band","basis"],"title":"Trust","type":"object"},"Unknown":{"properties":{"field":{"description":"The P-code or the field name you asked for","title":"Field","type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Label"},"status":{"description":"not_in_our_sources: we hold no statement (absence is not evidence of no value); no_value: the source states there is none; unknown_value: the source states a value exists but is unknown; only_deprecated: the source holds values but marks every one deprecated; unknown_field: we could not map your field name to a property","enum":["not_in_our_sources","no_value","unknown_value","only_deprecated","unknown_field"],"title":"Status","type":"string"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note"}},"required":["field","status"],"title":"Unknown","type":"object"}},"properties":{"contract":{"default":"knowledge/1.2.0","title":"Contract","type":"string"},"query":{"title":"Query","type":"string"},"status":{"description":"answered_from_kg: an entity packet is included; pages_only: no entity matched, pages did; no_coverage: nothing in the 4ort index - fall back to another provider","enum":["answered_from_kg","pages_only","no_coverage"],"title":"Status","type":"string"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Intent"},"entity":{"anyOf":[{"$ref":"#/$defs/EvidencePacket"},{"type":"null"}],"default":null,"description":"Evidence packet of the matched entity"},"pages":{"items":{"$ref":"#/$defs/Page"},"title":"Pages","type":"array"},"routes":{"description":"Top 3 destinations; call find_routes for more","items":{"$ref":"#/$defs/RouteOut"},"title":"Routes","type":"array"},"licence_note":{"title":"Licence Note","type":"string"}},"required":["query","status","pages","routes","licence_note"],"type":"object"},"annotations":{"title":"Search the knowledge graph and index","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest":{"method":"GET","path":"/api/v1/knowledge/search_knowledge"},"keyed":false,"examples":[{"query":"who founded Anthropic"},{"query":"history of the Antikythera mechanism"}]},{"name":"resolve_entity","title":"Resolve a name to entities","description":"List the entities a name could mean, with ids, descriptions and a confidence. Use it only to disambiguate ('which Mercury?', 'list entities called Paris') or to get an entity_id; for facts call get_entity_packet directly.","inputSchema":{"additionalProperties":false,"properties":{"name":{"description":"A name or phrase to resolve, e.g. 'Mercury' or 'Apple Inc'","maxLength":200,"minLength":1,"title":"Name","type":"string"},"limit":{"default":5,"description":"Candidates to return","maximum":10,"minimum":1,"title":"Limit","type":"integer"}},"required":["name"],"type":"object"},"outputSchema":{"$defs":{"Candidate":{"properties":{"entity_id":{"description":"Pass this to get_entity_packet / get_entity_changes / get_attention","title":"Entity Id","type":"string"},"name":{"title":"Name","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Type"},"wikidata_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Wikidata Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"},"confidence":{"maximum":1.0,"minimum":0.0,"title":"Confidence","type":"number"},"monthly_pageviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Monthly Pageviews"}},"required":["entity_id","name","confidence"],"title":"Candidate","type":"object"}},"properties":{"query":{"title":"Query","type":"string"},"best":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"entity_id of a confident match (confidence >= 0.7), else null","title":"Best"},"candidates":{"items":{"$ref":"#/$defs/Candidate"},"title":"Candidates","type":"array"},"note":{"title":"Note","type":"string"}},"required":["query","candidates","note"],"type":"object"},"annotations":{"title":"Resolve a name to entities","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest":{"method":"GET","path":"/api/v1/knowledge/resolve_entity"},"keyed":false,"examples":[{"name":"Mercury"}]},{"name":"find_routes","title":"Find where to look something up","description":"Destinations for a task: official sites, registries, APIs and site search URLs, ranked, each with its kind and licence. Use it to answer 'where can I look up / which API / which official site'. A route is where to fetch next, not evidence of the answer.","inputSchema":{"additionalProperties":false,"properties":{"query":{"description":"What you want to look up or do, e.g. 'company registry Estonia' or 'weather API'","maxLength":200,"minLength":1,"title":"Query","type":"string"},"limit":{"default":8,"maximum":20,"minimum":1,"title":"Limit","type":"integer"}},"required":["query"],"type":"object"},"outputSchema":{"$defs":{"RouteOut":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"url":{"title":"Url","type":"string"},"host":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Host"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"query (a search URL on that site), page, api or route","title":"Kind"},"match":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why this destination was chosen","title":"Match"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Licence"},"as_of_basis":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"As Of Basis"}},"required":["url"],"title":"RouteOut","type":"object"}},"properties":{"contract":{"default":"knowledge/1.2.0","title":"Contract","type":"string"},"query":{"title":"Query","type":"string"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Intent"},"routes":{"items":{"$ref":"#/$defs/RouteOut"},"title":"Routes","type":"array"},"note":{"default":"A route is a destination to fetch next, not evidence that the answer is there.","title":"Note","type":"string"}},"required":["query","routes"],"type":"object"},"annotations":{"title":"Find where to look something up","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest":{"method":"GET","path":"/api/v1/knowledge/find_routes"},"keyed":false,"examples":[{"query":"company registry Estonia"},{"query":"earthquake data API"}]},{"name":"get_entity_changes","title":"Recent changes to an entity","description":"Edits to one entity's source record (Wikidata), newest first, with the properties each edit touched, plus a cursor to poll for newer ones. Use it for 'what changed about X', 'was X updated since <date>', or to know when cached facts went stale.","inputSchema":{"additionalProperties":false,"properties":{"entity":{"description":"entity_id, Q-id, UUID or name of ONE entity","maxLength":200,"minLength":1,"title":"Entity","type":"string"},"since":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Only changes at or after this UTC date/time, e.g. '2026-10-01'","title":"Since"},"limit":{"default":25,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["entity"],"type":"object"},"outputSchema":{"$defs":{"AsOf":{"properties":{"copy_written_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When our stored row was last written for ANY reason (UTC ISO). Not a statement refresh: use claims_refreshed_at for that","title":"Copy Written At"},"last_source_edit_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Latest Wikidata edit to this item our edit stream recorded (UTC ISO)","title":"Last Source Edit Seen"},"stale_possible":{"default":false,"description":"Wikidata items: true unless our statements were checked against Wikidata (claims_refreshed_at) after the latest edit we saw. Other sources: true when the source recorded an edit after our copy was written","title":"Stale Possible","type":"boolean"},"claims_refreshed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When we last checked this item's statements against Wikidata and matched its revision (UTC ISO); null = not checked since 2026-10-25, when tracking began","title":"Claims Refreshed At"},"source_revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"The Wikidata revision id our statements matched at claims_refreshed_at","title":"Source Revision"}},"title":"AsOf","type":"object"},"Change":{"properties":{"changed_at":{"title":"Changed At","type":"string"},"fields":{"description":"Properties the edit touched (P-codes)","items":{"type":"string"},"title":"Fields","type":"array"},"field_labels":{"items":{"type":"string"},"title":"Field Labels","type":"array"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Summary"},"actor":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Actor"},"is_bot":{"default":false,"title":"Is Bot","type":"boolean"},"source":{"default":"wikidata","title":"Source","type":"string"}},"required":["changed_at","fields","field_labels"],"title":"Change","type":"object"},"PacketEntity":{"properties":{"entity_id":{"description":"Stable 4ort id to pass to other tools (slug, else UUID)","title":"Entity Id","type":"string"},"kg_uuid":{"title":"Kg Uuid","type":"string"},"wikidata_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Wikidata Id"},"name":{"title":"Name","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"4ort entity page","title":"Url"}},"required":["entity_id","kg_uuid","name"],"title":"PacketEntity","type":"object"},"Resolution":{"properties":{"input":{"description":"What you passed","title":"Input","type":"string"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"What it resolved to","title":"Entity Id"},"method":{"description":"id: matched a slug/Q-id/UUID; name: resolved a name","enum":["id","name"],"title":"Method","type":"string"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Confidence"},"alternatives":{"description":"Other entity_ids the name could mean","items":{"type":"string"},"title":"Alternatives","type":"array"}},"required":["input","method"],"title":"Resolution","type":"object"}},"properties":{"contract":{"default":"knowledge/1.2.0","title":"Contract","type":"string"},"entity":{"$ref":"#/$defs/PacketEntity"},"resolution":{"$ref":"#/$defs/Resolution"},"changes":{"items":{"$ref":"#/$defs/Change"},"title":"Changes","type":"array"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Pass as `since` to poll for newer changes","title":"Cursor"},"as_of":{"$ref":"#/$defs/AsOf"},"coverage":{"title":"Coverage","type":"string"}},"required":["entity","resolution","changes","as_of","coverage"],"type":"object"},"annotations":{"title":"Recent changes to an entity","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest":{"method":"GET","path":"/api/v1/knowledge/get_entity_changes"},"keyed":false,"examples":[{"entity":"Q42","since":"2026-10-01"}]},{"name":"why_trending","title":"What is trending and why","description":"Entities trending right now on Wikipedia by language edition, each with its pageview spike against baseline and 3 to 5 knowledge-graph-resolved news items that explain it (status news or organic). Use it for 'what is trending', 'why is X in the news today'. Needs your 4ort.xyz API key (free tier works).","inputSchema":{"additionalProperties":false,"properties":{"limit":{"default":10,"maximum":50,"minimum":1,"title":"Limit","type":"integer"},"type":{"anyOf":[{"enum":["person","org","place","work","event"],"type":"string"},{"type":"null"}],"default":null,"title":"Type"},"lang":{"default":"en","description":"Wikipedia edition: en, de, fr, es, it, ja, ru, pt, or all","title":"Lang","type":"string"},"include_unexplained":{"default":false,"description":"Also list trending entities without at least 3 verified news items","title":"Include Unexplained","type":"boolean"}},"type":"object"},"outputSchema":{"$defs":{"WhyTrendingEntity":{"properties":{"id":{"description":"4ort KG id (stable)","title":"Id","type":"string"},"wikidata_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wikidata Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"label":{"title":"Label","type":"string"},"type":{"title":"Type","type":"string"},"kg_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kg Type"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"rank":{"description":"Original pageview rank within this language edition","title":"Rank","type":"integer"},"pageviews_per_hour":{"title":"Pageviews Per Hour","type":"integer"},"baseline_per_hour":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Baseline Per Hour"},"delta_vs_baseline":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Vs Baseline"},"delta_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Pct"},"baseline_window_hours":{"title":"Baseline Window Hours","type":"integer"},"lang":{"title":"Lang","type":"string"},"window":{"additionalProperties":true,"title":"Window","type":"object"},"official_routes":{"items":{"additionalProperties":true,"type":"object"},"title":"Official Routes","type":"array"},"why":{"$ref":"#/$defs/WhyTrendingWhy"},"why_status":{"description":"news: a verified headline matched. organic: attention moved with no matched headline (why.why_label / why.why_summary carry the wording; no cause is invented)","enum":["news","organic"],"title":"Why Status","type":"string"},"why_icon":{"description":"Stable icon slug for the status, the same glyph on every 4ort surface","enum":["news","organic_surge","organic_interest"],"title":"Why Icon","type":"string"},"receipt":{"additionalProperties":true,"title":"Receipt","type":"object"}},"required":["id","wikidata_id","slug","label","type","kg_type","description","rank","pageviews_per_hour","baseline_per_hour","delta_vs_baseline","delta_pct","baseline_window_hours","lang","window","official_routes","why","why_status","why_icon","receipt"],"title":"WhyTrendingEntity","type":"object"},"WhyTrendingWhy":{"properties":{"status":{"title":"Status","type":"string"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"reason_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Kind"},"items":{"items":{"additionalProperties":true,"type":"object"},"title":"Items","type":"array"},"why_status":{"anyOf":[{"enum":["news","organic"],"type":"string"},{"type":"null"}],"default":null,"description":"news: a verified headline matched the entity (evidence, not proven cause). organic: attention moved with no matched headline; a driver is likely but not named.","title":"Why Status"},"why_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"e.g. 'In the news', 'Organic surge', 'Organic interest'","title":"Why Label"},"why_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"One sentence for a person; never invents a cause","title":"Why Summary"},"why_icon":{"anyOf":[{"enum":["news","organic_surge","organic_interest","followup"],"type":"string"},{"type":"null"}],"default":null,"description":"Stable icon slug: news (headline found), organic_surge (climbing, no headline yet), organic_interest (steady, no single story), followup (alert update: likely driver found)","title":"Why Icon"},"receipt":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Receipt"}},"required":["status","reason","reason_kind","items"],"title":"WhyTrendingWhy","type":"object"}},"properties":{"resolver_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Resolver Version"},"computed_at":{"title":"Computed At","type":"string"},"window":{"additionalProperties":true,"title":"Window","type":"object"},"receipts":{"items":{"additionalProperties":true,"type":"object"},"title":"Receipts","type":"array"},"entities":{"items":{"$ref":"#/$defs/WhyTrendingEntity"},"title":"Entities","type":"array"},"lang":{"title":"Lang","type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"count":{"title":"Count","type":"integer"},"include_unexplained":{"title":"Include Unexplained","type":"boolean"},"coverage":{"additionalProperties":true,"title":"Coverage","type":"object"}},"required":["computed_at","window","receipts","entities","lang","region","type","count","include_unexplained","coverage"],"type":"object"},"annotations":{"title":"What is trending and why","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest":{"method":"GET","path":"/api/v1/knowledge/why_trending"},"keyed":true,"examples":[{"limit":5},{"type":"person","lang":"de"}]},{"name":"get_attention","title":"Attention over time for an entity","description":"Wikipedia pageviews for one entity as a time series (48 h hourly, 30 d daily or 12 months monthly), its change across the period, and views per language. Use it for 'how popular is X', 'is interest in X rising', 'monthly views of X'.","inputSchema":{"additionalProperties":false,"properties":{"entity":{"description":"entity_id, Q-id, UUID or name of ONE entity","maxLength":200,"minLength":1,"title":"Entity","type":"string"},"period":{"default":"30d","description":"48h: hourly points; 30d: daily points; 12m: monthly points","enum":["48h","30d","12m"],"title":"Period","type":"string"}},"required":["entity"],"type":"object"},"outputSchema":{"$defs":{"Citation":{"description":"Where one fact comes from and what you may do with it.","properties":{"source":{"description":"Source-registry key, e.g. 'wikidata', 'geonames' (see get_source_info)","title":"Source","type":"string"},"source_name":{"description":"Human name of the source dataset","title":"Source Name","type":"string"},"source_record":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"URL of the record inside the source that states this fact","title":"Source Record"},"source_edition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Edition of that record we serve (ISO time or the dataset's edition label)","title":"Source Edition"},"edition_basis":{"description":"claims_refreshed_at: when we last checked this item's statements against the source and matched its revision (the value was current then); lake_edition: the dataset release we loaded; derived_at: when 4ort derived the claim; copy_written_at: when our row was last written, which is NOT a statement refresh (kept for older clients); unknown: not recorded","enum":["claims_refreshed_at","copy_written_at","lake_edition","derived_at","unknown"],"title":"Edition Basis","type":"string"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Licence of the source dataset; null = unknown, never assumed","title":"Licence"},"licence_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Licence Url"},"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Credit line the licence requires when you reuse the fact; null = none required","title":"Attribution"},"references":{"description":"The source's own references for this statement (at most 2)","items":{"$ref":"#/$defs/Reference"},"title":"References","type":"array"}},"required":["source","source_name","edition_basis"],"title":"Citation","type":"object"},"PacketEntity":{"properties":{"entity_id":{"description":"Stable 4ort id to pass to other tools (slug, else UUID)","title":"Entity Id","type":"string"},"kg_uuid":{"title":"Kg Uuid","type":"string"},"wikidata_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Wikidata Id"},"name":{"title":"Name","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"4ort entity page","title":"Url"}},"required":["entity_id","kg_uuid","name"],"title":"PacketEntity","type":"object"},"Reference":{"description":"One of the source's own references for a statement (Wikidata reference block).\nFields the source does not give are left out of the JSON (all are optional).","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Reference URL (P854), when the source gives one","title":"Url"},"stated_in":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Work the source cites (P248), as a label","title":"Stated In"},"stated_in_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Wikidata Q-id of that work","title":"Stated In Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Title of the cited work (P1476)","title":"Title"},"retrieved":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When the source retrieved it (P813), YYYY-MM-DD","title":"Retrieved"},"imported_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Wikimedia project the statement was imported from (P143); not an independent source","title":"Imported From"}},"title":"Reference","type":"object"},"Resolution":{"properties":{"input":{"description":"What you passed","title":"Input","type":"string"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"What it resolved to","title":"Entity Id"},"method":{"description":"id: matched a slug/Q-id/UUID; name: resolved a name","enum":["id","name"],"title":"Method","type":"string"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Confidence"},"alternatives":{"description":"Other entity_ids the name could mean","items":{"type":"string"},"title":"Alternatives","type":"array"}},"required":["input","method"],"title":"Resolution","type":"object"},"SeriesPoint":{"properties":{"period":{"title":"Period","type":"string"},"views":{"title":"Views","type":"integer"}},"required":["period","views"],"title":"SeriesPoint","type":"object"}},"properties":{"contract":{"default":"knowledge/1.2.0","title":"Contract","type":"string"},"entity":{"$ref":"#/$defs/PacketEntity"},"resolution":{"$ref":"#/$defs/Resolution"},"period":{"title":"Period","type":"string"},"series":{"description":"Wikipedia pageviews, oldest first","items":{"$ref":"#/$defs/SeriesPoint"},"title":"Series","type":"array"},"total":{"title":"Total","type":"integer"},"change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Second half of the series vs the first half, percent; null when the first half is 0","title":"Change Pct"},"monthly_pageviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Monthly Pageviews"},"by_lang_30d":{"additionalProperties":{"type":"integer"},"description":"Views per Wikipedia language, last 30 days","title":"By Lang 30D","type":"object"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Latest period with data","title":"As Of"},"citation":{"$ref":"#/$defs/Citation"}},"required":["entity","resolution","period","series","total","citation"],"type":"object"},"annotations":{"title":"Attention over time for an entity","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest":{"method":"GET","path":"/api/v1/knowledge/get_attention"},"keyed":false,"examples":[{"entity":"Taylor Swift","period":"12m"}]},{"name":"get_source_info","title":"Licence and terms of a data source","description":"The licence, required credit line, redistribution and resale status of a dataset 4ort serves (Wikidata, GeoNames, GLEIF, SEC EDGAR, ...). Use it for 'can I reuse / redistribute facts from X', 'what licence is source Y', 'how must I credit Z'. Packets already carry the licence per fact; this explains a source.","inputSchema":{"additionalProperties":false,"properties":{"source":{"default":"","description":"Source key or name, e.g. 'wikidata', 'geonames', 'GLEIF'. Empty lists every source","maxLength":100,"title":"Source","type":"string"}},"type":"object"},"outputSchema":{"$defs":{"SourceInfo":{"description":"One registered source. Listing every source (empty query) leaves out kind, homepage,\napplies_to and uses to keep the list small; ask for a source by name for all of it.","properties":{"key":{"title":"Key","type":"string"},"name":{"title":"Name","type":"string"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Kind"},"licence":{"title":"Licence","type":"string"},"licence_url":{"title":"Licence Url","type":"string"},"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Credit line required on reuse; null = none","title":"Attribution"},"attribution_required":{"title":"Attribution Required","type":"boolean"},"redistributed":{"description":"False: 4ort uses it but does not pass its data on","title":"Redistributed","type":"boolean"},"sellable":{"description":"May appear on paid surfaces","title":"Sellable","type":"boolean"},"tier":{"title":"Tier","type":"string"},"status":{"title":"Status","type":"string"},"homepage":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Homepage"},"applies_to":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Applies To"},"uses":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Uses"}},"required":["key","name","licence","licence_url","attribution_required","redistributed","sellable","tier","status"],"title":"SourceInfo","type":"object"}},"properties":{"contract":{"default":"knowledge/1.2.0","title":"Contract","type":"string"},"query":{"title":"Query","type":"string"},"sources":{"items":{"$ref":"#/$defs/SourceInfo"},"title":"Sources","type":"array"},"total_registered":{"title":"Total Registered","type":"integer"},"by_licence":{"additionalProperties":{"type":"integer"},"description":"Registered sources per licence","title":"By Licence","type":"object"}},"required":["query","sources","total_registered"],"type":"object"},"annotations":{"title":"Licence and terms of a data source","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest":{"method":"GET","path":"/api/v1/knowledge/get_source_info"},"keyed":false,"examples":[{"source":"geonames"}]},{"name":"get_upcoming_launches","title":"Upcoming rocket launches","description":"The next scheduled orbital launches worldwide, soonest first: rocket, provider, pad and country, NET (no-earlier-than, UTC) with its precision, status, mission type and orbit. Use it for 'when is the next launch', 'upcoming SpaceX launches', 'what launches this week'. From Launch Library 2 (Apache-2.0) via the 4ort lake; `as_of` and `stale` say how fresh the capture is.","inputSchema":{"additionalProperties":false,"properties":{"limit":{"default":10,"description":"How many launches, soonest first","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"type":"object"},"outputSchema":{"$defs":{"UpcomingLaunch":{"description":"One scheduled orbital launch. `net` is No Earlier Than; `net_precision` says how exact it is\n(SEC, MIN, HR, DAY, MONTH, Q1..Q4, YEAR). Fields Launch Library 2 does not give are null.","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Launch Library 2 launch UUID","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'Rocket | Payload', as Launch Library 2 names it","title":"Name"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Launch service provider","title":"Provider"},"rocket":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Rocket"},"pad":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Pad"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Launch site","title":"Location"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-2 of the pad","title":"Country"},"net":{"description":"No Earlier Than, UTC ISO 8601","title":"Net","type":"string"},"net_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Net Precision"},"window_start":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Window Start"},"window_end":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Window End"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"e.g. 'Go for Launch', 'To Be Determined'","title":"Status"},"status_abbrev":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Status Abbrev"},"mission":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Mission"},"mission_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Mission Type"},"orbit":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Orbit"},"webcast_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Webcast Url"},"webcast_live":{"default":false,"title":"Webcast Live","type":"boolean"},"source":{"title":"Source","type":"string"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The launch's Launch Library 2 record","title":"Source Url"}},"required":["net","source"],"title":"UpcomingLaunch","type":"object"}},"properties":{"launches":{"items":{"$ref":"#/$defs/UpcomingLaunch"},"title":"Launches","type":"array"},"count":{"title":"Count","type":"integer"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When the capture was fetched from Launch Library 2, UTC","title":"As Of"},"edition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Lake capture date","title":"Edition"},"stale":{"description":"True when the capture is over 36 h old: launches announced since may be missing","title":"Stale","type":"boolean"},"source":{"title":"Source","type":"string"},"licence":{"title":"Licence","type":"string"},"attribution":{"description":"Credit line required on reuse","title":"Attribution","type":"string"}},"required":["launches","count","stale","source","licence","attribution"],"type":"object"},"annotations":{"title":"Upcoming rocket launches","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest":{"method":"GET","path":"/api/v1/knowledge/get_upcoming_launches"},"keyed":false,"examples":[{"limit":10}]},{"name":"get_galaxy_brain","title":"Galaxy brain: live signals","description":"One live snapshot of the whole 4ort galaxy, one object per brain region: crawler pages fetched (eyes), news ingested and latest headlines (ears), top Wikipedia attention with why (attention), knowledge-graph size and growth today plus the Wikidata edit rate (memory), facts verified into the served tier (reasoning), the data lake's size and newest landing (deep_memory), the next rocket launch (mission_control), the trust-and-safety patrol state (immune) and what 4ort.live is playing (voice). Use it for 'what is happening across 4ort right now'. Rebuilt every minute; each region has ok and updated_at.","inputSchema":{"additionalProperties":false,"description":"No parameters: the snapshot is one object for the whole galaxy.","properties":{},"type":"object"},"outputSchema":{"$defs":{"BrainAttention":{"properties":{"ok":{"description":"False when this region's source could not be read this cycle","title":"Ok","type":"boolean"},"updated_at":{"description":"When this region was last collected, UTC ISO 8601","title":"Updated At","type":"string"},"source":{"description":"Where the numbers come from","title":"Source","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why ok is false: 'timeout' or 'unavailable'","title":"Error"},"trending":{"description":"Top English Wikipedia attention, rank order","items":{"$ref":"#/$defs/BrainTrend"},"title":"Trending","type":"array"},"window_end":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End of the pageview hour ranked","title":"Window End"}},"required":["ok","updated_at","source"],"title":"BrainAttention","type":"object"},"BrainDeepMemory":{"properties":{"ok":{"description":"False when this region's source could not be read this cycle","title":"Ok","type":"boolean"},"updated_at":{"description":"When this region was last collected, UTC ISO 8601","title":"Updated At","type":"string"},"source":{"description":"Where the numbers come from","title":"Source","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why ok is false: 'timeout' or 'unavailable'","title":"Error"},"sources":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Datasets in the 4ort lake catalog","title":"Sources"},"rows_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Rows across every source's latest edition","title":"Rows Total"},"newest_landing":{"anyOf":[{"$ref":"#/$defs/BrainLanding"},{"type":"null"}],"default":null},"catalog_generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Catalog Generated At"}},"required":["ok","updated_at","source"],"title":"BrainDeepMemory","type":"object"},"BrainEars":{"properties":{"ok":{"description":"False when this region's source could not be read this cycle","title":"Ok","type":"boolean"},"updated_at":{"description":"When this region was last collected, UTC ISO 8601","title":"Updated At","type":"string"},"source":{"description":"Where the numbers come from","title":"Source","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why ok is false: 'timeout' or 'unavailable'","title":"Error"},"articles_1h":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"News articles GDELT tagged in the last hour","title":"Articles 1H"},"latest_headlines":{"description":"Newest headlines from allowlisted publishers, safety-screened","items":{"$ref":"#/$defs/BrainHeadline"},"title":"Latest Headlines","type":"array"}},"required":["ok","updated_at","source"],"title":"BrainEars","type":"object"},"BrainEyes":{"properties":{"ok":{"description":"False when this region's source could not be read this cycle","title":"Ok","type":"boolean"},"updated_at":{"description":"When this region was last collected, UTC ISO 8601","title":"Updated At","type":"string"},"source":{"description":"Where the numbers come from","title":"Source","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why ok is false: 'timeout' or 'unavailable'","title":"Error"},"pages_fetched_1m":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Pages the 4ort.nexus crawler fetched in the last minute","title":"Pages Fetched 1M"},"pages_fetched_1h":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Pages Fetched 1H"},"pages_in_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Pages in the nexus index (planner estimate)","title":"Pages In Index"},"last_fetch_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Fetch At"}},"required":["ok","updated_at","source"],"title":"BrainEyes","type":"object"},"BrainHeadline":{"properties":{"title":{"title":"Title","type":"string"},"publisher":{"description":"Publisher domain","title":"Publisher","type":"string"},"seen_at":{"title":"Seen At","type":"string"}},"required":["title","publisher","seen_at"],"title":"BrainHeadline","type":"object"},"BrainImmune":{"properties":{"ok":{"description":"False when this region's source could not be read this cycle","title":"Ok","type":"boolean"},"updated_at":{"description":"When this region was last collected, UTC ISO 8601","title":"Updated At","type":"string"},"source":{"description":"Where the numbers come from","title":"Source","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why ok is false: 'timeout' or 'unavailable'","title":"Error"},"state":{"anyOf":[{"enum":["clean","attention"],"type":"string"},{"type":"null"}],"default":null,"description":"'attention' while a critical trust-and-safety finding is open","title":"State"},"last_patrol_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Patrol At"},"patrols_24h":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Patrols 24H"}},"required":["ok","updated_at","source"],"title":"BrainImmune","type":"object"},"BrainLanding":{"properties":{"source":{"title":"Source","type":"string"},"date":{"title":"Date","type":"string"}},"required":["source","date"],"title":"BrainLanding","type":"object"},"BrainLaunch":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Provider"},"net":{"description":"No Earlier Than, UTC ISO 8601","title":"Net","type":"string"},"net_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Net Precision"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Status"},"webcast_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Webcast Url"}},"required":["net"],"title":"BrainLaunch","type":"object"},"BrainMemory":{"properties":{"ok":{"description":"False when this region's source could not be read this cycle","title":"Ok","type":"boolean"},"updated_at":{"description":"When this region was last collected, UTC ISO 8601","title":"Updated At","type":"string"},"source":{"description":"Where the numbers come from","title":"Source","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why ok is false: 'timeout' or 'unavailable'","title":"Error"},"entities_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Entities in the knowledge graph (planner estimate)","title":"Entities Total"},"entities_added_today":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Entities created since 00:00 UTC","title":"Entities Added Today"},"entities_added_today_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"This count refreshes every 10 min","title":"Entities Added Today As Of"},"facts_added_today":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Facts entering the served tier since 00:00 UTC","title":"Facts Added Today"},"wikidata_edits_per_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Wikidata edits to entities we hold, 5-min average","title":"Wikidata Edits Per Min"}},"required":["ok","updated_at","source"],"title":"BrainMemory","type":"object"},"BrainMissionControl":{"properties":{"ok":{"description":"False when this region's source could not be read this cycle","title":"Ok","type":"boolean"},"updated_at":{"description":"When this region was last collected, UTC ISO 8601","title":"Updated At","type":"string"},"source":{"description":"Where the numbers come from","title":"Source","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why ok is false: 'timeout' or 'unavailable'","title":"Error"},"next_launch":{"anyOf":[{"$ref":"#/$defs/BrainLaunch"},{"type":"null"}],"default":null},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"As Of"},"stale":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Stale"},"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Attribution"}},"required":["ok","updated_at","source"],"title":"BrainMissionControl","type":"object"},"BrainReasoning":{"properties":{"ok":{"description":"False when this region's source could not be read this cycle","title":"Ok","type":"boolean"},"updated_at":{"description":"When this region was last collected, UTC ISO 8601","title":"Updated At","type":"string"},"source":{"description":"Where the numbers come from","title":"Source","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why ok is false: 'timeout' or 'unavailable'","title":"Error"},"facts_verified_1h":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Facts promoted into the served tier in the last hour","title":"Facts Verified 1H"},"served_tier_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Facts currently in the served tier","title":"Served Tier Total"}},"required":["ok","updated_at","source"],"title":"BrainReasoning","type":"object"},"BrainRegions":{"properties":{"eyes":{"$ref":"#/$defs/BrainEyes"},"ears":{"$ref":"#/$defs/BrainEars"},"attention":{"$ref":"#/$defs/BrainAttention"},"memory":{"$ref":"#/$defs/BrainMemory"},"reasoning":{"$ref":"#/$defs/BrainReasoning"},"deep_memory":{"$ref":"#/$defs/BrainDeepMemory"},"mission_control":{"$ref":"#/$defs/BrainMissionControl"},"immune":{"$ref":"#/$defs/BrainImmune"},"voice":{"$ref":"#/$defs/BrainVoice"}},"required":["eyes","ears","attention","memory","reasoning","deep_memory","mission_control","immune","voice"],"title":"BrainRegions","type":"object"},"BrainTrend":{"properties":{"name":{"title":"Name","type":"string"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Slug"},"why":{"description":"Matched headline, or the organic-attention label when no headline matched","title":"Why","type":"string"},"why_icon":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"news | organic_surge | organic_interest | followup","title":"Why Icon"},"delta_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Pageviews vs the 7-day baseline, percent","title":"Delta Pct"}},"required":["name","why"],"title":"BrainTrend","type":"object"},"BrainVoice":{"properties":{"ok":{"description":"False when this region's source could not be read this cycle","title":"Ok","type":"boolean"},"updated_at":{"description":"When this region was last collected, UTC ISO 8601","title":"Updated At","type":"string"},"source":{"description":"Where the numbers come from","title":"Source","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why ok is false: 'timeout' or 'unavailable'","title":"Error"},"playing":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Playing"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"artist":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Null: 4ort.live tracks are generated, not credited","title":"Artist"},"station":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Station"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Started At"},"duration_s":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Duration S"}},"required":["ok","updated_at","source"],"title":"BrainVoice","type":"object"}},"properties":{"version":{"description":"Snapshot format, '4ort.galaxy-brain/1'","title":"Version","type":"string"},"generated_at":{"title":"Generated At","type":"string"},"refresh_s":{"description":"How often the snapshot is rebuilt, seconds","title":"Refresh S","type":"integer"},"regions":{"$ref":"#/$defs/BrainRegions"}},"required":["version","generated_at","refresh_s","regions"],"type":"object"},"annotations":{"title":"Galaxy brain: live signals","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest":{"method":"GET","path":"/api/v1/knowledge/get_galaxy_brain"},"keyed":false,"examples":[{}]}],"sha256":"5f6a47552e292840afcc2830d4557e93be6b3ae3e8371e545a55eaddcf10b5ce"}