V³ News

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``.

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").

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.

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.

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).

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.

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).