V³ News

Search V³ News for tracked geopolitical events. Use when the user asks what is happening on a topic, in a country, or in a domain (e.g. security, energy, finance, technology). Returns a ranked list of events with why-it-matters, risk/impact/signal scores, and a v3.news link for each. Args: query: free-text topic (e.g. "Iran sanctions", "Taiwan"). Optional. country: ISO-3166 alpha-2 code to filter by (e.g. "US", "CN"). Optional. category: V³ category slug — one of geopolitics, security_risk, energy_resources, finance, markets, macroeconomics, public_finance, trade_supply, technology, science_biosecurity, environment_climate, business. Optional. limit: max results, 1-20 (default 10).

{
  "type": "object",
  "properties": {
    "query": {
      "default": "",
      "title": "Query",
      "type": "string"
    },
    "country": {
      "default": "",
      "title": "Country",
      "type": "string"
    },
    "category": {
      "default": "",
      "title": "Category",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "v3_search_eventsArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "v3_search_eventsDictOutput"
}

Get a single V³ event: headline, why-it-matters, scores, and how much structured analysis V³ holds on it (perspectives, decisions, outcomes). Use after v3_search_events (or v3_breaking_now) when the user wants detail on a specific event. This returns V³'s public summary; the full country-by-country perspectives, timeline, decisions to watch, and assessed outcomes are on v3.news at the returned url (a V³ account unlocks the multi-perspective analysis). Args: event_id: the V³ event id from a prior tool result.

{
  "type": "object",
  "properties": {
    "event_id": {
      "title": "Event Id",
      "type": "string"
    }
  },
  "required": [
    "event_id"
  ],
  "title": "v3_get_eventArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "v3_get_eventDictOutput"
}

Search V³ News for tracked geopolitical events matching a query. Returns a list of matching events, each with an id (for ``fetch``) and a v3.news citation url. V³ covers 12 categories (geopolitics, security, energy, finance, markets, macro, trade, technology, science, climate, business, public finance) with multi-perspective, cited analysis. Args: query: free-text topic, country, or question (e.g. "Iran sanctions").

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "title": "searchArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "searchDictOutput"
}

Fetch the full text of a single V³ event by id (from ``search``). Returns V³'s public report (headline, why-it-matters, the full long-form report when V³ has authored one, risk/impact/signal scores, coverage depth) plus the canonical v3.news url for citation. The country-by-country perspectives, timeline, decisions and assessed outcomes live at that url. Args: id: the V³ event id returned by ``search``.

{
  "type": "object",
  "properties": {
    "id": {
      "title": "Id",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "title": "fetchArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "fetchDictOutput"
}

Get V³'s latest global intelligence brief — the chief-of-staff top line on what matters in the world right now, with per-category state and counts. Use when the user asks for a world summary, "what's happening today", or a geopolitical situation overview.

{
  "type": "object",
  "properties": {},
  "title": "v3_latest_briefArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "v3_latest_briefDictOutput"
}

Get events V³ is currently tracking in BREAKING tempo — fast- moving stories under near-real-time monitoring right now. Use when the user asks "what's breaking", "any breaking news", or about a developing situation. Returns an empty list when nothing is in breaking tempo (a quiet news moment), which is itself a signal.

{
  "type": "object",
  "properties": {},
  "title": "v3_breaking_nowArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "v3_breaking_nowDictOutput"
}

Get V³'s Global Pulse — the world's current risk/impact/signal reading and how it has moved over a recent window. Use when the user asks how tense/volatile the world is right now, whether global risk is rising or falling, or wants a one-number situational read rather than a specific event. Scores are 0-100 aggregates across everything V³ tracks (risk = downside pressure, impact = consequence, signal = momentum, priority = attention weight). Args: window_days: trailing window for the trend, 2-90 (default 14).

{
  "type": "object",
  "properties": {
    "window_days": {
      "default": 14,
      "title": "Window Days",
      "type": "integer"
    }
  },
  "title": "v3_global_pulseArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "v3_global_pulseDictOutput"
}