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_0123456789abcdef0123456789abcdef01234567"  # or use the OAuth bearer token instead — see /mcp-overview#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.

Discovering tools

Before diving into the per-tool reference, two affordances make discovery cheaper than reading this page top-to-bottom. If you are starting from a REST route instead of a tool name, use the API coverage table; per-tool API endpoints lines mean exact _apiPaths declarations, while none directly means the tool returns data without claiming an equivalent REST route. MCP coverage is intentionally curated. Some OpenAPI operations are REST-only because they mutate state, pass through LLM cost, fetch paid/high-cardinality upstreams on cache miss, or need manual cache-key mapping. The API coverage section names the enforced categories and links the current follow-up trackers.

`describe_tool` — full uncompressed definition on demand

Since v1.5.0, tools/list returns each tool’s description truncated to the first sentence (≤120 UTF-8 bytes). That keeps the per-session input-token cost low when the LLM only needs to scan names — and the same tools/list entry now ships an outputSchema (v1.6.0) so the model can author a JMESPath projection on the first call. When the compressed description is ambiguous, call describe_tool for the long form:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": { "name": "describe_tool", "arguments": { "tool_name": "get_chokepoint_status" } }
}

Response — identical shape to a tools/list entry, with the full uncompressed description and the full inputSchema.properties text:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"name\":\"get_chokepoint_status\",\"description\":\"Live maritime chokepoint status: per-chokepoint vessel transit counts (10-min cadence), rolling transit summaries, per-port activity, plus static reference data and flow aggregates. Covers Suez, Hormuz, Malacca, Bab-el-Mandeb, Panama, etc.\",\"inputSchema\":{ /* full properties with full descriptions */ },\"outputSchema\":{ /* … */ },\"annotations\":{\"readOnlyHint\":true,\"destructiveHint\":false,\"idempotentHint\":true,\"openWorldHint\":false}}"
      }
    ]
  }
}

describe_tool is exempt from the Pro daily quota (per-minute rate limit still applies). The exemption is intentional — counting metadata lookups against the 50/day cap would discourage exploration, defeating the compression. Two common workflows:

Compressed entry is ambiguous about behaviour or argument semantics. Call describe_tool to see the full long-form description plus every property’s full description.
First-time JMESPath authoring against an unfamiliar response. Call describe_tool to read the outputSchema (see next section) without paying a quota slot for a real tools/call.

describe_tool returns two soft-error envelopes inside the normal content[0].text:

{ "error": "missing_tool_name", "hint": "Pass tool_name as a non-empty string matching a tool from tools/list." } — tool_name was omitted, empty, or non-string.
{ "error": "unknown_tool", "requested": "<the bad name>", "available": [...sorted list of all tool names...] } — tool_name didn’t match. The available array lets the LLM self-correct in one extra call.

The full per-tool reference for describe_tool (parameters, response shape, quota posture) is at describe_tool under Meta.

`outputSchema` — typed parsing without a sample call

As of v1.6.0, every tool’s tools/list entry declares a spec-defined MCP 2025-06-18 Tool.outputSchema. The schema describes the shape of the JSON that lives inside result.content[0].text for that tool — letting clients author projections, validate responses, or generate types without ever issuing a real tools/call. Schemas are emitted unconditionally on every tools/list, regardless of the negotiated protocolVersion. Clients on the older 2025-03-26 floor still receive them and (per spec) are expected to ignore unknown fields rather than fail. Worked example — the outputSchema for get_country_risk:

{
  "type": "object",
  "properties": {
    "country_code": { "type": "string" },
    "cii": { "type": ["number", "null"], "description": "Composite Instability Index 0-100." },
    "components": {
      "type": "object",
      "properties": {
        "unrest":   { "type": ["number", "null"] },
        "conflict": { "type": ["number", "null"] },
        "security": { "type": ["number", "null"] },
        "news":     { "type": ["number", "null"] }
      }
    },
    "travelAdvisory":    { "type": ["object", "string", "null"] },
    "sanctionsExposure": { "type": ["object", "array", "null"] }
  }
}

Cache tools wrap their declared data shape in the standard freshness envelope:

{
  "type": "object",
  "required": ["cached_at", "stale", "data"],
  "properties": {
    "cached_at": { "type": ["string", "null"], "description": "ISO-8601 timestamp of the OLDEST contributing cache key." },
    "stale":     { "type": "boolean", "description": "True when any contributing cache key is older than its per-key maxStaleMin freshness budget." },
    "data":      { "type": "object", "properties": { /* per-tool fields */ } }
  }
}

A typed-parsing sketch in TypeScript using the schema for compile-time hints:

// Synthesise types from the schema once (e.g. with json-schema-to-typescript).
type CountryRisk = {
  country_code: string;
  cii: number | null;
  components: { unrest: number | null; conflict: number | null; security: number | null; news: number | null };
  travelAdvisory: object | string | null;
  sanctionsExposure: object | unknown[] | null;
};

const reply = await callTool('get_country_risk', { country_code: 'IR' });
const text = reply.result?.content?.[0]?.text;
if (typeof text !== 'string') throw new Error('no text payload');

type SoftEnvelope =
  | { _budget_exceeded: true; budget_bytes: number; actual_bytes: number; hint: string }
  | { _jmespath_error: string; original_keys: string[] };

const parsed = JSON.parse(text) as CountryRisk | SoftEnvelope;
// Check for BOTH soft-envelope discriminators BEFORE consuming sibling fields as data.
// A `_jmespath_error` payload that falls through to the success branch would silently
// dereference undefined — the exact anti-pattern the catalog warns against.
if ('_budget_exceeded' in parsed) {
  // narrow with jmespath / filters and retry — see /mcp-error-catalog
} else if ('_jmespath_error' in parsed) {
  // fix the projection using `original_keys` as the schema hint — see /mcp-error-catalog
} else {
  console.log(parsed.cii, parsed.components.conflict);
}

Things to know:

additionalProperties is left implicit (= true) on every schema, so producer-side forward-compatible additions don’t suddenly fail validation.
Per-array items.properties lists known fields but does NOT enumerate every observed key — the schema is a hint surface for JMESPath authoring, not a bytecode-level contract.
Schemas describe the success-path payload only. The two catalog-class soft envelopes (_budget_exceeded, _jmespath_error) are NOT in the per-tool schema — they replace the payload entirely and have their own shapes. See the MCP Error Catalog for both envelopes.

Universal arguments:

Every tool accepts jmespath (string), an optional server-side projection applied after per-tool filters and summary.
Every cache tool also accepts summary (boolean), which returns counts plus 3-item samples instead of full lists.
The per-tool tables below list only tool-specific arguments declared by the registry; the universal injected arguments are intentionally documented once here.

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 (tool-specific):

Name	Type	Description
`symbols`	`array<string>`	Tickers to keep, e.g. [“AAPL”,“GC=F”,“BTC”]. Case-insensitive; matches equity/commodity/crypto/gulf quotes, sector ETFs, and ETF-flow tickers. Omit for the full snapshot.
`asset_class`	`array<string: equity / commodity / crypto / sectors / etf / gulf / sentiment>`	Restrict the response to one or more asset classes. Omit for all.
`limit`	number	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).

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 (tool-specific):

Name	Type	Description
`dataset`	`array<string: fedfunds / econ-calendar / china-macro / china-release-calendar / fuel-prices / ecb-fx-rates / yield-curve-eu / spending / earnings-calendar / cot / dsr / property-residential / property-commercial>`	Restrict the response to one or more sub-datasets. Omit for the full economic bundle.
`country`	string	Filter the country-keyed datasets (fuel-prices, BIS DSR/property, economic calendar) to one ISO 3166-1 alpha-2 code.
`limit`	number	Cap each list dataset (calendar, spending, earnings) to at most this many items (default 30, pass 0 for no cap).

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

Search active global public-procurement opportunities through the canonical Pro-gated tender API. The tool never reads Upstash directly. It returns a compact projection of the canonical records: official notice URL, source, title, buyer, timing, money, categories, sectors, participationMode, and compact automationFit; it deliberately omits descriptions, eligibility requirements, and submission URLs. Parameters (tool-specific):

Name	Type	Description
`country`	string	One ISO 3166-1 alpha-2 country code.
`countries`	`array<string>`	Additional country codes; combines with `country`.
`source`	string	Official source adapter, such as `sam`, `ted`, `contracts-finder`, `canada-buys`, `gets`, or `world-bank`.
`query`	string	Case-insensitive text search across titles and descriptions.
`buyer`	string	Case-insensitive buyer or contracting-authority text.
`deadline_from` / `deadline_to`	string	ISO-8601 inclusive deadline range.
`sort`	`string: newest / closing_soon / estimated_value / relevance`	Result ordering; defaults to `newest`.
`min_automation_score`	integer	Optional keyword-relevance score threshold. Positive integers are passed to the canonical route (which clamps values above 100); non-integer and non-positive values are ignored. It is opt-in and is not bidding-eligibility evidence.
`page_size`	integer	Default 10, maximum 25 records. This is the MCP output budget; the REST route itself permits up to 100.
`cursor`	string	Opaque `nextCursor` from the preceding result; keep the same filters and sort while paging.

API endpoint: GET /api/economic/v1/list-global-tenders
Kind: bounded canonical-route proxy — Pro entitlement remains enforced by the downstream route; no bootstrap or direct-cache exposure.
Output budget: 10 compact records by default, at most 25. The result retains nextCursor, total, appliedFilters, countryCoverage, availability, snapshot time, and per-source health summaries. An empty nextCursor means there are no further pages.

Unfiltered calls preserve the standard all-open-opportunities behavior; min_automation_score is never implied. automationFit is keyword relevance evidence only, never a legal determination of whether an agent or vendor may bid. participationMode: "unknown" means exactly that — no participation mode was established upstream.

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_procurement_opportunities","arguments":{"country":"US","min_automation_score":70,"page_size":10,"sort":"relevance"}}
  }'

`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 (tool-specific):

Name	Type	Description
`countries`	`array<string>`	ISO 3166-1 alpha-2 country codes to keep across all four IMF datasets (e.g. [“US”,“DE”,“CN”]). Omit for all ~210 countries.
`limit`	integer	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).

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 (tool-specific):

Name	Type	Description
`countries`	`array<string>`	Eurostat geo codes to keep — ISO 3166-1 alpha-2, but “EL” for Greece, plus aggregates “EA20” and “EU27_2020”. Omit for all.
`limit`	integer	Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`countries`	`array<string>`	Eurostat geo codes to keep — ISO 3166-1 alpha-2, but “EL” for Greece, plus aggregates “EA20” and “EU27_2020”. Omit for all.
`limit`	integer	Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`countries`	`array<string>`	Eurostat geo codes to keep — ISO 3166-1 alpha-2, but “EL” for Greece, plus aggregates “EA20” and “EU27_2020”. Omit for all.
`limit`	integer	Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`dataset`	`array<string: tariffs / bigmac / fao-ffpi / national-debt>`	Restrict the response to one or more sub-datasets. Omit for the full bundle.
`country`	string	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.
`limit`	number	Cap each list dataset (tariff datapoints, BigMac countries, debt entries) to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`category`	string: geopolitical / tech / finance	Restrict to one market category bucket. Omit for all three.
`query`	string	Keep only markets whose title contains this text (case-insensitive).
`source`	string: kalshi / polymarket	Filter to one prediction-market source.
`limit`	number	Cap each category bucket to at most this many markets (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`dataset`	`array<string: eia-petroleum / electricity / ember / gas-storage / fuel-shortages / disruptions / crisis-policies / fossil-share / renewable>`	Restrict the response to one or more energy sub-datasets. Omit for the full bundle.
`country`	string	Filter the country-keyed datasets (Ember electricity mix, gas storage, fuel shortages, energy disruptions, fossil-share) to one ISO 3166-1 alpha-2 code.
`limit`	number	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).

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 (tool-specific):

Name	Type	Description
`country`	string	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	Drop events below this fatality count (UCDP deathsBest / unrest fatalities).
`limit`	number	Cap each event list to at most this many items (default 30, pass 0 for no cap).

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).
Sources: returns a bounded sources array with original article links from the digest items used to ground the country context. URLs are copied from feed data, not generated by the LLM.

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 (tool-specific):

Name	Type	Description
`topic`	string: conflict / economy / cyber / nuclear / intelligence / maritime	Filter GDELT intelligence to a single topic.
`category`	string	Filter top news stories to one category (e.g. “conflict”, “economy”; fallback is “general”).
`country`	string	Filter top stories and travel advisories to one ISO 3166-1 alpha-2 country code (case-insensitive).
`alerts_only`	boolean	Keep only top stories flagged as alerts.
`limit`	number	Cap each list (top stories, signals, advisories) to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`threat_type`	string	Filter to one threat type (case-insensitive substring, e.g. “malware”, “vulnerability”, “c2”).
`min_severity`	string: low / medium / high / critical	Drop threats below this severity level.
`country`	string	Filter to one ISO 3166-1 alpha-2 country code (many threats have no country and are dropped by this filter).
`limit`	number	Cap the threat list to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`country`	string	Filter sanctioned entities and pressure scores to one ISO 3166-1 alpha-2 country code.
`entity_type`	string	Filter to one entity type (case-insensitive substring, e.g. “vessel”, “aircraft”, “person”, “entity”).
`query`	string	Keep only sanctioned entities whose name contains this text (case-insensitive).
`limit`	number	Cap the entity list and recent pressure entries to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`subreddit`	string	Filter to one subreddit (e.g. “worldnews”, “geopolitics”).
`limit`	number	Cap the post list to at most this many items (default 30, pass 0 for no cap).

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

Returns the bounded six-domain China decision-signal snapshot used by the country summary. Macro-financial, policy/enforcement, cross-Strait activity, corporate disclosures, corridor conditions, and activity nowcast groups share one stable order and the status vocabulary available, partial, stale, or unavailable. Every returned item retains canonical provenance, publisher type, source and original reference, translation state, observation/effective/publication/ retrieval times, revision and supersession, confidence, corroboration, and freshness claims. The tool returns the same bounded items as the public RPC; it does not expose detailed bilateral trade rows or operator-only source health.

Parameters: none, apart from the optional common jmespath projection.
API endpoint: GET /api/intelligence/v1/get-china-decision-signals
Kind: canonical RPC over the Railway-composed cache.
Refresh cadence: every 15 min; each group can degrade independently.

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_china_decision_signals","arguments":{}}
  }'

`get_military_posture`

Theater posture assessment and military risk scores. Reflects aggregated military positioning and escalation signals across global theaters. Parameters (tool-specific):

Name	Type	Description
`theater`	string	Filter to one theater by id (case-insensitive substring, e.g. “iran”, “taiwan”, “baltic”, “korea”).
`posture_level`	string	Filter to a single posture level.
`limit`	number	Cap the theaters list to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`chokepoint`	string	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<string: transit-summaries / chokepoint_transits / _countries / chokepoint-baselines / ref / chokepoint-flows>`	Restrict the response to one or more sub-datasets. Omit for the full bundle.
`limit`	number	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.

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, 12 h for chokepoint flows, 14 d for the PortWatch chokepoint reference, 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 (tool-specific):

Name	Type	Description
`category`	string: science-health / nature-wildlife / climate-wins / innovation-tech / humanity-kindness / culture-community	Filter to one positive-event category.
`limit`	number	Cap the event list to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`disrupted_only`	boolean	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	Filter to one country by name (case-insensitive substring, e.g. “united states”).
`iata`	string	Filter to a single airport by IATA code (e.g. “JFK”).
`limit`	number	Cap the alert list to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`dataset`	`array<string: shipping_stress / customs-revenue / flows>`	Restrict the response to one or more sub-datasets (dry-bulk shipping stress / customs revenue / COMTRADE flows). Omit for all.
`commodity`	string	Filter COMTRADE flows to one commodity — matches the HS code exactly or the commodity description by substring (e.g. “2709” or “crude”).
`reporter`	string	Filter COMTRADE flows to one reporter by numeric reporter code or reporter name (e.g. “156” or “China”).
`limit`	number	Cap each list dataset (carriers, months, flows) to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`country`	string	Filter to one country by name (case-insensitive substring).
`severity`	string	Filter to one outage severity (case-insensitive substring).
`limit`	number	Cap the outage list to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`dataset`	`array<string: anomalies / disasters / co2-monitoring / air-quality / ocean-ice / news-intelligence / alerts>`	Restrict the response to one or more climate sub-datasets. Omit for the full bundle.
`country`	string	Filter the country-tagged datasets (climate disasters, air-quality stations) to one ISO 3166-1 alpha-2 code.
`limit`	number	Cap each list dataset (anomalies, disasters, stations, news, alerts) to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`dataset`	`array<string: earthquakes / wildfires / other>`	Restrict to one or more hazard datasets (earthquakes / wildfires / other natural events). Omit for all.
`min_magnitude`	number	Drop earthquakes and natural events below this magnitude.
`active_only`	boolean	Keep only natural events that are still active (not closed).
`limit`	number	Cap each hazard list to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`country`	string	Filter to one country by name (case-insensitive substring).
`anomalous_only`	boolean	Drop observations with severity “normal” — keep only elevated/spike readings.
`limit`	number	Cap the observation list to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`type`	string: conference / earnings / ipo / other	Filter to one tech-event type.
`source`	string	Filter to one source feed (e.g. “techmeme”, “dev.events”, “curated”).
`limit`	number	Cap the event list to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`signal_type`	`array<string: outbreaks / air-quality>`	Restrict to disease outbreaks, air-quality stations, or both. Omit for both.
`country`	string	Filter outbreaks and air-quality stations to one ISO 3166-1 alpha-2 country code.
`disease`	string	Keep only outbreaks whose disease name contains this text (case-insensitive).
`min_aqi`	number	Drop air-quality stations below this AQI value.
`limit`	number	Cap the outbreak and station lists to at most this many items (default 30, pass 0 for no cap).

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 (tool-specific):

Name	Type	Description
`countries`	`array<string>`	ISO 3166-1 alpha-3 country codes to keep (e.g. [“SYR”,“UKR”,“AFG”]). Matches both per-country totals and origin/asylum flows. Omit for all.
`limit`	number	Cap the per-country and top-flow lists to at most this many items (default 30, pass 0 for no cap).

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).
Sources: returns a bounded sources array with original article links from the feed digest items sent as grounding inputs. URLs are copied from feed data, not generated by the LLM.

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 (tool-specific):

Name	Type	Description
`domain`	string	Filter to one forecast domain (exact, case-insensitive — e.g. “shipping”, “energy”, “macro”).
`region`	string	Filter to one region/theater (case-insensitive substring).
`limit`	number	Cap the forecast list to at most this many items (default 30, pass 0 for no cap).

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":{}}
  }'

`get_forecast_scorecard`

Forecast resolution scorecard with calibration, Brier/log score, domain and generation-origin breakdowns, and pending/judged resolution counts. Parameters (tool-specific): none

API endpoints: GET /api/forecast/v1/get-forecast-scorecard
Kind: cache read — sub-second response from Redis bootstrap cache.
Freshness budget: up to 36 h before stale: true is flagged (daily resolver cadence with missed-cron tolerance).

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_scorecard","arguments":{}}
  }'

​Discovering tools

​describe_tool — full uncompressed definition on demand

​outputSchema — typed parsing without a sample call

​Markets & economy

​get_market_data

​get_economic_data

​get_procurement_opportunities

​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_china_decision_signals

​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

​get_forecast_scorecard

​Meta

​describe_tool

Discovering tools

`describe_tool` — full uncompressed definition on demand

`outputSchema` — typed parsing without a sample call

Markets & economy

`get_market_data`

`get_economic_data`

`get_procurement_opportunities`

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

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

`get_forecast_scorecard`

Meta

`describe_tool`