World Monitor

Official75 toolsLive

by koala73 · TypeScript

Live markets, conflicts, country risk, chokepoints, energy, and China decision signals. 86 tools.

app.worldmonitor/mcp (MCP) Server

The app.worldmonitor/mcp server is an MCP integration for live global intelligence. It focuses on live markets, conflicts, country risk, chokepoints, energy, and “China decision signals,” provided as 75 tools (toolCount: 41). Its description emphasizes a unified situational awareness interface for monitoring and news aggregation.

🛠️ Key Features

Live markets and geopolitical monitoring
Conflicts, country risk, and chokepoints
Energy and China decision signals
MCP server topic coverage: ai, dashboard, geopolitics, monitoring, news, osint, opensource, situation

🚀 Use Cases

Tracking geopolitical and infrastructure-related conditions over time
Monitoring news and signals relevant to international risk and decision-making
Building developer dashboards using MCP

⚡ Developer Benefits

Exposes a broad tool surface (toolCount: 41)
Includes MCP-relevant identifiers in topics (mcp, mcp-server, agent)
Documented as “World Monitor” with multilingual README links (简体中文, 日本語)

⚠️ Limitations

Source material does not list individual tools, APIs, schemas, or authentication details

global intelligencereal-time marketsgeopolitical riskcountry risk assessmentenergy monitoringconflict tracking

Topics

aidashboardgeopoliticsmonitoringnewsosintopensourcepalantirsituationagentmcpmcp-server

Captured live from the server via tools/list.

get_toronto_reported_occurrences

Bounded Toronto Police Service Major Crime Indicators rows.

Parameters6

division	string	optional	Case-insensitive TPS division filter.
neighbourhood	string	optional	Case-insensitive neighbourhood filter.
offence	string	optional	Case-insensitive offence filter.
limit	number	optional	Maximum rows to return, from 1 to 100 (default 50).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "division": {
      "type": "string",
      "description": "Case-insensitive TPS division filter."
    },
    "neighbourhood": {
      "type": "string",
      "description": "Case-insensitive neighbourhood filter."
    },
    "offence": {
      "type": "string",
      "description": "Case-insensitive offence filter."
    },
    "limit": {
      "type": "number",
      "description": "Maximum rows to return, from 1 to 100 (default 50)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_toronto_calls_attended

Bounded Toronto Police Service Calls for Service Attended annual aggregates.

Parameters6

year	number	optional	Exact event year.
division	string	optional	Case-insensitive original or final TPS division filter.
neighbourhood	string	optional	Case-insensitive neighbourhood filter.
limit	number	optional	Maximum rows to return, from 1 to 100 (default 50).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "year": {
      "type": "number",
      "description": "Exact event year."
    },
    "division": {
      "type": "string",
      "description": "Case-insensitive original or final TPS division filter."
    },
    "neighbourhood": {
      "type": "string",
      "description": "Case-insensitive neighbourhood filter."
    },
    "limit": {
      "type": "number",
      "description": "Maximum rows to return, from 1 to 100 (default 50)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_market_data

Real-time equity quotes, commodity prices, SGE physical-vs-COMEX premiums, physical-divergence regimes and trends, crypt

Parameters5

symbols	array	optional	Tickers to keep, e.g. ["AAPL","GC=F","BTC"]. Case-insensitive; matches equity/commodity/crypto/gulf quotes, physical-premium and divergence aliases (gold/XAU/GC=F, silver/XAG/SI=F), sector ETFs, and ETF-flow tickers. Omit for the full snapshot.
asset_class	array	optional	Restrict the response to one or more asset classes. Omit for all.
limit	number	optional	Cap each per-class quote list (stocks/commodities/crypto/gulf/sectors/ETF flows) to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tickers to keep, e.g. [\"AAPL\",\"GC=F\",\"BTC\"]. Case-insensitive; matches equity/commodity/crypto/gulf quotes, physical-premium and divergence aliases (gold/XAU/GC=F, silver/XAG/SI=F), sector ETFs, and ETF-flow tickers. Omit for the full snapshot."
    },
    "asset_class": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "equity",
          "commodity",
          "crypto",
          "sectors",
          "etf",
          "gulf",
          "sentiment"
        ]
      },
      "description": "Restrict the response to one or more asset classes. Omit for all."
    },
    "limit": {
      "type": "number",
      "description": "Cap each per-class quote list (stocks/commodities/crypto/gulf/sectors/ETF flows) to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_conflict_events

Active armed conflict events (UCDP, Iran), unrest events with geo-coordinates, and country risk scores.

Parameters5

country	string	optional	Filter to one country — matches the country name on conflict/unrest events and the ISO 3166-1 alpha-2 region code on risk scores (case-insensitive).
min_fatalities	number	optional	Drop events below this fatality count (UCDP deathsBest / unrest fatalities).
limit	number	optional	Cap each event list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Filter to one country — matches the country name on conflict/unrest events and the ISO 3166-1 alpha-2 region code on risk scores (case-insensitive)."
    },
    "min_fatalities": {
      "type": "number",
      "description": "Drop events below this fatality count (UCDP deathsBest / unrest fatalities)."
    },
    "limit": {
      "type": "number",
      "description": "Cap each event list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_aviation_status

Airport delays, NOTAM airspace closures, and tracked military aircraft.

Parameters6

disrupted_only	boolean	optional	Drop airports with severity "normal" — keep only airports actually experiencing delays/closures. The bootstrap lists every monitored airport, so most rows are non-events without this.
country	string	optional	Filter to one country by name (case-insensitive substring, e.g. "united states").
iata	string	optional	Filter to a single airport by IATA code (e.g. "JFK").
limit	number	optional	Cap the alert list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "disrupted_only": {
      "type": "boolean",
      "description": "Drop airports with severity \"normal\" — keep only airports actually experiencing delays/closures. The bootstrap lists every monitored airport, so most rows are non-events without this."
    },
    "country": {
      "type": "string",
      "description": "Filter to one country by name (case-insensitive substring, e.g. \"united states\")."
    },
    "iata": {
      "type": "string",
      "description": "Filter to a single airport by IATA code (e.g. \"JFK\")."
    },
    "limit": {
      "type": "number",
      "description": "Cap the alert list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_news_intelligence

AI-classified geopolitical threat news summaries, GDELT intelligence signals, cross-source signals including physical-pr

Parameters9

topic	string	optional	Filter GDELT intelligence to a single topic.
category	string	optional	Filter top news stories to one category (e.g. "conflict", "economy"; fallback is "general").
country	string	optional	Filter top stories and travel advisories to one ISO 3166-1 alpha-2 country code (case-insensitive). Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
alerts_only	boolean	optional	Keep only top stories flagged as alerts.
query	string	optional	Keep only top stories whose headline, primary source, or any clustered member headline contains this text (case-insensitive substring). This filters the LIVE news window only — it is not a historical index, so an event older than the current digest will not be found here. Use search_intel_history for that.
min_importance	number	optional	Keep only top stories whose effectiveImportanceScore is at least this value. 0 is honoured as a real floor rather than treated as absent; a story carrying no score is excluded when this is set, never treated as scoring zero.
limit	number	optional	Cap each list (top stories, signals, advisories) to at most this many items (default 30, pass 0 for no cap). Applied AFTER query and min_importance, so a capped list is drawn from the matches.
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "conflict",
        "economy",
        "cyber",
        "nuclear",
        "intelligence",
        "maritime"
      ],
      "description": "Filter GDELT intelligence to a single topic."
    },
    "category": {
      "type": "string",
      "description": "Filter top news stories to one category (e.g. \"conflict\", \"economy\"; fallback is \"general\")."
    },
    "country": {
      "type": "string",
      "description": "Filter top stories and travel advisories to one ISO 3166-1 alpha-2 country code (case-insensitive). Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "alerts_only": {
      "type": "boolean",
      "description": "Keep only top stories flagged as alerts."
    },
    "query": {
      "type": "string",
      "description": "Keep only top stories whose headline, primary source, or any clustered member headline contains this text (case-insensitive substring). This filters the LIVE news window only — it is not a historical index, so an event older than the current digest will not be found here. Use search_intel_history for that."
    },
    "min_importance": {
      "type": "number",
      "description": "Keep only top stories whose effectiveImportanceScore is at least this value. 0 is honoured as a real floor rather than treated as absent; a story carrying no score is excluded when this is set, never treated as scoring zero."
    },
    "limit": {
      "type": "number",
      "description": "Cap each list (top stories, signals, advisories) to at most this many items (default 30, pass 0 for no cap). Applied AFTER query and min_importance, so a capped list is drawn from the matches."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_natural_disasters

Recent M4.5+ earthquakes (USGS and Earthquakes Canada / NRCan), active wildfires (NASA FIRMS), and natural hazard events

Parameters6

dataset	array	optional	Restrict to one or more hazard datasets (earthquakes / wildfires / other natural events). Omit for all.
min_magnitude	number	optional	Drop earthquakes and natural events below this magnitude.
active_only	boolean	optional	Keep only natural events that are still active (not closed).
limit	number	optional	Cap each hazard list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "earthquakes",
          "wildfires",
          "other"
        ]
      },
      "description": "Restrict to one or more hazard datasets (earthquakes / wildfires / other natural events). Omit for all."
    },
    "min_magnitude": {
      "type": "number",
      "description": "Drop earthquakes and natural events below this magnitude."
    },
    "active_only": {
      "type": "boolean",
      "description": "Keep only natural events that are still active (not closed)."
    },
    "limit": {
      "type": "number",
      "description": "Cap each hazard list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_military_posture

Theater posture assessment and military risk scores.

Parameters5

theater	string	optional	Filter to one theater by id (case-insensitive substring, e.g. "iran", "taiwan", "baltic", "korea").
posture_level	string	optional	Filter to a single posture level.
limit	number	optional	Cap the theaters list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "theater": {
      "type": "string",
      "description": "Filter to one theater by id (case-insensitive substring, e.g. \"iran\", \"taiwan\", \"baltic\", \"korea\")."
    },
    "posture_level": {
      "type": "string",
      "description": "Filter to a single posture level."
    },
    "limit": {
      "type": "number",
      "description": "Cap the theaters list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_cyber_threats

Active cyber threat intelligence: malware IOCs (URLhaus, Feodotracker), CISA known exploited vulnerabilities, and active

Parameters6

threat_type	string	optional	Filter to one threat type (case-insensitive substring, e.g. "malware", "vulnerability", "c2").
min_severity	string	optional	Drop threats below this severity level.
country	string	optional	Filter to one ISO 3166-1 alpha-2 country code (many threats have no country and are dropped by this filter). Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
limit	number	optional	Cap the threat list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "threat_type": {
      "type": "string",
      "description": "Filter to one threat type (case-insensitive substring, e.g. \"malware\", \"vulnerability\", \"c2\")."
    },
    "min_severity": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "critical"
      ],
      "description": "Drop threats below this severity level."
    },
    "country": {
      "type": "string",
      "description": "Filter to one ISO 3166-1 alpha-2 country code (many threats have no country and are dropped by this filter). Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "limit": {
      "type": "number",
      "description": "Cap the threat list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_economic_data

China macro: official-only 12-series; 5 NBS/SAFE ingestible, PBoC/GACC unavailable, no proxies; see launchReady/status.

Parameters5

dataset	array	optional	Restrict the response to one or more sub-datasets. Omit for the full economic bundle.
country	string	optional	Filter the country-keyed datasets (fuel-prices, BIS DSR/property, economic calendar) to one ISO 3166-1 alpha-2 code. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
limit	number	optional	Cap each list dataset (calendar, spending, earnings) to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "fedfunds",
          "econ-calendar",
          "china-macro",
          "china-release-calendar",
          "fuel-prices",
          "ecb-fx-rates",
          "cbr-rates",
          "yield-curve-eu",
          "spending",
          "earnings-calendar",
          "cot",
          "dsr",
          "property-residential",
          "property-commercial"
        ]
      },
      "description": "Restrict the response to one or more sub-datasets. Omit for the full economic bundle."
    },
    "country": {
      "type": "string",
      "description": "Filter the country-keyed datasets (fuel-prices, BIS DSR/property, economic calendar) to one ISO 3166-1 alpha-2 code. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "limit": {
      "type": "number",
      "description": "Cap each list dataset (calendar, spending, earnings) to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_country_macro

Per-country macroeconomic indicators from IMF WEO (~210 countries, monthly cadence).

Parameters4

countries	array	optional	ISO 3166-1 alpha-2 country codes to keep across all four IMF datasets (e.g. ["US","DE","CN"]). Omit for all ~210 countries. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
limit	integer	optional	Cap each IMF dataset country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ISO 3166-1 alpha-2 country codes to keep across all four IMF datasets (e.g. [\"US\",\"DE\",\"CN\"]). Omit for all ~210 countries. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "limit": {
      "type": "integer",
      "minimum": 0,
      "description": "Cap each IMF dataset country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_eu_housing_cycle

Eurostat annual house price index (prc_hpi_a, base 2015=100) for all 27 EU members plus EA20 and EU27_2020 aggregates.

Parameters4

countries	array	optional	Eurostat geo codes to keep — ISO 3166-1 alpha-2, but "EL" for Greece, plus aggregates "EA20" and "EU27_2020". Omit for all. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
limit	integer	optional	Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Eurostat geo codes to keep — ISO 3166-1 alpha-2, but \"EL\" for Greece, plus aggregates \"EA20\" and \"EU27_2020\". Omit for all. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "limit": {
      "type": "integer",
      "minimum": 0,
      "description": "Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_eu_quarterly_gov_debt

Eurostat quarterly general government gross debt (gov_10q_ggdebt, %GDP) for all 27 EU members plus EA20 and EU27_2020 ag

Parameters4

countries	array	optional	Eurostat geo codes to keep — ISO 3166-1 alpha-2, but "EL" for Greece, plus aggregates "EA20" and "EU27_2020". Omit for all. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
limit	integer	optional	Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Eurostat geo codes to keep — ISO 3166-1 alpha-2, but \"EL\" for Greece, plus aggregates \"EA20\" and \"EU27_2020\". Omit for all. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "limit": {
      "type": "integer",
      "minimum": 0,
      "description": "Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_eu_industrial_production

Eurostat monthly industrial production index (sts_inpr_m, NACE B-D industry excl.

Parameters4

countries	array	optional	Eurostat geo codes to keep — ISO 3166-1 alpha-2, but "EL" for Greece, plus aggregates "EA20" and "EU27_2020". Omit for all. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
limit	integer	optional	Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Eurostat geo codes to keep — ISO 3166-1 alpha-2, but \"EL\" for Greece, plus aggregates \"EA20\" and \"EU27_2020\". Omit for all. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "limit": {
      "type": "integer",
      "minimum": 0,
      "description": "Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_prediction_markets

Prediction markets: geopolitical/elections, tagged tech (AI/crypto/science), finance/economics or untagged fallback.

Parameters6

category	string	optional	Restrict to one market category bucket. Omit for all three. Finance also owns untagged non-geopolitical records.
query	string	optional	Keep only markets whose title contains this text (case-insensitive).
source	string	optional	Filter to one prediction-market source. Kalshi currently provides no classifier tags, so source=kalshi with category=tech returns no records.
limit	number	optional	Cap each category bucket to at most this many markets (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "geopolitical",
        "tech",
        "finance"
      ],
      "description": "Restrict to one market category bucket. Omit for all three. Finance also owns untagged non-geopolitical records."
    },
    "query": {
      "type": "string",
      "description": "Keep only markets whose title contains this text (case-insensitive)."
    },
    "source": {
      "type": "string",
      "enum": [
        "kalshi",
        "polymarket"
      ],
      "description": "Filter to one prediction-market source. Kalshi currently provides no classifier tags, so source=kalshi with category=tech returns no records."
    },
    "limit": {
      "type": "number",
      "description": "Cap each category bucket to at most this many markets (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_sanctions_data

OFAC SDN sanctioned entities list and sanctions pressure scores by country.

Parameters6

country	string	optional	Filter sanctioned entities and pressure scores to one ISO 3166-1 alpha-2 country code. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
entity_type	string	optional	Filter to one entity type (case-insensitive substring, e.g. "vessel", "aircraft", "person", "entity").
query	string	optional	Keep only sanctioned entities whose name contains this text (case-insensitive).
limit	number	optional	Cap the entity list and recent pressure entries to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Filter sanctioned entities and pressure scores to one ISO 3166-1 alpha-2 country code. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "entity_type": {
      "type": "string",
      "description": "Filter to one entity type (case-insensitive substring, e.g. \"vessel\", \"aircraft\", \"person\", \"entity\")."
    },
    "query": {
      "type": "string",
      "description": "Keep only sanctioned entities whose name contains this text (case-insensitive)."
    },
    "limit": {
      "type": "number",
      "description": "Cap the entity list and recent pressure entries to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_displacement_data

Refugee and IDP counts by country (UNHCR annual data).

Parameters4

countries	array	optional	Country names, ISO alpha-2, or alpha-3 codes to keep (e.g. ["Syria","UA","AFG"]). Matches both per-country totals and origin/asylum flows. Omit for all. Unresolved inputs return Invalid params.
limit	number	optional	Cap the per-country and top-flow lists to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Country names, ISO alpha-2, or alpha-3 codes to keep (e.g. [\"Syria\",\"UA\",\"AFG\"]). Matches both per-country totals and origin/asylum flows. Omit for all. Unresolved inputs return Invalid params."
    },
    "limit": {
      "type": "number",
      "description": "Cap the per-country and top-flow lists to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_health_signals

Active disease outbreaks (WHO/ECDC etc.) and global air-quality station readings (OpenAQ/WAQI PM2.5).

Parameters7

signal_type	array	optional	Restrict to disease outbreaks, air-quality stations, or both. Omit for both.
country	string	optional	Filter outbreaks and air-quality stations to one ISO 3166-1 alpha-2 country code. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
disease	string	optional	Keep only outbreaks whose disease name contains this text (case-insensitive).
min_aqi	number	optional	Drop air-quality stations below this AQI value.
limit	number	optional	Cap the outbreak and station lists to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "signal_type": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "outbreaks",
          "air-quality"
        ]
      },
      "description": "Restrict to disease outbreaks, air-quality stations, or both. Omit for both."
    },
    "country": {
      "type": "string",
      "description": "Filter outbreaks and air-quality stations to one ISO 3166-1 alpha-2 country code. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "disease": {
      "type": "string",
      "description": "Keep only outbreaks whose disease name contains this text (case-insensitive)."
    },
    "min_aqi": {
      "type": "number",
      "description": "Drop air-quality stations below this AQI value."
    },
    "limit": {
      "type": "number",
      "description": "Cap the outbreak and station lists to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_energy_intelligence

Energy supply, prices, storage, disruptions, and policy: EIA petroleum stocks, electricity prices (Ember), gas storage (

Parameters5

dataset	array	optional	Restrict the response to one or more energy sub-datasets. Omit for the full bundle.
country	string	optional	Filter the country-keyed datasets (Ember electricity mix, gas storage, fuel shortages, energy disruptions, fossil-share) to one ISO 3166-1 alpha-2 code. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
limit	number	optional	Cap each list-bearing energy slice (crisis-policies, electricity regions, gas-storage countries, World Bank renewable history/regions) to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "eia-petroleum",
          "electricity",
          "ember",
          "gas-storage",
          "fuel-shortages",
          "disruptions",
          "crisis-policies",
          "fossil-share",
          "renewable"
        ]
      },
      "description": "Restrict the response to one or more energy sub-datasets. Omit for the full bundle."
    },
    "country": {
      "type": "string",
      "description": "Filter the country-keyed datasets (Ember electricity mix, gas storage, fuel shortages, energy disruptions, fossil-share) to one ISO 3166-1 alpha-2 code. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "limit": {
      "type": "number",
      "description": "Cap each list-bearing energy slice (crisis-policies, electricity regions, gas-storage countries, World Bank renewable history/regions) to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_climate_data

Climate intelligence: temperature/precipitation anomalies (vs 30-year WMO normals), climate-relevant disaster alerts (Re

Parameters5

dataset	array	optional	Restrict the response to one or more climate sub-datasets. Omit for the full bundle.
country	string	optional	Filter the country-tagged datasets (climate disasters, air-quality stations) to one ISO 3166-1 alpha-2 code. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
limit	number	optional	Cap each list dataset (anomalies, disasters, stations, news, alerts) to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "anomalies",
          "disasters",
          "co2-monitoring",
          "air-quality",
          "ocean-ice",
          "news-intelligence",
          "alerts"
        ]
      },
      "description": "Restrict the response to one or more climate sub-datasets. Omit for the full bundle."
    },
    "country": {
      "type": "string",
      "description": "Filter the country-tagged datasets (climate disasters, air-quality stations) to one ISO 3166-1 alpha-2 code. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "limit": {
      "type": "number",
      "description": "Cap each list dataset (anomalies, disasters, stations, news, alerts) to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_imd_cyclone_marine

Bounded India Meteorological Department cyclone tracks, forecast wind radii, cones of uncertainty, and official port / s

Parameters4

dataset	array	optional	Restrict to cyclone tracks/wind/cones, port warnings, or sea-area/coastal bulletins. Omit for the full snapshot. coverageState and per-product health are always returned.
limit	number	optional	Cap each product list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "cyclone",
          "port",
          "marine"
        ]
      },
      "description": "Restrict to cyclone tracks/wind/cones, port warnings, or sea-area/coastal bulletins. Omit for the full snapshot. coverageState and per-product health are always returned."
    },
    "limit": {
      "type": "number",
      "description": "Cap each product list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_infrastructure_status

Internet infrastructure health: Cloudflare Radar outages and service status for major cloud providers and internet servi

Parameters5

country	string	optional	Filter to one country by name (case-insensitive substring).
severity	string	optional	Filter to one outage severity (case-insensitive substring).
limit	number	optional	Cap the outage list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Filter to one country by name (case-insensitive substring)."
    },
    "severity": {
      "type": "string",
      "description": "Filter to one outage severity (case-insensitive substring)."
    },
    "limit": {
      "type": "number",
      "description": "Cap the outage list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_supply_chain_data

Dry bulk shipping stress index, customs revenue flows, and COMTRADE bilateral trade data.

Parameters6

dataset	array	optional	Restrict the response to one or more sub-datasets (dry-bulk shipping stress / customs revenue / COMTRADE flows). Omit for all.
commodity	string	optional	Filter COMTRADE flows to one commodity — matches the HS code exactly or the commodity description by substring (e.g. "2709" or "crude").
reporter	string	optional	Filter COMTRADE flows to one reporter by numeric reporter code or reporter name (e.g. "156" or "China").
limit	number	optional	Cap each list dataset (carriers, months, flows) to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "shipping_stress",
          "customs-revenue",
          "flows"
        ]
      },
      "description": "Restrict the response to one or more sub-datasets (dry-bulk shipping stress / customs revenue / COMTRADE flows). Omit for all."
    },
    "commodity": {
      "type": "string",
      "description": "Filter COMTRADE flows to one commodity — matches the HS code exactly or the commodity description by substring (e.g. \"2709\" or \"crude\")."
    },
    "reporter": {
      "type": "string",
      "description": "Filter COMTRADE flows to one reporter by numeric reporter code or reporter name (e.g. \"156\" or \"China\")."
    },
    "limit": {
      "type": "number",
      "description": "Cap each list dataset (carriers, months, flows) to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_tariff_trends

Global trade and pricing indicators: US tariff trends (HTS-coded), BigMac index, FAO Food Price Index, and per-country n

Parameters5

dataset	array	optional	Restrict the response to one or more sub-datasets. Omit for the full bundle.
country	string	optional	Filter the per-country datasets to one ISO 3166-1 alpha-2 country code (e.g. "US"). It is translated to alpha-3 internally for the national-debt dataset; passing an alpha-3 code directly also works. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params.
limit	number	optional	Cap each list dataset (tariff datapoints, BigMac countries, debt entries) to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "tariffs",
          "bigmac",
          "fao-ffpi",
          "national-debt"
        ]
      },
      "description": "Restrict the response to one or more sub-datasets. Omit for the full bundle."
    },
    "country": {
      "type": "string",
      "description": "Filter the per-country datasets to one ISO 3166-1 alpha-2 country code (e.g. \"US\"). It is translated to alpha-3 internally for the national-debt dataset; passing an alpha-3 code directly also works. Country names and alpha-3 codes are accepted; unresolved inputs return Invalid params."
    },
    "limit": {
      "type": "number",
      "description": "Cap each list dataset (tariff datapoints, BigMac countries, debt entries) to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_chokepoint_status

Live maritime chokepoint status: per-chokepoint vessel transit counts (10-min cadence), rolling transit summaries, per-p

Parameters5

chokepoint	string	optional	Filter to one chokepoint — matches by case-insensitive substring across the differing identifiers used by each dataset (e.g. "hormuz" matches "hormuz_strait", "Strait of Hormuz").
dataset	array	optional	Restrict the response to one or more sub-datasets. Omit for the full bundle.
limit	number	optional	Cap the chokepoint-baselines list and the _countries ISO2 index to at most this many items (default 30, pass 0 for no cap). Keyed-object maps (transit-summaries, chokepoint_transits, ref, chokepoint-flows) are intentionally not capped — use the `chokepoint` filter instead.
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "chokepoint": {
      "type": "string",
      "description": "Filter to one chokepoint — matches by case-insensitive substring across the differing identifiers used by each dataset (e.g. \"hormuz\" matches \"hormuz_strait\", \"Strait of Hormuz\")."
    },
    "dataset": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "transit-summaries",
          "chokepoint_transits",
          "_countries",
          "chokepoint-baselines",
          "ref",
          "chokepoint-flows"
        ]
      },
      "description": "Restrict the response to one or more sub-datasets. Omit for the full bundle."
    },
    "limit": {
      "type": "number",
      "description": "Cap the chokepoint-baselines list and the _countries ISO2 index to at most this many items (default 30, pass 0 for no cap). Keyed-object maps (transit-summaries, chokepoint_transits, ref, chokepoint-flows) are intentionally not capped — use the `chokepoint` filter instead."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_positive_events

Positive geopolitical events: diplomatic agreements, humanitarian aid, development milestones, and peace initiatives wor

Parameters4

category	string	optional	Filter to one positive-event category.
limit	number	optional	Cap the event list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "science-health",
        "nature-wildlife",
        "climate-wins",
        "innovation-tech",
        "humanity-kindness",
        "culture-community"
      ],
      "description": "Filter to one positive-event category."
    },
    "limit": {
      "type": "number",
      "description": "Cap the event list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_radiation_data

Radiation observation levels from global monitoring stations.

Parameters5

country	string	optional	Filter to one country by name (case-insensitive substring).
anomalous_only	boolean	optional	Drop observations with severity "normal" — keep only elevated/spike readings.
limit	number	optional	Cap the observation list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Filter to one country by name (case-insensitive substring)."
    },
    "anomalous_only": {
      "type": "boolean",
      "description": "Drop observations with severity \"normal\" — keep only elevated/spike readings."
    },
    "limit": {
      "type": "number",
      "description": "Cap the observation list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_research_signals

Tech and research event signals: emerging technology events bootstrap data from curated research feeds.

Parameters5

type	string	optional	Filter to one tech-event type.
source	string	optional	Filter to one source feed (e.g. "techmeme", "dev.events", "curated").
limit	number	optional	Cap the event list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "conference",
        "earnings",
        "ipo",
        "other"
      ],
      "description": "Filter to one tech-event type."
    },
    "source": {
      "type": "string",
      "description": "Filter to one source feed (e.g. \"techmeme\", \"dev.events\", \"curated\")."
    },
    "limit": {
      "type": "number",
      "description": "Cap the event list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_forecast_predictions

AI-generated geopolitical and economic forecasts from WorldMonitor's predictive models.

Parameters5

domain	string	optional	Filter to one forecast domain (exact, case-insensitive — e.g. "shipping", "energy", "macro").
region	string	optional	Filter to one region/theater (case-insensitive substring).
limit	number	optional	Cap the forecast list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Filter to one forecast domain (exact, case-insensitive — e.g. \"shipping\", \"energy\", \"macro\")."
    },
    "region": {
      "type": "string",
      "description": "Filter to one region/theater (case-insensitive substring)."
    },
    "limit": {
      "type": "number",
      "description": "Cap the forecast list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_forecast_scorecard

Forecast resolution scorecard with calibration, Brier/log score, domain and generation-origin breakdowns, and pending/ju

Parameters2

summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_social_velocity

Reddit geopolitical social velocity: top posts from worldnews, geopolitics, and related subreddits with engagement score

Parameters4

subreddit	string	optional	Filter to one subreddit (e.g. "worldnews", "geopolitics").
limit	number	optional	Cap the post list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "subreddit": {
      "type": "string",
      "description": "Filter to one subreddit (e.g. \"worldnews\", \"geopolitics\")."
    },
    "limit": {
      "type": "number",
      "description": "Cap the post list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_temporal_anomalies

Temporal anomaly watch: current event counts vs day-of-week and seasonal baselines, scored by z-score severity.

Parameters6

type	string	optional	Filter to one tracked stream type (e.g. "news", "satellite_fires"); see trackedTypes in the response for what is currently baselined.
region	string	optional	Filter to one region label (case-insensitive exact match).
min_severity	string	optional	Drop anomalies below this severity band.
limit	number	optional	Cap the anomaly list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Filter to one tracked stream type (e.g. \"news\", \"satellite_fires\"); see trackedTypes in the response for what is currently baselined."
    },
    "region": {
      "type": "string",
      "description": "Filter to one region label (case-insensitive exact match)."
    },
    "min_severity": {
      "type": "string",
      "enum": [
        "medium",
        "high",
        "critical"
      ],
      "description": "Drop anomalies below this severity band."
    },
    "limit": {
      "type": "number",
      "description": "Cap the anomaly list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_test_site_seismicity

Nuclear test-site seismic monitor: USGS earthquakes near known test sites scored for proliferation concern.

Parameters5

site	string	optional	Filter to one test site by name substring (e.g. "Punggye", "Lop Nur", case-insensitive).
min_concern	string	optional	Drop events below this concern band.
limit	number	optional	Cap the event list to at most this many items (default 30, pass 0 for no cap).
summary	boolean	optional	Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "description": "Filter to one test site by name substring (e.g. \"Punggye\", \"Lop Nur\", case-insensitive)."
    },
    "min_concern": {
      "type": "string",
      "enum": [
        "low",
        "moderate",
        "elevated",
        "critical"
      ],
      "description": "Drop events below this concern band."
    },
    "limit": {
      "type": "number",
      "description": "Cap the event list to at most this many items (default 30, pass 0 for no cap)."
    },
    "summary": {
      "type": "boolean",
      "description": "Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_defense_industrial_base

Return one country's latest World Bank military-capacity indicators and SIPRI-derived five-year arms-supplier shares and

Parameters2

country_code	string	required	ISO 3166-1 alpha-2 country code, such as UA, DE, or IN.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, such as UA, DE, or IN."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "country_code"
  ]
}

get_china_decision_signals

Return the bounded six-domain China decision-signal snapshot used by the public country summary.

Parameters1

jmespath

string

optional

Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_procurement_opportunities

Search open global public-procurement opportunities through the canonical Pro route.

Parameters12

country	string	optional	One ISO 3166-1 alpha-2 country code.
countries	array	optional	Additional ISO 3166-1 alpha-2 country codes. Combined with country.
source	string	optional	Official source adapter, such as sam, ted, contracts-finder, canada-buys, gets, or world-bank.
query	string	optional	Case-insensitive text search across procurement titles and descriptions.
buyer	string	optional	Case-insensitive buyer or contracting-authority text.
deadline_from	string	optional	Include deadlines on or after this ISO-8601 timestamp.
deadline_to	string	optional	Include deadlines on or before this ISO-8601 timestamp.
sort	string	optional	Result ordering. Defaults to newest.
min_automation_score	integer	optional	Optional positive keyword-relevance threshold. Non-integer or non-positive values are ignored; the canonical route clamps values above 100. This is not bidding-eligibility evidence.
page_size	integer	optional	Records per call. Defaults to 10; capped at 25 to protect agent context.
cursor	string	optional	Opaque nextCursor from the prior result; keep the same filters and sort when continuing.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "One ISO 3166-1 alpha-2 country code."
    },
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Additional ISO 3166-1 alpha-2 country codes. Combined with country."
    },
    "source": {
      "type": "string",
      "description": "Official source adapter, such as sam, ted, contracts-finder, canada-buys, gets, or world-bank."
    },
    "query": {
      "type": "string",
      "description": "Case-insensitive text search across procurement titles and descriptions."
    },
    "buyer": {
      "type": "string",
      "description": "Case-insensitive buyer or contracting-authority text."
    },
    "deadline_from": {
      "type": "string",
      "description": "Include deadlines on or after this ISO-8601 timestamp."
    },
    "deadline_to": {
      "type": "string",
      "description": "Include deadlines on or before this ISO-8601 timestamp."
    },
    "sort": {
      "type": "string",
      "enum": [
        "newest",
        "closing_soon",
        "estimated_value",
        "relevance"
      ],
      "description": "Result ordering. Defaults to newest."
    },
    "min_automation_score": {
      "type": "integer",
      "minimum": 1,
      "description": "Optional positive keyword-relevance threshold. Non-integer or non-positive values are ignored; the canonical route clamps values above 100. This is not bidding-eligibility evidence."
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Records per call. Defaults to 10; capped at 25 to protect agent context."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque nextCursor from the prior result; keep the same filters and sort when continuing."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_wto_trade_flows

WTO merchandise trade flows for one reporting country versus the World, over a configurable year window.

Parameters3

reporter	string	optional	WTO reporting country as a 3-digit UN M49 code (e.g. "840" = United States). Defaults to "840". The only partner served is the World ("000"); any other partner answers not_covered.
years	integer	optional	Number of years to look back from the most recent published year, inclusive of both endpoints (10 returns 11 calendar years). Defaults to 10; 30 is the full seeded window.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "reporter": {
      "type": "string",
      "pattern": "^[0-9]{3}$",
      "description": "WTO reporting country as a 3-digit UN M49 code (e.g. \"840\" = United States). Defaults to \"840\". The only partner served is the World (\"000\"); any other partner answers not_covered."
    },
    "years": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Number of years to look back from the most recent published year, inclusive of both endpoints (10 returns 11 calendar years). Defaults to 10; 30 is the full seeded window."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_world_brief

Citation-grounded world intelligence brief from the same precomputed news:insights:v1 snapshot used by the dashboard.

Parameters2

geo_context	string	optional	Deprecated compatibility field; the precomputed global snapshot is not regenerated or refocused per request.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "geo_context": {
      "type": "string",
      "description": "Deprecated compatibility field; the precomputed global snapshot is not regenerated or refocused per request."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_country_brief

AI-generated per-country intelligence brief.

Parameters4

country_code	string	required	ISO 3166-1 alpha-2 code (e.g. "IQ"), alpha-3 code ("IRQ"), or English country name ("Iraq")
framework	string	optional	Optional analytical framework instructions to shape the analysis lens (e.g. Ray Dalio debt cycle, PMESII-PT)
allow_stale	boolean	optional	Ground the brief on a retained (stale) news digest when the live rebuild has failed. Defaults to false, which drops the stale grounding and returns an ungrounded brief rather than failing; time-sensitive automated decisions should leave this disabled. Retained content is at most six hours old.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code (e.g. \"IQ\"), alpha-3 code (\"IRQ\"), or English country name (\"Iraq\")"
    },
    "framework": {
      "type": "string",
      "description": "Optional analytical framework instructions to shape the analysis lens (e.g. Ray Dalio debt cycle, PMESII-PT)"
    },
    "allow_stale": {
      "type": "boolean",
      "description": "Ground the brief on a retained (stale) news digest when the live rebuild has failed. Defaults to false, which drops the stale grounding and returns an ungrounded brief rather than failing; time-sensitive automated decisions should leave this disabled. Retained content is at most six hours old."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "country_code"
  ]
}

get_country_risk

Structured risk intelligence for a specific country: the Composite Instability Index at cii.combinedScore (0-100), its f

Parameters2

country_code	string	required	ISO 3166-1 alpha-2 code (e.g. "IQ"), alpha-3 code ("IRQ"), or English country name ("Iraq")
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code (e.g. \"IQ\"), alpha-3 code (\"IRQ\"), or English country name (\"Iraq\")"
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "country_code"
  ]
}

get_country_coverage

The country panel's own coverage timeline: recent country-relevant headlines plus the clustered incident timeline the Wo

Parameters4

country_code	string	required	ISO 3166-1 alpha-2 code (e.g. "IQ"), alpha-3 code ("IRQ"), or English country name ("Iraq")
window_hours	integer	optional	Look-back window in hours. 0 or omitted means the default 168 (7 days), which is what the UI shows. The upstream coverage query is pinned to 7 days, so a larger value is rejected rather than silently returning the same events.
limit	integer	optional	Maximum timeline events to return, keeping the most recent. 0 or omitted means the default 200.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code (e.g. \"IQ\"), alpha-3 code (\"IRQ\"), or English country name (\"Iraq\")"
    },
    "window_hours": {
      "type": "integer",
      "minimum": 0,
      "maximum": 168,
      "description": "Look-back window in hours. 0 or omitted means the default 168 (7 days), which is what the UI shows. The upstream coverage query is pinned to 7 days, so a larger value is rejected rather than silently returning the same events."
    },
    "limit": {
      "type": "integer",
      "minimum": 0,
      "maximum": 500,
      "description": "Maximum timeline events to return, keeping the most recent. 0 or omitted means the default 200."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "country_code"
  ]
}

list_x_feed

Curated public news-account posts from monitored X accounts.

Parameters4

limit	number	optional	Maximum posts to return (1-200, default 50)
topic	string	optional	Optional topic filter such as breaking, conflict, geopolitics, cyber
account	string	optional	Optional account handle without @
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum posts to return (1-200, default 50)"
    },
    "topic": {
      "type": "string",
      "description": "Optional topic filter such as breaking, conflict, geopolitics, cyber"
    },
    "account": {
      "type": "string",
      "description": "Optional account handle without @"
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_food_stocks

USDA PSD cereal stocks-to-use by marketing year.

Parameters3

country_code	string	required	ISO 3166-1 alpha-2 country code (e.g. "EG") or "WORLD" for the global balance sheet.
commodity	string	optional	Optional commodity slug: wheat, corn, rice, soybeans, barley, palmOil. Note palmOil is camelCase; the rest are lowercase. Omit for all six.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code (e.g. \"EG\") or \"WORLD\" for the global balance sheet."
    },
    "commodity": {
      "type": "string",
      "description": "Optional commodity slug: wheat, corn, rice, soybeans, barley, palmOil. Note palmOil is camelCase; the rest are lowercase. Omit for all six."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "country_code"
  ]
}

get_demographics_capability

Country demographics capability observations from UN WPP, World Bank/UNESCO UIS, and ILOSTAT.

Parameters2

country_code	string	required	Required ISO 3166-1 alpha-2 country code (for example "DE"). Case-insensitive.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "Required ISO 3166-1 alpha-2 country code (for example \"DE\"). Case-insensitive."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "country_code"
  ]
}

get_resilience_indicators

Explain one country's resilience score across all 72 registered indicators.

Parameters2

country_code	string	required	Required ISO 3166-1 alpha-2 country code (for example "DE"). Case-insensitive.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "Required ISO 3166-1 alpha-2 country code (for example \"DE\"). Case-insensitive."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "country_code"
  ]
}

get_five_factor_scorecard

Return the frozen v1 food, energy, demographics, technology, and defense scorecard for exactly one country or bloc.

Parameters4

country_code	string	optional	ISO 3166-1 alpha-2 country code. Mutually exclusive with preset and members.
preset	string	optional	Official bloc preset. Mutually exclusive with country_code and members.
members	array	optional	Custom bloc of 2-30 unique uppercase ISO-2 member codes. Mutually exclusive with country_code and preset.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code. Mutually exclusive with preset and members."
    },
    "preset": {
      "type": "string",
      "enum": [
        "USMCA",
        "EU27",
        "BRICS",
        "GCC",
        "ASEAN",
        "NATO"
      ],
      "description": "Official bloc preset. Mutually exclusive with country_code and members."
    },
    "members": {
      "type": "array",
      "minItems": 2,
      "maxItems": 30,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "pattern": "^[A-Z]{2}$"
      },
      "description": "Custom bloc of 2-30 unique uppercase ISO-2 member codes. Mutually exclusive with country_code and preset."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [],
  "oneOf": [
    {
      "required": [
        "country_code"
      ]
    },
    {
      "required": [
        "preset"
      ]
    },
    {
      "required": [
        "members"
      ]
    }
  ]
}

list_five_factor_scorecards

List compact v1 scorecards; read hasScore first because false makes numeric zero an insufficient-data placeholder.

Parameters1

jmespath

string

optional

Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_consumer_prices

Per-country consumer-prices intelligence: 30-day overview, category-level inflation, retailer spread (essentials basket)

Parameters2

country_code	string	required	ISO 3166-1 alpha-2 country code. Currently supported: AE (case-insensitive).
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code. Currently supported: AE (case-insensitive)."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "country_code"
  ]
}

get_airspace

Live ADS-B aircraft over a country.

Parameters3

country_code	string	required	ISO 3166-1 alpha-2 code (e.g. "IQ"), alpha-3 code ("IRQ"), or English country name ("Iraq")
type	string	optional	Filter: all flights (default), civilian only, or military only
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code (e.g. \"IQ\"), alpha-3 code (\"IRQ\"), or English country name (\"Iraq\")"
    },
    "type": {
      "type": "string",
      "enum": [
        "all",
        "civilian",
        "military"
      ],
      "description": "Filter: all flights (default), civilian only, or military only"
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "country_code"
  ]
}

get_maritime_activity

Live vessel traffic and maritime disruptions for a country's waters.

Parameters2

country_code	string	required	ISO 3166-1 alpha-2 code (e.g. "IQ"), alpha-3 code ("IRQ"), or English country name ("Iraq")
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code (e.g. \"IQ\"), alpha-3 code (\"IRQ\"), or English country name (\"Iraq\")"
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "country_code"
  ]
}

analyze_situation

AI geopolitical situation analysis (DeductionPanel).

Parameters4

query	string	required	The question or situation to analyze, e.g. "What are the implications of the Taiwan strait escalation for semiconductor supply chains?"
context	string	optional	Optional additional geo-political context to include in the analysis
framework	string	optional	Optional analytical framework instructions to shape the analysis lens (e.g. Ray Dalio debt cycle, PMESII-PT, Porter's Five Forces)
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The question or situation to analyze, e.g. \"What are the implications of the Taiwan strait escalation for semiconductor supply chains?\""
    },
    "context": {
      "type": "string",
      "description": "Optional additional geo-political context to include in the analysis"
    },
    "framework": {
      "type": "string",
      "description": "Optional analytical framework instructions to shape the analysis lens (e.g. Ray Dalio debt cycle, PMESII-PT, Porter's Five Forces)"
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "query"
  ]
}

generate_forecasts

Generate live AI geopolitical and economic forecasts.

Parameters3

domain	string	optional	Forecast domain: "geopolitical", "economic", "military", "climate", or empty for all domains
region	string	optional	Geographic region filter, e.g. "Middle East", "Europe", "Asia Pacific", or empty for global
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Forecast domain: \"geopolitical\", \"economic\", \"military\", \"climate\", or empty for all domains"
    },
    "region": {
      "type": "string",
      "description": "Geographic region filter, e.g. \"Middle East\", \"Europe\", \"Asia Pacific\", or empty for global"
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

search_flights

Search Google Flights for real-time flight options between two airports on a specific date.

Parameters9

origin	string	required	IATA code for the departure airport, e.g. "JFK"
destination	string	required	IATA code for the arrival airport, e.g. "LHR"
departure_date	string	required	Departure date in YYYY-MM-DD format
return_date	string	optional	Return date in YYYY-MM-DD format for round trips (optional)
cabin_class	string	optional	Cabin class: "economy", "premium_economy", "business", or "first" (optional, default economy)
max_stops	string	optional	Max stops: "0" or "non_stop" for nonstop, "1" or "one_stop" for max one stop, or omit for any (optional)
passengers	number	optional	Number of passengers (1-9, default 1)
sort_by	string	optional	Sort order: "price" (cheapest), "duration", "departure", or "arrival" (optional)
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "IATA code for the departure airport, e.g. \"JFK\""
    },
    "destination": {
      "type": "string",
      "description": "IATA code for the arrival airport, e.g. \"LHR\""
    },
    "departure_date": {
      "type": "string",
      "description": "Departure date in YYYY-MM-DD format"
    },
    "return_date": {
      "type": "string",
      "description": "Return date in YYYY-MM-DD format for round trips (optional)"
    },
    "cabin_class": {
      "type": "string",
      "description": "Cabin class: \"economy\", \"premium_economy\", \"business\", or \"first\" (optional, default economy)"
    },
    "max_stops": {
      "type": "string",
      "description": "Max stops: \"0\" or \"non_stop\" for nonstop, \"1\" or \"one_stop\" for max one stop, or omit for any (optional)"
    },
    "passengers": {
      "type": "number",
      "description": "Number of passengers (1-9, default 1)"
    },
    "sort_by": {
      "type": "string",
      "description": "Sort order: \"price\" (cheapest), \"duration\", \"departure\", or \"arrival\" (optional)"
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "origin",
    "destination",
    "departure_date"
  ]
}

search_flight_prices_by_date

Search Google Flights date-grid pricing across a date range.

Parameters10

origin	string	required	IATA code for the departure airport, e.g. "JFK"
destination	string	required	IATA code for the arrival airport, e.g. "LHR"
start_date	string	required	Start of the date range in YYYY-MM-DD format
end_date	string	required	End of the date range in YYYY-MM-DD format
is_round_trip	boolean	optional	Whether to search round-trip prices (default false). Requires trip_duration when true.
trip_duration	number	optional	Trip duration in days — required when is_round_trip is true (e.g. 7 for a one-week trip)
cabin_class	string	optional	Cabin class: "economy", "premium_economy", "business", or "first" (optional, default economy)
passengers	number	optional	Number of passengers (1-9, default 1)
sort_by_price	boolean	optional	Sort results by price ascending (default false, sorts by date)
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "IATA code for the departure airport, e.g. \"JFK\""
    },
    "destination": {
      "type": "string",
      "description": "IATA code for the arrival airport, e.g. \"LHR\""
    },
    "start_date": {
      "type": "string",
      "description": "Start of the date range in YYYY-MM-DD format"
    },
    "end_date": {
      "type": "string",
      "description": "End of the date range in YYYY-MM-DD format"
    },
    "is_round_trip": {
      "type": "boolean",
      "description": "Whether to search round-trip prices (default false). Requires trip_duration when true."
    },
    "trip_duration": {
      "type": "number",
      "description": "Trip duration in days — required when is_round_trip is true (e.g. 7 for a one-week trip)"
    },
    "cabin_class": {
      "type": "string",
      "description": "Cabin class: \"economy\", \"premium_economy\", \"business\", or \"first\" (optional, default economy)"
    },
    "passengers": {
      "type": "number",
      "description": "Number of passengers (1-9, default 1)"
    },
    "sort_by_price": {
      "type": "boolean",
      "description": "Sort results by price ascending (default false, sorts by date)"
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "origin",
    "destination",
    "start_date",
    "end_date"
  ]
}

get_commodity_geo

Global mining sites with coordinates, operator, mineral type, and production status.

Parameters3

mineral	string	optional	Filter by mineral type (e.g. "Gold", "Copper", "Lithium")
country	string	optional	Filter by country name (e.g. "Australia", "Chile")
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "mineral": {
      "type": "string",
      "description": "Filter by mineral type (e.g. \"Gold\", \"Copper\", \"Lithium\")"
    },
    "country": {
      "type": "string",
      "description": "Filter by country name (e.g. \"Australia\", \"Chile\")"
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_mineral_production

Who mines and who refines a commodity, with country shares and HHI.

Parameters4

commodity	string	optional	Commodity id or label, e.g. "cobalt", "lithium", "ree"
iso2	string	optional	ISO 3166-1 alpha-2 producer filter, e.g. "CL"
stage	string	optional	Mine or refinery/smelter stage. Omit for both.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "commodity": {
      "type": "string",
      "description": "Commodity id or label, e.g. \"cobalt\", \"lithium\", \"ree\""
    },
    "iso2": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 producer filter, e.g. \"CL\""
    },
    "stage": {
      "type": "string",
      "enum": [
        "mine",
        "refinery"
      ],
      "description": "Mine or refinery/smelter stage. Omit for both."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_supply_vulnerabilities

An absent score means insufficient evidence, never zero risk.

Parameters2

country_code	string	required	ISO 3166-1 alpha-2 country code, such as AE, JP, or DE.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code, such as AE, JP, or DE."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "country_code"
  ]
}

get_chokepoint_dependencies

An absent score means insufficient coverage, never zero risk.

Parameters3

chokepoint_id	string	required	Canonical chokepoint id, such as hormuz_strait or malacca_strait.
page_size	integer	optional	Maximum dependencies. Defaults to 25.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "chokepoint_id": {
      "type": "string",
      "pattern": "^[a-z0-9_-]+$",
      "description": "Canonical chokepoint id, such as hormuz_strait or malacca_strait."
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum dependencies. Defaults to 25."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "chokepoint_id"
  ]
}

get_signal_convergence

Geographic signal convergence: grid cells where protests, military activity, naval movements, and earthquakes co-occur.

Parameters5

lat	number	optional	Latitude of the area of interest; requires lon and radius_km as well.
lon	number	optional	Longitude of the area of interest; requires lat and radius_km as well.
radius_km	number	optional	Positive radius in km around lat/lon to keep alerts for; requires lat and lon (maximum 20,000).
min_domains	number	optional	Distinct signal domains required per cell, 2-5 (default 3); 5 is a compatibility safety threshold that yields no alerts while four domains are ingested.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude of the area of interest; requires lon and radius_km as well."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude of the area of interest; requires lat and radius_km as well."
    },
    "radius_km": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 20000,
      "description": "Positive radius in km around lat/lon to keep alerts for; requires lat and lon (maximum 20,000)."
    },
    "min_domains": {
      "type": "number",
      "minimum": 2,
      "maximum": 5,
      "description": "Distinct signal domains required per cell, 2-5 (default 3); 5 is a compatibility safety threshold that yields no alerts while four domains are ingested."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_focal_points

Focal-point detection: entities where news coverage and live map signals converge, ranked by multi-signal score.

Parameters3

country_code	string	optional	Filter focal points to one country (ISO-2, alpha-3, or English name) and entities the registry relates to it. Countries outside the entity registry return an explicit coverage error.
limit	number	optional	Cap the focal point list (default 10, pass 0 for no cap).
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "description": "Filter focal points to one country (ISO-2, alpha-3, or English name) and entities the registry relates to it. Countries outside the entity registry return an explicit coverage error."
    },
    "limit": {
      "type": "number",
      "description": "Cap the focal point list (default 10, pass 0 for no cap)."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

simulate_infrastructure_cascade

Infrastructure cascade simulation: what fails downstream when a cable, chokepoint, pipeline, or port is disrupted.

Parameters3

source_id	string	optional	Node id to disrupt (see the no-argument catalog for valid ids).
disruption_level	number	optional	Initial failure severity between 0.1 and 1 (default 1).
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "source_id": {
      "type": "string",
      "description": "Node id to disrupt (see the no-argument catalog for valid ids)."
    },
    "disruption_level": {
      "type": "number",
      "description": "Initial failure severity between 0.1 and 1 (default 1)."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_military_surge

Military surge watch: theater aircraft postures, foreign-presence detections, and seeder-computed surge alerts.

Parameters2

theater	string	optional	Filter to one theater by id or name substring (case-insensitive).
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "theater": {
      "type": "string",
      "description": "Filter to one theater by id or name substring (case-insensitive)."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_population_exposure

Population exposure: estimated people within the impact radius of active earthquakes, wildfires, and conflict events.

Parameters7

mode	string	optional	events enriches live feeds (default); point takes lat/lon; countries lists the population table.
event_source	string	optional	Which event feeds to enrich in events mode (default all).
lat	number	optional	Latitude for point mode.
lon	number	optional	Longitude for point mode.
radius_km	number	optional	Radius in km for point mode (default 50, clamped to 1000).
limit	number	optional	Cap the enriched event list in events mode (default 20, pass 0 for no cap).
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "events",
        "point",
        "countries"
      ],
      "description": "events enriches live feeds (default); point takes lat/lon; countries lists the population table."
    },
    "event_source": {
      "type": "string",
      "enum": [
        "earthquakes",
        "wildfires",
        "conflicts",
        "all"
      ],
      "description": "Which event feeds to enrich in events mode (default all)."
    },
    "lat": {
      "type": "number",
      "description": "Latitude for point mode."
    },
    "lon": {
      "type": "number",
      "description": "Longitude for point mode."
    },
    "radius_km": {
      "type": "number",
      "description": "Radius in km for point mode (default 50, clamped to 1000)."
    },
    "limit": {
      "type": "number",
      "description": "Cap the enriched event list in events mode (default 20, pass 0 for no cap)."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_alert_digest

Cross-domain alert digest: everything that tripped a threshold today, in one rollup.

Parameters2

view	string	optional	today lists current threshold trips (default); weekly adds trend context.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "today",
        "weekly"
      ],
      "description": "today lists current threshold trips (default); weekly adds trend context."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_hotspot_escalation

Hotspot escalation scores: the 29 curated intelligence hotspots ranked by dynamic escalation on a 1-5 scale.

Parameters3

hotspot_id	string	optional	Return only this curated hotspot id (see any full response for the id list).
limit	number	optional	Cap the ranked hotspot list (default 29, the full curated set; pass 0 for no cap).
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "hotspot_id": {
      "type": "string",
      "description": "Return only this curated hotspot id (see any full response for the id list)."
    },
    "limit": {
      "type": "number",
      "description": "Cap the ranked hotspot list (default 29, the full curated set; pass 0 for no cap)."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

search_intel_history

Semantic search over WorldMonitor's accumulating store of past intelligence events (Pro), ranked by similarity.

Parameters7

query	string	required	Free-text search phrase, e.g. "artillery strikes near Kharkiv". Embedded with the same model the stored vectors were written under, so phrasing close to how an analyst would describe the event ranks best.
domain	string	optional	Restrict to one producing domain. Omit to search every domain.
country	string	optional	ISO 3166-1 alpha-2 country code, uppercase, e.g. "UA". Omit to search every country. Events not attributable to a single country are excluded when this is set.
from	number	optional	Earliest occurredAt to consider, Unix epoch milliseconds, inclusive. Omit for no lower bound.
to	number	optional	Latest occurredAt to consider, Unix epoch milliseconds, inclusive. Omit for no upper bound.
limit	integer	optional	Maximum matches to return. The route returns 16 when this is omitted and caps MCP responses at 16 to stay within the output budget.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 500,
      "description": "Free-text search phrase, e.g. \"artillery strikes near Kharkiv\". Embedded with the same model the stored vectors were written under, so phrasing close to how an analyst would describe the event ranks best."
    },
    "domain": {
      "type": "string",
      "enum": [
        "conflict",
        "military",
        "energy"
      ],
      "description": "Restrict to one producing domain. Omit to search every domain."
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase, e.g. \"UA\". Omit to search every country. Events not attributable to a single country are excluded when this is set."
    },
    "from": {
      "type": "number",
      "description": "Earliest occurredAt to consider, Unix epoch milliseconds, inclusive. Omit for no lower bound."
    },
    "to": {
      "type": "number",
      "description": "Latest occurredAt to consider, Unix epoch milliseconds, inclusive. Omit for no upper bound."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 16,
      "description": "Maximum matches to return. The route returns 16 when this is omitted and caps MCP responses at 16 to stay within the output budget."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "query"
  ]
}

get_intel_timeline

Reverse-chronological read of WorldMonitor's accumulating intelligence-event history for one domain or country (Pro).

Parameters6

domain	string	optional	Restrict to one producing domain. Required unless country is set.
country	string	optional	ISO 3166-1 alpha-2 country code, uppercase, e.g. "UA". Required unless domain is set. Supplying both narrows to their intersection.
from	number	optional	Earliest occurredAt to return, Unix epoch milliseconds, inclusive. Omit for no lower bound.
to	number	optional	Latest occurredAt to return, Unix epoch milliseconds, inclusive. Omit for no upper bound.
limit	integer	optional	Maximum events to return. The route returns 40 when this is omitted and caps MCP responses at 40 to stay within the output budget.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "enum": [
        "conflict",
        "military",
        "energy"
      ],
      "description": "Restrict to one producing domain. Required unless country is set."
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase, e.g. \"UA\". Required unless domain is set. Supplying both narrows to their intersection."
    },
    "from": {
      "type": "number",
      "description": "Earliest occurredAt to return, Unix epoch milliseconds, inclusive. Omit for no lower bound."
    },
    "to": {
      "type": "number",
      "description": "Latest occurredAt to return, Unix epoch milliseconds, inclusive. Omit for no upper bound."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "description": "Maximum events to return. The route returns 40 when this is omitted and caps MCP responses at 40 to stay within the output budget."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_similar_events

Historical precedents for a situation you describe, drawn from WorldMonitor's accumulating event store (Pro).

Parameters5

situation	string	required	Description of the situation to find precedents for, e.g. "a naval blockade closes a major grain export corridor for weeks". Longer than a search phrase on purpose — more context ranks better.
domain	string	optional	Restrict precedents to one producing domain. Omit to search every domain.
country	string	optional	ISO 3166-1 alpha-2 country code, uppercase, e.g. "EG". Omit to search every country — usually the right choice, since a precedent elsewhere is still a precedent.
limit	integer	optional	Maximum precedents to return. The route returns 8 when this is omitted and caps MCP responses at 8 to stay within the output budget.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "situation": {
      "type": "string",
      "minLength": 10,
      "maxLength": 1000,
      "description": "Description of the situation to find precedents for, e.g. \"a naval blockade closes a major grain export corridor for weeks\". Longer than a search phrase on purpose — more context ranks better."
    },
    "domain": {
      "type": "string",
      "enum": [
        "conflict",
        "military",
        "energy"
      ],
      "description": "Restrict precedents to one producing domain. Omit to search every domain."
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, uppercase, e.g. \"EG\". Omit to search every country — usually the right choice, since a precedent elsewhere is still a precedent."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "Maximum precedents to return. The route returns 8 when this is omitted and caps MCP responses at 8 to stay within the output budget."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "situation"
  ]
}

get_company_intelligence

Per-company corporate intelligence from SEC EDGAR and market data.

Parameters10

view	string	optional	Defaults to enrichment.
ticker	string	optional	Exchange ticker symbol, such as AAPL. Preferred company key for enrichment and signals.
name	string	optional	Company name fallback when no ticker is known; case-insensitive exact SEC title match only, and only when that title maps to a single CIK. Prefer ticker.
query	string	optional	filings-search only: full-text query. Required for that view.
forms	string	optional	filings-search only: comma-separated form filter, such as "8-K" or "10-K,10-Q".
start_date	string	optional	filings-search only: earliest filing date (YYYY-MM-DD).
end_date	string	optional	filings-search only: latest filing date (YYYY-MM-DD).
item_code	string	optional	material-events only: filter to one 8-K item code, such as "5.02".
limit	integer	optional	Result cap. Honored up to 25 for filings-search and up to 100 for material-events; a value above the view's own maximum is rejected rather than silently clamped. Ignored by the enrichment and signals views.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "enrichment",
        "signals",
        "filings-search",
        "material-events"
      ],
      "description": "Defaults to enrichment."
    },
    "ticker": {
      "type": "string",
      "description": "Exchange ticker symbol, such as AAPL. Preferred company key for enrichment and signals."
    },
    "name": {
      "type": "string",
      "description": "Company name fallback when no ticker is known; case-insensitive exact SEC title match only, and only when that title maps to a single CIK. Prefer ticker."
    },
    "query": {
      "type": "string",
      "description": "filings-search only: full-text query. Required for that view."
    },
    "forms": {
      "type": "string",
      "description": "filings-search only: comma-separated form filter, such as \"8-K\" or \"10-K,10-Q\"."
    },
    "start_date": {
      "type": "string",
      "description": "filings-search only: earliest filing date (YYYY-MM-DD)."
    },
    "end_date": {
      "type": "string",
      "description": "filings-search only: latest filing date (YYYY-MM-DD)."
    },
    "item_code": {
      "type": "string",
      "description": "material-events only: filter to one 8-K item code, such as \"5.02\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Result cap. Honored up to 25 for filings-search and up to 100 for material-events; a value above the view's own maximum is rejected rather than silently clamped. Ignored by the enrichment and signals views."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

describe_tool

Return the full uncompressed definition of one tool by name.

Parameters2

tool_name	string	required	Exact tool name from tools/list.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "tool_name": {
      "type": "string",
      "description": "Exact tool name from tools/list."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "tool_name"
  ]
}

classify_event

Classify a supplied news headline or short text into a threat category and severity via the enum-validated WorldMonitor

Parameters2

text	string	required	Headline or short excerpt to classify (1-500 characters). Longer input is rejected, not truncated.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 500,
      "description": "Headline or short excerpt to classify (1-500 characters). Longer input is rejected, not truncated."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": [
    "text"
  ]
}

extract_entities

Extract named entities deterministically — registry entities (companies, indices, commodities, crypto, sectors, countr

Parameters5

text	string	optional	Optional text to extract from (max 2048 characters; longer input is rejected). When omitted, the tool aggregates entities across recent headlines.
variant	string	optional	Headline digest variant used when text is omitted. Defaults to full; use tech for Tech dashboard categories.
category	string	optional	When text is omitted, Restrict to one category from the selected digest variant. full: politics, us, europe, middleeast, tech, ai, finance, commodities, gov, africa, latam, asia, energy, thinktanks, crisis, layoffs, intel; tech: tech, ai, startups, vcblogs, regionalStartups, unicorns, accelerators, security, policy, github, funding, cloud, layoffs, finance, dev, ipo, producthunt, hardware, outages. Echoed as `category` in the result; an unknown value yields headlineCount 0 and a `note` listing categories present in the current digest.
limit	integer	optional	Maximum entities per list. Defaults to 20.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 2048,
      "description": "Optional text to extract from (max 2048 characters; longer input is rejected). When omitted, the tool aggregates entities across recent headlines."
    },
    "variant": {
      "type": "string",
      "enum": [
        "full",
        "tech"
      ],
      "description": "Headline digest variant used when text is omitted. Defaults to full; use tech for Tech dashboard categories."
    },
    "category": {
      "type": "string",
      "enum": [
        "politics",
        "us",
        "europe",
        "middleeast",
        "tech",
        "ai",
        "finance",
        "commodities",
        "gov",
        "africa",
        "latam",
        "asia",
        "energy",
        "thinktanks",
        "crisis",
        "layoffs",
        "intel",
        "startups",
        "vcblogs",
        "regionalStartups",
        "unicorns",
        "accelerators",
        "security",
        "policy",
        "github",
        "funding",
        "cloud",
        "dev",
        "ipo",
        "producthunt",
        "hardware",
        "outages"
      ],
      "description": "When text is omitted, Restrict to one category from the selected digest variant. full: politics, us, europe, middleeast, tech, ai, finance, commodities, gov, africa, latam, asia, energy, thinktanks, crisis, layoffs, intel; tech: tech, ai, startups, vcblogs, regionalStartups, unicorns, accelerators, security, policy, github, funding, cloud, layoffs, finance, dev, ipo, producthunt, hardware, outages. Echoed as `category` in the result; an unknown value yields headlineCount 0 and a `note` listing categories present in the current digest."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Maximum entities per list. Defaults to 20."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_news_clusters

Current topic clusters over the live headline digest, computed with the same Jaccard clustering the dashboard uses.

Parameters6

limit	integer	optional	Maximum clusters returned. Defaults to 10.
min_sources	integer	optional	Only return clusters carrying at least this many DISTINCT sources (outlets), not merely this many member headlines. Defaults to 1.
variant	string	optional	Headline digest variant. Defaults to full; use tech for Tech dashboard categories.
category	string	optional	Restrict to one category from the selected digest variant. full: politics, us, europe, middleeast, tech, ai, finance, commodities, gov, africa, latam, asia, energy, thinktanks, crisis, layoffs, intel; tech: tech, ai, startups, vcblogs, regionalStartups, unicorns, accelerators, security, policy, github, funding, cloud, layoffs, finance, dev, ipo, producthunt, hardware, outages. Echoed as `category` in the result; an unknown value yields headlineCount 0 and a `note` listing categories present in the current digest.
query	string	optional	Keep only clusters whose primary headline or any member headline contains this text (case-insensitive substring). Filters the LIVE digest window only — not a historical index. Applied before limit, so a capped list is drawn from the matches.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Maximum clusters returned. Defaults to 10."
    },
    "min_sources": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Only return clusters carrying at least this many DISTINCT sources (outlets), not merely this many member headlines. Defaults to 1."
    },
    "variant": {
      "type": "string",
      "enum": [
        "full",
        "tech"
      ],
      "description": "Headline digest variant. Defaults to full; use tech for Tech dashboard categories."
    },
    "category": {
      "type": "string",
      "enum": [
        "politics",
        "us",
        "europe",
        "middleeast",
        "tech",
        "ai",
        "finance",
        "commodities",
        "gov",
        "africa",
        "latam",
        "asia",
        "energy",
        "thinktanks",
        "crisis",
        "layoffs",
        "intel",
        "startups",
        "vcblogs",
        "regionalStartups",
        "unicorns",
        "accelerators",
        "security",
        "policy",
        "github",
        "funding",
        "cloud",
        "dev",
        "ipo",
        "producthunt",
        "hardware",
        "outages"
      ],
      "description": "Restrict to one category from the selected digest variant. full: politics, us, europe, middleeast, tech, ai, finance, commodities, gov, africa, latam, asia, energy, thinktanks, crisis, layoffs, intel; tech: tech, ai, startups, vcblogs, regionalStartups, unicorns, accelerators, security, policy, github, funding, cloud, layoffs, finance, dev, ipo, producthunt, hardware, outages. Echoed as `category` in the result; an unknown value yields headlineCount 0 and a `note` listing categories present in the current digest."
    },
    "query": {
      "type": "string",
      "description": "Keep only clusters whose primary headline or any member headline contains this text (case-insensitive substring). Filters the LIVE digest window only — not a historical index. Applied before limit, so a capped list is drawn from the matches."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_keyword_spikes

Keyword/CVE/APT spikes vs baseline, each with sourceNames and {title, source, link}.

Parameters4

window_hours	integer	optional	Recent window to test for spikes. Defaults to 2.
min_count	integer	optional	Minimum recent-window story count for a term to spike. Defaults to 5.
limit	integer	optional	Maximum spikes returned. Defaults to 10.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "window_hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Recent window to test for spikes. Defaults to 2."
    },
    "min_count": {
      "type": "integer",
      "minimum": 2,
      "maximum": 20,
      "description": "Minimum recent-window story count for a term to spike. Defaults to 5."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Maximum spikes returned. Defaults to 10."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

get_sources

WorldMonitor's live source inventory, for deciding whether and how far to trust what the other tools return.

Parameters9

view	string	optional	summary (default) returns counts only and is small. providers enumerates upstream hosts; outlets enumerates named public source identities with tier and provenance.
kind	string	optional	providers view only: restrict to one kind — feed, structured, feed+structured, or operational-status.
country	string	optional	providers view only: restrict by publisher origin using a two-letter country code or intl for international sources. Case-insensitive.
tier	integer	optional	outlets view only: restrict to one editorial tier. 1 is a wire or primary outlet. Outlets with no declared tier are never returned by this filter, because their tier is unknown rather than 4.
risk	string	optional	outlets view only: restrict to one declared propaganda-risk band.
platform	string	optional	outlets view only: restrict to source identities configured on a platform such as telegram.
query	string	optional	Case-insensitive substring match — against host and provider in the providers view, against outlet name in the outlets view. Applied before limit.
limit	integer	optional	Maximum rows in an enumerated view. Defaults to 50, capped at 200. Ignored by the summary view. The full provider inventory does not fit one response, so a truncated result sets returned < matched.
jmespath	string	optional	Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

Raw schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "summary",
        "providers",
        "outlets"
      ],
      "description": "summary (default) returns counts only and is small. providers enumerates upstream hosts; outlets enumerates named public source identities with tier and provenance."
    },
    "kind": {
      "type": "string",
      "description": "providers view only: restrict to one kind — feed, structured, feed+structured, or operational-status."
    },
    "country": {
      "type": "string",
      "description": "providers view only: restrict by publisher origin using a two-letter country code or intl for international sources. Case-insensitive."
    },
    "tier": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "description": "outlets view only: restrict to one editorial tier. 1 is a wire or primary outlet. Outlets with no declared tier are never returned by this filter, because their tier is unknown rather than 4."
    },
    "risk": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "unknown"
      ],
      "description": "outlets view only: restrict to one declared propaganda-risk band."
    },
    "platform": {
      "type": "string",
      "enum": [
        "telegram"
      ],
      "description": "outlets view only: restrict to source identities configured on a platform such as telegram."
    },
    "query": {
      "type": "string",
      "description": "Case-insensitive substring match — against host and provider in the providers view, against outlet name in the outlets view. Applied before limit."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Maximum rows in an enumerated view. Defaults to 50, capped at 200. Ignored by the summary view. The full provider inventory does not fit one response, so a truncated result sets returned < matched."
    },
    "jmespath": {
      "type": "string",
      "description": "Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples."
    }
  },
  "required": []
}

README.md13 KBView on GitHub

World Monitor

简体中文 | 日本語 | Русский

Real-time global intelligence dashboard — AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface.

skills.sh

Documentation · Releases · Contributing

World Monitor Dashboard

What It Does

Curated news feeds across global and regional categories, AI-synthesized into briefs
Dual map engine — 3D globe (globe.gl) and WebGL flat map (deck.gl) with a shared map-layer catalog
Panel inventory — concrete panel implementations across specialized variants
Cross-stream correlation — military, economic, disaster, and escalation signal convergence
Country Instability Index (CII) — live CII v8 scores, bands, and approximate 24-hour movement for 31 Tier-1 countries
Finance radar — stock exchanges, commodities, crypto, and a market composite
Local AI — run everything with Ollama, no API keys required
Site variants from a single codebase (world, tech, finance, commodity, happy, energy)
Native desktop app (Tauri 2) for macOS, Windows, and Linux
Multilingual UI with native-language feeds and RTL support

For the full feature list, architecture, data sources, and algorithms, see the documentation.

Support Status

All site variants and desktop binaries are built from a single codebase and ship from the same release process. The table below clarifies maintenance status so you know which surfaces are safe to depend on.

Surface	Status	Notes
`worldmonitor.app`, `tech.`, `finance.`, `commodity.`, `happy.`, `energy.`	Stable	Public deployments built from this repo, actively maintained
Desktop binaries (Windows / macOS Apple Silicon / macOS Intel / Linux AppImage)	Stable	One Tauri binary for every variant — install World Monitor and switch to tech, finance, commodity, energy, or happy in-app. There is deliberately no per-variant download

Issues filed against any of the above are triaged from the same backlog — see the issues board for currently-open work.

Quick Start

bash

git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
npm install
npm run dev

Open localhost:3000 (override the port with DEV_PORT in .env.local). The app runs with no environment variables.

Feature-specific data sources may require credentials. See .env.example for the full list.

For variant-specific development:

bash

npm run dev:tech       # tech.worldmonitor.app
npm run dev:finance    # finance.worldmonitor.app
npm run dev:commodity  # commodity.worldmonitor.app
npm run dev:happy      # happy.worldmonitor.app
npm run dev:energy     # energy.worldmonitor.app

See the self-hosting guide for deployment options (Vercel, Docker, static).

Tech Stack

Category	Technologies
Frontend	Vanilla TypeScript, Vite, globe.gl + Three.js, deck.gl + MapLibre GL
Desktop	Tauri 2 (Rust) with Node.js sidecar
AI/ML	Ollama / Groq / OpenRouter, Transformers.js (browser-side)
API Contracts	Protocol Buffers and sebuf HTTP annotations
Deployment	Vercel Edge Functions, Railway relay, Tauri, PWA
Caching	Redis (Upstash), 3-tier cache, CDN, service worker

Full stack details in the architecture docs.

Programmatic Access

World Monitor is built for agents and scripts as well as browsers:

MCP server — https://worldmonitor.app/mcp (Streamable HTTP). Public tools/list; tools/call authenticates with a X-WorldMonitor-Key header or OAuth. The server also publishes its Agent Skills through the draft io.modelcontextprotocol/skills extension (skills/list, skills/get, and skill://… resource reads).
REST API — base https://api.worldmonitor.app, described by the OpenAPI spec.

CLI — the official worldmonitor npm package (source in cli/):

npx worldmonitor tools          # run ad-hoc — list every MCP tool (no key needed)
npm install -g worldmonitor     # or install the `worldmonitor` (alias `wm`) command
worldmonitor risk IR --api-key wm_xxx

SDKs — official zero-dependency client libraries mirroring the CLI: Python worldmonitor-sdk (source in sdk/python/), Ruby worldmonitor (sdk/ruby/), Go github.com/koala73/worldmonitor/sdk/go (sdk/go/). Guide: worldmonitor.app/docs/sdks.

Agent discovery files: llms.txt · agent-skills manifest · api-catalog. Get an API key at worldmonitor.app/pro.

Flight Data

Flight data provided graciously by Wingbits, the most advanced ADS-B flight data solution.

Data Sources

WorldMonitor aggregates attributed upstream sources across geopolitics, finance, energy, climate, aviation, cyber, military, infrastructure, and news intelligence. Curated feeds and freshness-tracked source groups are published in the full data sources catalog, with provider, feed-tier, license-posture, and collection-method details.

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

bash

npm run typecheck        # Type checking
npm run build:full       # Production build

License

AGPL-3.0-only for the source code. Commercial use is permitted under the AGPL when you comply with its copyleft and source-availability terms.

Use Case	Allowed?
Personal / research / educational	Yes, under AGPL-3.0-only
Self-hosted instance	Yes, under AGPL-3.0-only
Fork and modify	Yes, share source under AGPL-3.0-only when required
Commercial use / SaaS	Yes, under AGPL-3.0-only when you comply with AGPL obligations
Private-source proprietary use or official branding rights	Separate commercial or trademark permission needed

See LICENSE for the full code license and docs/license.mdx for a plain-language summary. Commercial licensing is available as an alternative option for teams that need non-AGPL terms.

Author

Elie Habib — GitHub

Contributors

Security Acknowledgments

We thank the following researchers for responsibly disclosing security issues:

Cody Richard — Disclosed three security findings covering IPC command exposure, renderer-to-sidecar trust boundary analysis, and fetch patch credential injection architecture (2026)

See our Security Policy for responsible disclosure guidelines.

worldmonitor.app · docs.worldmonitor.app · finance.worldmonitor.app · commodity.worldmonitor.app

Star History

Install

Tools (75)

get_toronto_reported_occurrencesget_toronto_calls_attendedget_market_dataget_conflict_eventsget_aviation_statusget_news_intelligenceget_natural_disastersget_military_posture

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://worldmonitor.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://worldmonitor.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.