MCP Tools Reference - World Monitor

Complete reference for every MCP tool. Use this alongside the MCP Server overview (connection, auth, plans, errors). Every tool returns the standard MCP content-block format:

{ "jsonrpc": "2.0", "id": 1, "result": { "content": [{ "type": "text", "text": "{...json payload...}" }], "isError": false } }

Cache-backed tools (the majority) include cached_at (ISO timestamp) and stale: boolean in their JSON payload so you can reason about freshness. The curl examples below all assume you’ve exported your API key:

export WM_KEY="wm_live_..."  # or use the OAuth bearer token instead — see /mcp-server#authentication

If you’ve completed the OAuth flow instead, replace -H "X-WorldMonitor-Key: $WM_KEY" with -H "Authorization: Bearer $TOKEN" in each example.

Recently added (May 2026): get_displacement_data, get_health_signals, get_energy_intelligence, get_consumer_prices, get_tariff_trends, get_chokepoint_status — six new bundled tools that exposed previously-cached domains via MCP.

Markets & economy

`get_market_data`

Real-time equity quotes, commodity prices (including gold futures GC=F), crypto prices, forex FX rates (USD/EUR, USD/JPY etc.), sector performance, ETF flows, and Gulf market quotes from WorldMonitor’s curated bootstrap cache. Parameters: none

API endpoints: GET /api/market/v1/get-fear-greed-index, GET /api/market/v1/get-sector-summary, GET /api/market/v1/list-commodity-quotes, GET /api/market/v1/list-crypto-quotes, GET /api/market/v1/list-etf-flows, GET /api/market/v1/list-gulf-quotes, GET /api/market/v1/list-market-quotes
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 30 min before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_market_data","arguments":{}}
  }'

`get_economic_data`

Macro economic indicators: Fed Funds rate (FRED), economic calendar events, fuel prices, ECB FX rates, EU yield curve, earnings calendar, COT positioning, energy storage data, BIS household debt service ratio (DSR, quarterly, leading indicator of household financial stress across ~40 advanced economies), and BIS residential + commercial property price indices (real, quarterly). Parameters: none

API endpoints: GET /api/economic/v1/get-ecb-fx-rates, GET /api/economic/v1/get-economic-calendar, GET /api/economic/v1/get-eu-yield-curve, GET /api/economic/v1/list-fuel-prices, GET /api/market/v1/get-cot-positioning, GET /api/market/v1/list-earnings-calendar
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 1 d before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_economic_data","arguments":{}}
  }'

`get_country_macro`

Per-country macroeconomic indicators from IMF WEO (~210 countries, monthly cadence). Bundles fiscal/external balance (inflation, current account, gov revenue/expenditure/primary balance, CPI), growth & per-capita (real GDP growth, GDP/capita USD & PPP, savings & investment rates, savings-investment gap), labor & demographics (unemployment, population), and external trade (current account USD, import/export volume % changes). Latest available year per series. Use for country-level economic screening, peer benchmarking, and stagflation/imbalance flags. NOTE: export/import LEVELS in USD (exportsUsd, importsUsd, tradeBalanceUsd) are returned as null — WEO retracted broad coverage for BX/BM indicators in 2026-04; use currentAccountUsd or volume changes (import/exportVolumePctChg) instead. Parameters: none

API endpoints: none directly — reads from a bootstrap-aggregate cache key (no 1:1 REST endpoint).
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 70 d before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_country_macro","arguments":{}}
  }'

`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. Each country entry includes the latest value, prior value, date, unit, and a 10-year sparkline series. Complements BIS WS_SPP with broader EU coverage for the Housing cycle tile. Parameters: none

API endpoints: none directly — reads from a bootstrap-aggregate cache key (no 1:1 REST endpoint).
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 50 d before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_eu_housing_cycle","arguments":{}}
  }'

`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 aggregates. Each country entry includes latest value, prior value, quarter label, and an 8-quarter sparkline series. Provides fresher debt-trajectory signal than annual IMF GGXWDG_NGDP for EU panels. Parameters: none

API endpoints: none directly — reads from a bootstrap-aggregate cache key (no 1:1 REST endpoint).
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 14 d before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_eu_quarterly_gov_debt","arguments":{}}
  }'

`get_eu_industrial_production`

Eurostat monthly industrial production index (sts_inpr_m, NACE B-D industry excl. construction, SCA, base 2021=100) for all 27 EU members plus EA20 and EU27_2020 aggregates. Each country entry includes latest value, prior value, month label, and a 12-month sparkline series. Leading indicator of real-economy activity used by the “Real economy pulse” sparkline. Parameters: none

API endpoints: none directly — reads from a bootstrap-aggregate cache key (no 1:1 REST endpoint).
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 5 d before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_eu_industrial_production","arguments":{}}
  }'

`get_tariff_trends`

Global trade and pricing indicators: US tariff trends (HTS-coded), BigMac index, FAO Food Price Index, and per-country national debt levels. Parameters: none

API endpoints: GET /api/economic/v1/get-fao-food-price-index, GET /api/economic/v1/get-national-debt, GET /api/economic/v1/list-bigmac-prices
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 9 h before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_tariff_trends","arguments":{}}
  }'

`get_consumer_prices`

Per-country consumer-prices intelligence: 30-day overview, category-level inflation, retailer spread (essentials basket), top movers, and source freshness. Requires country_code (currently only ‘ae’ is seeded). Parameters:

Name	Type	Required	Description
`country_code`	string	yes	ISO 3166-1 alpha-2 country code. Currently supported: AE (case-insensitive).

API endpoints: GET /api/consumer-prices/v1/get-consumer-price-freshness, GET /api/consumer-prices/v1/get-consumer-price-overview, GET /api/consumer-prices/v1/list-consumer-price-categories, GET /api/consumer-prices/v1/list-consumer-price-movers, GET /api/consumer-prices/v1/list-retailer-price-spreads
Kind: hybrid — reads cache keys directly (sub-second) but requires an input parameter to select the slice.
Freshness budget: up to 25 h per slice (24 h cron + 1 h grace) before stale: true is flagged.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_consumer_prices","arguments":{"country_code":"AE"}}
  }'

`get_commodity_geo`

Global mining sites with coordinates, operator, mineral type, and production status. Covers 71 major mines spanning gold, silver, copper, lithium, uranium, coal, and other minerals worldwide. Parameters:

Name	Type	Required	Description
`mineral`	string	no	Filter by mineral type (e.g. “Gold”, “Copper”, “Lithium”)
`country`	string	no	Filter by country name (e.g. “Australia”, “Chile”)

API endpoints: none — this tool reads no cache and makes no HTTP fetch.
Kind: static registry — filters the bundled MINING_SITES_RAW constant (in-memory, ships with the MCP server’s edge bundle). Sub-millisecond, no upstream call. The dataset updates only when the MCP server is redeployed with a refreshed registry.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_commodity_geo","arguments":{}}
  }'

`get_prediction_markets`

Active Polymarket event contracts with current probabilities. Covers geopolitical, economic, and election prediction markets. Parameters: none

API endpoints: GET /api/prediction/v1/list-prediction-markets
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 1.5 h before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_prediction_markets","arguments":{}}
  }'

Energy

`get_energy_intelligence`

Energy supply, prices, storage, disruptions, and policy: EIA petroleum stocks, electricity prices (Ember), gas storage (GIE), fuel shortages, fossil & renewable shares, active energy disruptions, government crisis policies. Parameters: none

API endpoints: GET /api/economic/v1/get-energy-crisis-policies, GET /api/supply-chain/v1/get-fuel-shortage-detail, GET /api/supply-chain/v1/list-energy-disruptions, GET /api/supply-chain/v1/list-fuel-shortages
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 3 d before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_energy_intelligence","arguments":{}}
  }'

Geopolitical & security

`get_conflict_events`

Active armed conflict events (UCDP, Iran), unrest events with geo-coordinates, and country risk scores. Covers ongoing conflicts, protests, and instability indices worldwide. Parameters: none

API endpoints: GET /api/conflict/v1/list-iran-events, GET /api/conflict/v1/list-ucdp-events, GET /api/unrest/v1/list-unrest-events
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 30 min before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_conflict_events","arguments":{}}
  }'

`get_country_risk`

Structured risk intelligence for a specific country: Composite Instability Index (CII) score 0-100, component breakdown (unrest/conflict/security/news), travel advisory level, and OFAC sanctions exposure. Fast Redis read — no LLM. Use for quantitative risk screening or to answer “how risky is X right now?” Parameters:

Name	Type	Required	Description
`country_code`	string	yes	ISO 3166-1 alpha-2 country code, e.g. “RU”, “IR”, “CN”, “UA”

API endpoints: GET /api/intelligence/v1/get-country-risk
Kind: live RPC — proxies a fetch to the WorldMonitor API on each call. Edge-runtime timeout: 8.0s.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_country_risk","arguments":{"country_code":"US"}}
  }'

`get_country_brief`

AI-generated per-country intelligence brief. Produces an LLM-analyzed geopolitical and economic assessment for the given country. Supports analytical frameworks for structured lenses. Parameters:

Name	Type	Required	Description
`country_code`	string	yes	ISO 3166-1 alpha-2 country code, e.g. “US”, “DE”, “CN”, “IR”
`framework`	string	no	Optional analytical framework instructions to shape the analysis lens (e.g. Ray Dalio debt cycle, PMESII-PT)

API endpoints: GET /api/intelligence/v1/get-country-intel-brief
Kind: live RPC — proxies a fetch to the WorldMonitor API on each call. Worst-case total budget ~24s (2s context-digest fetch + 22s brief generation, sequential).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_country_brief","arguments":{"country_code":"US"}}
  }'

`get_news_intelligence`

AI-classified geopolitical threat news summaries, GDELT intelligence signals, cross-source signals, and security advisories from WorldMonitor’s intelligence layer. Parameters: none

API endpoints: GET /api/intelligence/v1/list-cross-source-signals, GET /api/intelligence/v1/search-gdelt-documents
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 30 min before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_news_intelligence","arguments":{}}
  }'

`get_cyber_threats`

Active cyber threat intelligence: malware IOCs (URLhaus, Feodotracker), CISA known exploited vulnerabilities, and active command-and-control infrastructure. Parameters: none

API endpoints: none directly — reads from a bootstrap-aggregate cache key (no 1:1 REST endpoint).
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 4 h before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_cyber_threats","arguments":{}}
  }'

`get_sanctions_data`

OFAC SDN sanctioned entities list and sanctions pressure scores by country. Useful for compliance screening and geopolitical pressure analysis. Parameters: none

API endpoints: GET /api/sanctions/v1/list-sanctions-pressure, GET /api/sanctions/v1/lookup-sanction-entity
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 1 d before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_sanctions_data","arguments":{}}
  }'

`get_social_velocity`

Reddit geopolitical social velocity: top posts from worldnews, geopolitics, and related subreddits with engagement scores and trend signals. Parameters: none

API endpoints: GET /api/intelligence/v1/get-social-velocity
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 30 min before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_social_velocity","arguments":{}}
  }'

`get_military_posture`

Theater posture assessment and military risk scores. Reflects aggregated military positioning and escalation signals across global theaters. Parameters: none

API endpoints: GET /api/military/v1/get-theater-posture
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 2 h before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_military_posture","arguments":{}}
  }'

`get_chokepoint_status`

Live maritime chokepoint status: per-chokepoint vessel transit counts (10-min cadence), rolling transit summaries, per-port activity, plus static reference data (chokepoint geometry, canonical 13-chokepoint registry) and flow aggregates. Covers Suez, Hormuz, Malacca, Bab-el-Mandeb, Panama, etc. Parameters: none

API endpoints: GET /api/intelligence/v1/get-country-port-activity, GET /api/supply-chain/v1/get-chokepoint-status
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget (per slice): stale: true flags when ANY contributing slice exceeds its individual budget — 30 min for live transit summaries (relay), 36 h for PortWatch port activity, 14 d for chokepoint flows, and up to ~400 d for the static chokepoint registry / geographic baselines. The bundle’s cached_at reflects the oldest contributing seed; stale: true doesn’t mean ALL the data is old.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_chokepoint_status","arguments":{}}
  }'

`get_positive_events`

Positive geopolitical events: diplomatic agreements, humanitarian aid, development milestones, and peace initiatives worldwide. Parameters: none

API endpoints: GET /api/positive-events/v1/list-positive-geo-events
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 1 h before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_positive_events","arguments":{}}
  }'

Movement & infrastructure

`get_aviation_status`

Airport delays, NOTAM airspace closures, and tracked military aircraft. Covers FAA delay data and active airspace restrictions. Parameters: none

API endpoints: none directly — reads from a bootstrap-aggregate cache key (no 1:1 REST endpoint).
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 1.5 h before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_aviation_status","arguments":{}}
  }'

`get_airspace`

Live ADS-B aircraft over a country. Returns civilian flights (OpenSky) and identified military aircraft with callsigns, positions, altitudes, and headings. Answers questions like “how many planes are over the UAE right now?” or “are there military aircraft over Taiwan?” Parameters:

Name	Type	Required	Description
`country_code`	string	yes	ISO 3166-1 alpha-2 country code (e.g. “AE”, “US”, “GB”, “JP”)
`type`	string (all / civilian / military)	no	Filter: all flights (default), civilian only, or military only

API endpoints: GET /api/aviation/v1/track-aircraft, GET /api/military/v1/list-military-flights
Kind: live RPC — proxies a fetch to the WorldMonitor API on each call. Edge-runtime timeout: 8.0s.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_airspace","arguments":{"country_code":"US"}}
  }'

`get_maritime_activity`

Live vessel traffic and maritime disruptions for a country’s waters. Returns AIS density zones (ships-per-day, intensity score), dark ship events, and chokepoint congestion from AIS tracking. Parameters:

Name	Type	Required	Description
`country_code`	string	yes	ISO 3166-1 alpha-2 country code (e.g. “AE”, “SA”, “JP”, “EG”)

API endpoints: GET /api/maritime/v1/get-vessel-snapshot
Kind: live RPC — proxies a fetch to the WorldMonitor API on each call. Edge-runtime timeout: 8.0s.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_maritime_activity","arguments":{"country_code":"US"}}
  }'

`get_supply_chain_data`

Dry bulk shipping stress index, customs revenue flows, and COMTRADE bilateral trade data. Tracks global supply chain pressure and trade disruptions. Parameters: none

API endpoints: GET /api/supply-chain/v1/get-shipping-stress, GET /api/trade/v1/get-customs-revenue
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 2 d before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_supply_chain_data","arguments":{}}
  }'

`get_infrastructure_status`

Internet infrastructure health: Cloudflare Radar outages and service status for major cloud providers and internet services. Parameters: none

API endpoints: GET /api/infrastructure/v1/list-internet-outages
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 30 min before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_infrastructure_status","arguments":{}}
  }'

`search_flights`

Search Google Flights for real-time flight options between two airports on a specific date. Returns available flights with prices, stops, airline, and segment details. Use IATA airport codes (e.g. “JFK”, “LHR”, “DXB”). Parameters:

Name	Type	Required	Description
`origin`	string	yes	IATA code for the departure airport, e.g. “JFK”
`destination`	string	yes	IATA code for the arrival airport, e.g. “LHR”
`departure_date`	string	yes	Departure date in YYYY-MM-DD format
`return_date`	string	no	Return date in YYYY-MM-DD format for round trips (optional)
`cabin_class`	string	no	Cabin class: “economy”, “premium_economy”, “business”, or “first” (optional, default economy)
`max_stops`	string	no	Max stops: “0” or “non_stop” for nonstop, “1” or “one_stop” for max one stop, or omit for any (optional)
`passengers`	number	no	Number of passengers (1-9, default 1)
`sort_by`	string	no	Sort order: “price” (cheapest), “duration”, “departure”, or “arrival” (optional)

API endpoints: GET /api/aviation/v1/search-google-flights
Kind: live RPC — proxies a fetch to the WorldMonitor API on each call. Edge-runtime timeout: 25.0s.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"search_flights","arguments":{"origin":"JFK","destination":"LHR","departure_date":"2026-08-15"}}
  }'

`search_flight_prices_by_date`

Search Google Flights date-grid pricing across a date range. Returns cheapest prices for each departure date between two airports. Useful for finding the cheapest day to fly. Use IATA airport codes. Parameters:

Name	Type	Required	Description
`origin`	string	yes	IATA code for the departure airport, e.g. “JFK”
`destination`	string	yes	IATA code for the arrival airport, e.g. “LHR”
`start_date`	string	yes	Start of the date range in YYYY-MM-DD format
`end_date`	string	yes	End of the date range in YYYY-MM-DD format
`is_round_trip`	boolean	no	Whether to search round-trip prices (default false). Requires trip_duration when true.
`trip_duration`	number	no	Trip duration in days — required when is_round_trip is true (e.g. 7 for a one-week trip)
`cabin_class`	string	no	Cabin class: “economy”, “premium_economy”, “business”, or “first” (optional)
`passengers`	number	no	Number of passengers (1-9, default 1)
`sort_by_price`	boolean	no	Sort results by price ascending (default false, sorts by date)

API endpoints: GET /api/aviation/v1/search-google-dates
Kind: live RPC — proxies a fetch to the WorldMonitor API on each call. Edge-runtime timeout: 25.0s.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"search_flight_prices_by_date","arguments":{"origin":"JFK","destination":"LHR","start_date":"2026-08-01","end_date":"2026-08-31"}}
  }'

Environment & science

`get_climate_data`

Climate intelligence: temperature/precipitation anomalies (vs 30-year WMO normals), climate-relevant disaster alerts (ReliefWeb/GDACS/FIRMS), atmospheric CO2 trend (NOAA Mauna Loa), air quality (OpenAQ/WAQI PM2.5 stations), Arctic sea ice extent and ocean heat indicators (NSIDC/NOAA), weather alerts, and climate news. Parameters: none

API endpoints: GET /api/climate/v1/get-co2-monitoring, GET /api/climate/v1/get-ocean-ice-data, GET /api/climate/v1/list-air-quality-data, GET /api/climate/v1/list-climate-anomalies, GET /api/climate/v1/list-climate-disasters, GET /api/climate/v1/list-climate-news
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 2 d before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_climate_data","arguments":{}}
  }'

`get_natural_disasters`

Recent earthquakes (USGS), active wildfires (NASA FIRMS), and natural hazard events. Includes magnitude, location, and threat severity. Parameters: none

API endpoints: GET /api/natural/v1/list-natural-events, GET /api/seismology/v1/list-earthquakes, GET /api/wildfire/v1/list-fire-detections
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 30 min before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_natural_disasters","arguments":{}}
  }'

`get_radiation_data`

Radiation observation levels from global monitoring stations. Flags anomalous readings that may indicate nuclear incidents. Parameters: none

API endpoints: GET /api/radiation/v1/list-radiation-observations
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 30 min before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_radiation_data","arguments":{}}
  }'

`get_research_signals`

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

API endpoints: GET /api/research/v1/list-tech-events
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 8 h before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_research_signals","arguments":{}}
  }'

Health

`get_health_signals`

Active disease outbreaks (WHO/ECDC etc.) and global air-quality station readings (OpenAQ/WAQI PM2.5). For health-risk screening. Parameters: none

API endpoints: GET /api/health/v1/list-air-quality-alerts, GET /api/health/v1/list-disease-outbreaks
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 2 d before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_health_signals","arguments":{}}
  }'

Humanitarian & displacement

`get_displacement_data`

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

API endpoints: GET /api/displacement/v1/get-displacement-summary
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 2.5 d before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_displacement_data","arguments":{}}
  }'

AI intelligence (live LLM)

`get_world_brief`

AI-generated world intelligence brief. Fetches the latest geopolitical headlines along with their RSS article bodies and produces a grounded LLM-summarized brief. Supply an optional geo_context to focus on a region or topic. Parameters:

Name	Type	Required	Description
`geo_context`	string	no	Optional focus context (e.g. “Middle East tensions”, “US-China trade war”)

API endpoints: GET /api/news/v1/list-feed-digest, POST /api/news/v1/summarize-article
Kind: live RPC — proxies a fetch to the WorldMonitor API on each call. Worst-case total budget ~24s (6s digest fetch + 18s LLM summarization, sequential).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_world_brief","arguments":{}}
  }'

`analyze_situation`

AI geopolitical situation analysis (DeductionPanel). Provide a query and optional geo-political context; returns an LLM-powered analytical deduction with confidence and supporting signals. Parameters:

Name	Type	Required	Description
`query`	string	yes	The question or situation to analyze, e.g. “What are the implications of the Taiwan strait escalation for semiconductor supply chains?”
`context`	string	no	Optional additional geo-political context to include in the analysis
`framework`	string	no	Optional analytical framework instructions to shape the analysis lens (e.g. Ray Dalio debt cycle, PMESII-PT, Porter’s Five Forces)

API endpoints: POST /api/intelligence/v1/deduct-situation
Kind: live RPC — proxies a fetch to the WorldMonitor API on each call. Edge-runtime timeout: 25.0s.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"analyze_situation","arguments":{"query":"What are the implications of the Taiwan strait escalation for semiconductor supply chains?"}}
  }'

`generate_forecasts`

Generate live AI geopolitical and economic forecasts. Unlike get_forecast_predictions (pre-computed cache), this calls the forecasting model directly for fresh probability estimates. Note: slower than cache tools. Parameters:

Name	Type	Required	Description
`domain`	string	no	Forecast domain: “geopolitical”, “economic”, “military”, “climate”, or empty for all domains
`region`	string	no	Geographic region filter, e.g. “Middle East”, “Europe”, “Asia Pacific”, or empty for global

API endpoints: no public OpenAPI row; runtime proxies POST /api/forecast/v1/get-forecasts (the OpenAPI spec only declares GET on that path, which is covered by get_forecast_predictions — this tool’s POST variant runs a fresh forecast).
Kind: live RPC — proxies a fetch to the WorldMonitor API on each call. Edge-runtime timeout: 25.0s.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"generate_forecasts","arguments":{}}
  }'

`get_forecast_predictions`

AI-generated geopolitical and economic forecasts from WorldMonitor’s predictive models. Covers upcoming risk events and probability assessments. Parameters: none

API endpoints: GET /api/forecast/v1/get-forecasts
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 1.5 h before stale: true is flagged (set by the seeder cron’s expected interval).

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_forecast_predictions","arguments":{}}
  }'

Getting Started

Usage

Platform & Features

Intelligence & Analysis

Workflows

Map Layers

Finance

Panels — AI & PRO

Panels — Data & Tracking

Panels — Catalogues

Desktop Application

MCP & Integrations

HTTP API

Developer Guide

Legal

Documentation Index

​Markets & economy

​get_market_data

​get_economic_data

​get_country_macro

​get_eu_housing_cycle

​get_eu_quarterly_gov_debt

​get_eu_industrial_production

​get_tariff_trends

​get_consumer_prices

​get_commodity_geo

​get_prediction_markets

​Energy

​get_energy_intelligence

​Geopolitical & security

​get_conflict_events

​get_country_risk

​get_country_brief

​get_news_intelligence

​get_cyber_threats

​get_sanctions_data

​get_social_velocity

​get_military_posture

​get_chokepoint_status

​get_positive_events

​Movement & infrastructure

​get_aviation_status

​get_airspace

​get_maritime_activity

​get_supply_chain_data

​get_infrastructure_status

​search_flights

​search_flight_prices_by_date

​Environment & science

​get_climate_data

​get_natural_disasters

​get_radiation_data

​get_research_signals

​Health

​get_health_signals

​Humanitarian & displacement

​get_displacement_data

​AI intelligence (live LLM)

​get_world_brief

​analyze_situation

​generate_forecasts

​get_forecast_predictions

​Meta

​describe_tool

Markets & economy

`get_market_data`

`get_economic_data`

`get_country_macro`

`get_eu_housing_cycle`

`get_eu_quarterly_gov_debt`

`get_eu_industrial_production`

`get_tariff_trends`

`get_consumer_prices`

`get_commodity_geo`

`get_prediction_markets`

Energy

`get_energy_intelligence`

Geopolitical & security

`get_conflict_events`

`get_country_risk`

`get_country_brief`

`get_news_intelligence`

`get_cyber_threats`

`get_sanctions_data`

`get_social_velocity`

`get_military_posture`

`get_chokepoint_status`

`get_positive_events`

Movement & infrastructure

`get_aviation_status`

`get_airspace`

`get_maritime_activity`

`get_supply_chain_data`

`get_infrastructure_status`

`search_flights`

`search_flight_prices_by_date`

Environment & science

`get_climate_data`

`get_natural_disasters`

`get_radiation_data`

`get_research_signals`

Health

`get_health_signals`

Humanitarian & displacement

`get_displacement_data`

AI intelligence (live LLM)

`get_world_brief`

`analyze_situation`

`generate_forecasts`

`get_forecast_predictions`

Meta

`describe_tool`