newsflash

Query the deduped news event graph by theme, source, category and time window. Returns events (many articles about one happening collapsed into one), each with a corroboration count and confidence score. This is the primary tool — prefer it over raw articles. For headlines, briefings, or 'what's happening' asks, pass min_sources: 2 (or 3 for high signal) — the raw recency feed is dominated by single-outlet local stories without it. ONE call is normally enough: trust each event's corroboration (distinct outlets), confidence (0-1; 1.0 = fully corroborated), and sources list as-is, and present the top events directly, including each event's url as its link — do NOT call get_event per item or re-verify counts (only drill in when the user wants EVERY outlet's link for one story). The corpus spans 260+ global outlets and a five-year archive (history visible depends on tier).

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free-text theme/keyword to match on headline + summary"
    },
    "semantic": {
      "type": "boolean",
      "description": "Rank by meaning (embedding similarity) instead of keyword match — requires q; better for concepts ('monetary easing') than exact strings"
    },
    "source": {
      "type": "string",
      "description": "Source slug, e.g. 'coindesk' (see list_sources)"
    },
    "category": {
      "type": "string",
      "enum": [
        "crypto",
        "tradfi",
        "business",
        "tech",
        "politics",
        "world",
        "science",
        "health",
        "energy",
        "sports"
      ],
      "description": "Source category"
    },
    "from": {
      "type": "string",
      "description": "Only events active on/after this date. ISO 8601 date/time, e.g. 2026-07-01 or 2026-07-01T00:00:00Z"
    },
    "to": {
      "type": "string",
      "description": "Only events active on/before this date. ISO 8601 date/time, e.g. 2026-07-01 or 2026-07-01T00:00:00Z"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max events (default 15)"
    },
    "min_sources": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Only events corroborated by at least this many distinct outlets — use 2-3 for briefings/headlines to skip single-source noise"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch a single event by id, including every corroborating article (source, url, timestamp).

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Event id from get_events"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search raw articles (not collapsed into events). Use when you want the underlying items or need per-outlet coverage rather than deduped happenings.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free-text keyword on headline + summary"
    },
    "source": {
      "type": "string",
      "description": "Source slug"
    },
    "category": {
      "type": "string",
      "enum": [
        "crypto",
        "tradfi",
        "business",
        "tech",
        "politics",
        "world",
        "science",
        "health",
        "energy",
        "sports"
      ],
      "description": "Source category"
    },
    "from": {
      "type": "string",
      "description": "ISO 8601 date/time, e.g. 2026-07-01 or 2026-07-01T00:00:00Z"
    },
    "to": {
      "type": "string",
      "description": "ISO 8601 date/time, e.g. 2026-07-01 or 2026-07-01T00:00:00Z"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max articles (default 25)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List all news sources Newsflash tracks, with categories and live article counts.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Corpus size and freshness: source / article / event counts and the latest article timestamp.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}