MCP Tools Reference

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

export WM_KEY="wm_0123456789abcdef0123456789abcdef01234567"  # or use the OAuth bearer token instead — see /mcp-overview#authentication

​

Discovering tools

​

describe_tool — full uncompressed definition on demand

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

{
  "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},\"_meta\":{ /* … */ }}"
      }
    ],
    "structuredContent": { "name": "get_chokepoint_status", "description": "…", "inputSchema": {}, "outputSchema": {}, "annotations": {}, "_meta": {} }
  }
}

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

• { "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.

​

outputSchema — typed parsing without a sample call

{
  "type": "object",
  "anyOf": [
    { "…": "the tool's documented shape — the schema shown below" },
    { "required": ["projection"] },
    { "required": ["data", "_attribution"] },
    { "required": ["_budget_exceeded"] },
    { "required": ["_jmespath_error"] }
  ]
}

{
  "type": "object",
  "properties": {
    "countryCode": { "type": "string" },
    "countryName": { "type": "string" },
    "cii": {
      "type": ["object", "null"],
      "description": "Absent when the country is not tracked, and always absent when upstreamUnavailable is true.",
      "properties": {
        "combinedScore": { "type": "number", "description": "The headline CII, 0-100." },
        "trend": { "type": "string", "enum": ["TREND_DIRECTION_UNSPECIFIED", "TREND_DIRECTION_RISING", "TREND_DIRECTION_STABLE", "TREND_DIRECTION_FALLING"] },
        "components": {
          "type": "object",
          "description": "Names are historical and do NOT describe their contents -- read the descriptions.",
          "properties": {
            "ciiContribution":  { "type": "number", "description": "DOMESTIC UNREST contribution." },
            "geoConvergence":   { "type": "number", "description": "ARMED CONFLICT contribution." },
            "militaryActivity": { "type": "number", "description": "SECURITY AND MOBILITY contribution." },
            "newsActivity":     { "type": "number", "description": "INFORMATION ENVIRONMENT contribution." }
          }
        }
      }
    },
    "advisoryLevel":   { "type": "string" },
    "sanctionsActive": { "type": "boolean" },
    "sanctionsCount":  { "type": "number" },
    "fetchedAt":       { "type": "number", "description": "Unix epoch ms; 0 means unknown." },
    "upstreamUnavailable": { "type": "boolean", "description": "True when ANY required upstream read failed; the whole response is withheld, so the zeroed risk fields mean UNKNOWN, not low." }
  }
}

{
  "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 fails its freshness contract: fetched longer ago than its per-key maxStaleMin budget, below a declared minRecordCount, or — for keys that declare a content-age contract — carrying upstream observations older than maxContentAgeMin even though the fetch itself is recent. A recent cached_at with stale:true means the fetch is current but the underlying data has stopped advancing, so refetching will not help." },
    "data":      { "type": "object", "properties": { /* per-tool fields */ } }
  }
}

// Synthesise types from the schema once (e.g. with json-schema-to-typescript).
type CountryRisk = {
  countryCode: string;
  countryName: string;
  // The four component names are historical misnomers: ciiContribution is
  // domestic unrest, geoConvergence is armed conflict, militaryActivity is
  // security/mobility, newsActivity is the information environment.
  cii?: {
    combinedScore: number;
    trend: 'TREND_DIRECTION_UNSPECIFIED' | 'TREND_DIRECTION_RISING' | 'TREND_DIRECTION_STABLE' | 'TREND_DIRECTION_FALLING';
    components?: { ciiContribution: number; geoConvergence: number; militaryActivity: number; newsActivity: number };
  };
  advisoryLevel: string;
  sanctionsActive: boolean;
  sanctionsCount: number;
  fetchedAt: number;
  // Check this BEFORE reading any score: true means a required upstream
  // read failed and the response was withheld — the zeroed fields are
  // unknown, not calm.
  upstreamUnavailable: boolean;
};

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?.combinedScore, parsed.cii?.components?.geoConvergence);
}

• 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.
• The documented shape (anyOf[0]) describes the success-path payload only. The two catalog-class soft envelopes (_budget_exceeded, _jmespath_error) replace the payload entirely; since v1.21.0 each has its own branch in the advertised anyOf, as do projections, so a strict client accepts them. See the MCP Error Catalog for both envelopes.

• 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

• API endpoints: GET /api/market/v1/get-fear-greed-index, GET /api/market/v1/get-physical-divergence-index, GET /api/market/v1/get-physical-premiums, 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
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• Paid panel accounting: Pro and Pro Business spend one allocation for the initial market panel. Subsequent curated filters and repeated opens reuse that admission within its five-minute window. The result’s panelRequest.token can be passed as panel_request for authorized reads until expiry. A new refresh UUID spends one new allocation. API plans retain weighted per-tool billing. Free-account calls retain their daily free allowance.
• Source scope: filters select already-seeded quotes. Neither a receipt nor refresh fetches an arbitrary symbol, an account watchlist, or new provider data. Unavailable or stale results remain eligible for retry under the same valid receipt. An upstream failure does not refund the initial allocation.
• Note on the physical datasets: the two REST routes behind physicalPremium and physicalDivergence are Pro-only (tier 1) when called directly — see Pro Intelligence Suite. This bundled cache read is the one path on which a signed-in free account can reach them, within its allowance. That is deliberate; do not infer from it that the REST routes are open.
• Kind: cache read — sub-second response from Redis bootstrap cache.
• Freshness budget: the stale flag tracks the market and sector snapshots only (30 min each). The daily physicalPremiums and physicalDivergence datasets are monitored on /api/health instead. Read their timestamps and the divergence state when age matters. The divergence method is documented in Physical Precious-Metals Divergence Index.
• Sector valuationCoverage separates write age (stale) from completeness (sourceStatus: ok, partial, or degraded). stale describes the seed write, not the individual records — a freshly written payload can still contain older valuations. valuationCount and expectedValuationCount follow a symbols filter when one is supplied. valuationCount counts live and replayed records together; currentValuationCount gives the subset actually fetched this cycle and is omitted when every record is current. staleValuationSymbols lists symbols served from an older snapshot — those symbols do have values in valuations, and lastGood.fetchedAt gives their age (bounded by a 7-day snapshot TTL). unavailableSymbols lists symbols with no valuation published at all, and is disjoint from staleValuationSymbols. lastGood covers both whole records and borrowed return metrics, and includes that snapshot’s timestamp. sourceStatus is degraded when no record is current, partial when some are stale or missing. valuationDiagnostics is bounded per-symbol route metadata across the v7Quote, v7QuoteBatch, and quoteSummary routes, showing independent direct/proxy outcomes, response classes, and missing fields; it never contains credentials.

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

• API endpoints: GET /api/economic/v1/get-china-macro-snapshot, 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
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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).
• Per-dataset caveat: the single stale flag is derived from a subset of these sub-datasets, so it is not a per-dataset guarantee. cbr-rates is not one of them — it is published daily on a 3-day staleness budget with a 14-day content-age contract, both monitored on /api/health rather than through this flag. Read cbr-rates.effectiveDate when the age of that dataset specifically matters.

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

• API endpoint: GET /api/economic/v1/list-global-tenders
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• 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.

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_company_intelligence

• API endpoints: GET /api/intelligence/v1/get-company-enrichment, GET /api/intelligence/v1/list-company-signals, GET /api/intelligence/v1/search-sec-filings, GET /api/intelligence/v1/list-material-events
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: canonical-route proxy — enrichment fans out to SEC submissions, Finnhub profile + earnings surprises, and news mentions; signals uses timestamped SEC filings + news (not fiscal period ends). Each upstream is independently cached. filings-search proxies EDGAR full-text search; material-events reads the seeded market-wide 8-K stream (30-minute cadence).
• Freshness: every view’s payload carries its own timestamp (enrichedAtMs, discoveredAtMs, fetchedAtMs); material-events.fetchedAtMs is the seed time of the stream snapshot.

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_company_intelligence","arguments":{"ticker":"AAPL","view":"signals"}}
  }'

​

get_country_macro

• API endpoints: none directly — reads from a bootstrap-aggregate cache key (no 1:1 REST endpoint).
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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

• API endpoints: none directly — reads from a bootstrap-aggregate cache key (no 1:1 REST endpoint).
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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

• API endpoints: none directly — reads from a bootstrap-aggregate cache key (no 1:1 REST endpoint).
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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

• API endpoints: none directly — reads from a bootstrap-aggregate cache key (no 1:1 REST endpoint).
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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

• 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
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• Kind: cache read — sub-second response from Redis bootstrap cache.
• Freshness budget: per sub-dataset — tariffs 7 h, BigMac 7 d, FAO FFPI and national debt 60 d each. The single stale flag ORs all four checks: it flips as soon as any one sub-dataset exceeds its own budget, tariffs in practice being the tightest.

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_wto_trade_flows

• API endpoint: GET /api/trade/v1/get-trade-flows
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: RPC proxy over the canonical trade-flows route (the handler owns window slicing and miss classification).
• Freshness budget: up to 7 h before stale (6 h seeder cadence plus one hour of grace).

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_wto_trade_flows","arguments":{"reporter":"840","years":20}}
  }'

​

get_consumer_prices

• 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
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: RPC tool that reads Upstash directly (sub-second) — requires an input parameter to select the slice. Despite the cache-speed reads, it is an _execute tool, which is why its access class is subscription and it takes no summary argument.
• 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_food_stocks

• API endpoints: GET /api/resilience/v1/get-food-stocks
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: RPC proxy — the handler owns WORLD vs ISO-2 and commodity filtering.
• Freshness budget: oldest world marketing year present (WASDE monthly cycle; 60-day fetch-age / 120-day content-age).

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_food_stocks","arguments":{"country_code":"EG","commodity":"wheat"}}
  }'

​

get_demographics_capability

• API endpoint: GET /api/resilience/v1/get-demographics-capability
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: subscription RPC proxy over the annual demographics seed.
• Freshness: read each observation’s year; it is the source observation year, not the seed run year. Stage metadata reports whether the current snapshot is fresh, retained a last-good stage, or is unavailable.

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_demographics_capability","arguments":{"country_code":"DE"}}
  }'

​

get_five_factor_scorecard

• API endpoints: GET /api/scorecard/v1/get-five-factor-scorecard, GET /api/scorecard/v1/get-bloc-scorecard
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument; use jmespath to trim evidence.
• Kind: canonical RPC proxy over scorecard:five-factor:v1; it does not fetch source datasets at request time.
• Freshness: daily seed with a 36-hour freshness budget. Read computedAt, methodologyVersion, and the seed health metadata separately when operational freshness matters.

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_five_factor_scorecard","arguments":{"country_code":"DE"}}
  }'

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_five_factor_scorecard","arguments":{"preset":"ASEAN"}}
  }'

​

list_five_factor_scorecards

• Parameters: none
• API endpoint: GET /api/scorecard/v1/list-five-factor-scorecards
• Access: subscription — requires a Pro subscription.
• Kind: compact projection of the same atomic scorecard:five-factor:v1 snapshot.

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

​

get_resilience_indicators

• API endpoint: GET /api/resilience/v1/get-resilience-indicators
• Access: subscription — requires a Pro subscription on both the REST and MCP paths.
• Kind: request-local trace of the scorer branch that actually ran; it is not a second scoring implementation.
• Freshness: reads the immutable trace generation referenced by the six-hour public score cache. The trace lives in a separate seven-hour sidecar so score and ranking reads stay small.

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_resilience_indicators","arguments":{"country_code":"DE"}}
  }'

​

get_mineral_production

• API endpoints: GET /api/supply-chain/v1/get-mineral-production
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: RPC fetch — proxies GET /api/supply-chain/v1/get-mineral-production, which serves the Redis seed supply-chain:mineral-production:v1. An _execute tool, hence subscription access and no summary argument.
• Freshness budget: annual MCS edition. Withheld USGS values stay flagged and are never treated as zero.

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_mineral_production","arguments":{"commodity":"cobalt","stage":"mine"}}
  }'

​

get_commodity_geo

• API endpoints: none — this tool reads no cache and makes no HTTP fetch.
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• 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. Implemented as an _execute tool, so its access class is subscription and it takes no summary argument despite making no fetch.

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

• API endpoints: GET /api/prediction/v1/list-prediction-markets
• Access: free-account. Any signed-in account can call this tool. Free accounts spend their daily free allowance. API plans retain weighted per-tool billing. Accepts the universal summary argument.
• Paid panel accounting: Pro and Pro Business spend one allocation for an opening. Canonical filters and repeated opens share the prediction admission within five minutes. The returned panelRequest.token authorizes curated prediction reads until expiry. Local category expansion reads loaded data without another tool call. Each admission permits at most 64 uncached tool executions, with separate 64-per-minute uncached and cached-replay limits. Those executions are not individual Redis commands.
• Limits and refresh: The default limit is 30 per category. Zero or negative values apply no cap; positive fractions use the integer part. Default refresh: false reuses the prediction admission. Set refresh: true with a UUID request_id and omit panel_request to start a new allocation. Retries with the same UUID, including different letter case, reuse the allocation and its original expiry.
• Paid argument validation: Category and source trim whitespace and ignore letter case. Query matching ignores letter case and surrounding whitespace. Paid calls reject unknown arguments, invalid categories or sources, and non-finite or non-numeric limits before reservation. Ordinary API and free calls retain their existing filter coercion. Refresh controls and paid receipts are unavailable to API and free calls.
• Reuse and recovery: Identical canonical filters replay successful original results before summary or JMESPath projection. A new uncached filter reads the existing bootstrap and freshness metadata. A fresh, valid filtered-empty result can replay. Stale, unavailable, malformed, and unknown observations remain retryable under the receipt. Upstream failures do not refund the opening.
• Usage notices: An explicit authorized receipt read also reads the current daily allowance without reserving another unit. If the counter is unavailable or unconfirmed, contracts remain available without a numeric notice. A previous opening notice does not prove later accounting.
• Kind: cache read from the 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

​

compute_energy_shock

• API endpoint: GET /api/intelligence/v1/compute-energy-shock.
• Access: subscription; existing metering, gateway checks, billing denial and retry/backoff apply. Derived results may be cached; no user scenario or trade is saved.

​

get_supply_chain_cost_shock

• API endpoints: GET /api/supply-chain/v1/get-country-cost-shock, GET /api/supply-chain/v1/get-multi-sector-cost-shock.
• Access: subscription; existing metering, gateway checks, billing denial and retry/backoff contracts apply. The tool reads existing seeds and computes a scenario without saving it.

​

get_stock_research

• API endpoints: GET /api/market/v1/analyze-stock, GET /api/market/v1/backtest-stock, GET /api/market/v1/get-stock-analysis-history, GET /api/market/v1/list-stored-stock-backtests.
• Access: subscription. Existing MCP metering, gateway subscription checks, provider quotas, billing denial and retry/backoff contracts remain active. Cold analysis may take longer than seeded reads. The tool may save shared snapshots, so its read-only and idempotent hints are false; its destructive hint is false.
• Output budget: 512 KiB. For a large watchlist use fewer symbols/snapshots or jmespath to select the fields needed. A budget-exceeded envelope is not complete history.

​

get_gold_intelligence

• API endpoint: GET /api/market/v1/get-gold-intelligence.
• Access: subscription. One signed downstream GET uses the standard API allowance weight of 2; a dedicated MCP allowance charges one call. Billing denial and retry/backoff contracts remain active.
• Output budget: 128 KiB. The tool is read-only and does not create a trade or research snapshot.

​

get_internet_activity

• API endpoints: GET /api/infrastructure/v1/list-internet-traffic-anomalies, GET /api/infrastructure/v1/list-internet-ddos-attacks.
• Access: subscription. One signed downstream GET uses the standard API allowance weight of 2; a dedicated MCP allowance charges one call. Billing denial and retry/backoff contracts remain active.
• Output budget: 128 KiB. The tool is read-only.

​

get_macro_history

• API endpoints: GET /api/economic/v1/get-us-cpi-monthly, GET /api/economic/v1/get-us-interest-rates, GET /api/economic/v1/get-us-treasury-par-yield-curve, GET /api/economic/v1/get-world-cpi-monthly, GET /api/economic/v1/get-government-yield-curve
• Access: subscription. Each call makes one signed gateway request and uses the existing MCP quota policy. It accepts the universal jmespath argument.
• Example: {"dataset":"government-yields","country":"Japan","limit":30} returns the newest available Japanese curve observations.

​

get_energy_intelligence

• 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
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• Kind: cache read — sub-second response from Redis bootstrap cache.
• Freshness budget: per slice — most daily-seeded slices (electricity prices, Ember, gas storage, fuel shortages) allow 48 h and EIA petroleum 72 h; slower registries (disruptions, renewable/fossil shares, crisis policies) allow 7 d to ~400 d. The single stale flag ORs every check, so it flips as soon as any one slice exceeds its own budget.

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

​

get_energy_storage

• API endpoints: GET /api/economic/v1/get-eu-gas-storage, GET /api/economic/v1/get-nat-gas-storage, GET /api/economic/v1/get-crude-inventories
• Access: free-account. Authentication and the existing daily allowance apply. Pro calls spend the daily quota. This tool only reads seeded caches and accepts the universal summary and jmespath arguments.
• Freshness budget: 48 hours for daily EU storage and 14 days for weekly US observations.

​

Geopolitical & security

​

get_conflict_events

• API endpoints: GET /api/conflict/v1/list-iran-events, GET /api/conflict/v1/list-ucdp-events, GET /api/unrest/v1/list-unrest-events
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• Paid panel accounting: Pro and Pro Business spend one allocation for an opening. Canonical filters and repeated opens share the Conflict Events admission within five minutes. Each admission permits up to 64 uncached tool executions, with separate 64-per-minute uncached and successful cached-replay limits. Each execution reads five fixed Redis keys, or six with Iran enabled; these reads do not each spend an allocation.
• Reuse and refresh: Successful filtered originals replay before summary or JMESPath presentation. Explicit refresh with a new UUID spends one new allocation; the same UUID retries it. An authorized receipt read queries current usage without reserving another unit. Unknown counters preserve data and omit the numeric notice. Paid calls reject unknown arguments and non-finite numeric filters before reservation. Ordinary API and free calls retain existing filter coercion and reject paid receipts or refresh controls.
• Source observation and recovery: Optional conflict_source.ucdp preserves only correctly typed fetchedAt, candidateVersion, candidateComplete and annualFailedPages from already-read metadata. Missing fields stay absent. Known partial, missing, malformed, stale or incompatible observations remain retryable. Usable collections still honor their filters. Data and metadata are not an atomic snapshot; the observation does not prove complete unrest-provider coverage or independent CII/Iran freshness.
• Kind: cache read — sub-second response from Redis bootstrap cache.
• Freshness budget: per slice — UCDP conflict events 30 min, unrest events 2 h. The single stale flag ORs both checks, so it flips as soon as either slice exceeds its own budget.

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_toronto_reported_occurrences

• API endpoints: GET /api/safety/v1/get-toronto-safety
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• Kind: bounded cache read from the on-demand TPS Major Crime Indicators snapshot.
• Freshness budget: up to 14 days before stale: true is flagged; source-content freshness is also validated before the canonical snapshot is published.

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_toronto_reported_occurrences","arguments":{"division":"52","limit":25}}
  }'

​

get_toronto_calls_attended

• API endpoints: GET /api/safety/v1/get-toronto-safety
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• Kind: bounded cache read from the on-demand TPS Calls for Service Attended snapshot.
• Freshness budget: up to 14 days before stale: true is flagged; source-content freshness is also validated before the canonical snapshot is published.

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_toronto_calls_attended","arguments":{"year":2025,"limit":25}}
  }'

​

get_country_risk

• API endpoints: GET /api/intelligence/v1/get-country-risk
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: live RPC on an uncached execution. Accepted paid originals replay within the same-country admission. Edge-runtime timeout: 8.0s. CII time does not prove advisory or sanctions freshness.

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_coverage

• API endpoints: GET /api/intelligence/v1/get-country-coverage
• Access: subscription — requires a Pro subscription, matching get_country_brief and get_country_risk. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: live RPC — proxies a fetch to the WorldMonitor API on each call. Edge-runtime timeout: 15.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_coverage","arguments":{"country_code":"IL"}}
  }'

​

list_x_feed

• API endpoints: GET /api/intelligence/v1/list-x-feed
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: live RPC — proxies a fetch to the WorldMonitor API on each call. Edge-runtime timeout: 10.0s.
• Content policy: post text is R4. MCP/embed partners receive facts + permalink only.

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":"list_x_feed","arguments":{"limit":20,"topic":"breaking"}}
  }'

​

get_defense_industrial_base

• API endpoint: GET /api/military/v1/get-defense-industrial-base
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: live RPC backed by two annual Redis snapshots.
• Freshness: industrialFetchedAt and supplierFetchedAt report the two source clocks separately. supplierRetained identifies an importer row that was previously published and not refreshed in this tick (chunk carry-forward, or a failed importer request); fetchedAt is the older clock among the values served. Seeder liveness alarms after 28 days, and source observation years are checked separately against the annual content-age budget.
• Mapping: supplierMappingCoverage reports the share of positive supplier TIV mapped to ISO2 suppliers. Supplier shares and HHI keep unmapped positive TIV in the denominator.
• Licensing: the response contains derived SIPRI aggregates only and identifies SIPRI as the source. It does not reproduce the full database.

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_defense_industrial_base","arguments":{"country_code":"UA"}}
  }'

​

open_country_brief

​

get_country_brief_section

​

get_country_brief

• API endpoints: GET /api/intelligence/v1/get-country-intel-brief
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: live RPC on an uncached execution. Accepted paid originals replay per country and effective analysis within the shared country admission. Incomplete or retained grounding remains retryable. Worst-case total budget ~24s (2s context-digest fetch + 22s brief generation, sequential). Explicit refresh does not bypass the backend’s six-hour brief cache. API weights and free-account denial remain unchanged.
• 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.
• Corroboration: returns a separate groundingStories array for the digest articles used as grounding, each with corroborationCount (distinct outlets carrying the story at digest time), mentionCount, and lifecycle storyPhase. It is independent of sources, which may instead carry the server-side grounding set, and is empty when the digest read failed. Cite from sources; use groundingStories to weigh how well-reported the underlying claims are.

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

• API endpoints: GET /api/intelligence/v1/list-cross-source-signals, GET /api/intelligence/v1/search-gdelt-documents
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• Kind: cache read — sub-second response from Redis bootstrap cache.
• Corroboration: every top story carries uniqueSourceCount, corroborationSourceCount, entityCorroboration, sourceTier, the contributing outlet names in sources, and every clustered headline in memberTitles, alongside lastUpdated, upstreamImportanceScore, effectiveImportanceScore, and credibilityScore (0-100 source reliability, distinct from importance; state-controlled media is capped at 40).
• Freshness budget: per slice — news insights 30 min, GDELT intel 45 min, cross-source signals 60 min. The single stale flag ORs every check, so it flips as soon as any one slice exceeds its own budget.

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

​

classify_event

• API endpoint: GET /api/intelligence/v1/classify-event
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: bounded canonical-route proxy over an LLM classifier. This op was previously parity-excluded as llm-passthrough; the 24h per-title cache absorbs repeats and the classifier is capped at 50 output tokens.
• Quota: standard — every call consumes the MCP daily reservation for OAuth and dashboard-issued wm_… key contexts (50/UTC day by default). Only legacy operator keys explicitly allowlisted by the deployment skip that daily reservation; every authenticated context remains bounded by the 60 requests/minute limiter.

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":"classify_event","arguments":{"text":"Iran closes Strait of Hormuz to tanker traffic"}}
  }'

​

extract_entities

• API endpoint: GET /api/news/v1/list-feed-digest (headlines mode only; text mode performs no fetch).
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: deterministic local compute over the shared extraction cores. In headlines mode, entities aggregate to mentionCount/avgConfidence; in text mode each match reports matchType, matchedText, and confidence.
• Quota: standard — every call consumes the MCP daily reservation.

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":"extract_entities","arguments":{"text":"CVE-2026-12345 exploited by APT28 against Microsoft cloud tenants"}}
  }'

​

get_news_clusters

• API endpoint: GET /api/news/v1/list-feed-digest
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: deterministic local compute — clustering runs per call over the ~150-200 digest headlines (CDN/Redis-cached upstream, 15-min cadence).
• Quota: standard — every call consumes the MCP daily reservation.

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_clusters","arguments":{"category":"commodities","min_sources":2,"limit":10}}
  }'

​

get_keyword_spikes

• API endpoint: none — reads the story accumulator and story-track keys from Redis directly; no HTTP endpoint is proxied.
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: deterministic local compute with a 10-minute Redis result cache. note is present when the accumulator is unavailable/empty or the story store was only partially readable — a partial read is never cached, so a transient Redis fault cannot serve wrong spikes for the rest of the TTL.
• Quota: standard — every call consumes the MCP daily reservation.

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_keyword_spikes","arguments":{"window_hours":2,"limit":10}}
  }'

​

get_cyber_threats

• API endpoints: none directly — reads from a bootstrap-aggregate cache key (no 1:1 REST endpoint).
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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

• API endpoints: GET /api/sanctions/v1/list-sanctions-pressure, GET /api/sanctions/v1/lookup-sanction-entity
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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

• API endpoints: GET /api/intelligence/v1/get-social-velocity
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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_temporal_anomalies

• API endpoints: none (MCP-only; the REST baseline endpoints are write-through and excluded from parity).
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• Kind: cache-only read — sub-second response from Redis bootstrap cache. MCP calls do not invoke the producer or trigger a rebuild.
• Freshness budget: up to 45 min before stale: true is flagged. Only traffic to the underlying producer route/RPC (GET /api/infrastructure/v1/list-temporal-anomalies) triggers an on-demand rebuild once the snapshot is older than 20 min. cached_at records that rebuild — not the time of the MCP call — so it advances only when the producer route rebuilds the snapshot. With no traffic to that route, the request-driven stamp can age past the budget.

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_temporal_anomalies","arguments":{"min_severity":"high"}}
  }'

​

get_test_site_seismicity

• API endpoints: none (MCP-only; the underlying earthquake list is covered by get_natural_disasters).
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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_test_site_seismicity","arguments":{"min_concern":"moderate"}}
  }'

​

get_signal_convergence

• API endpoints: none (MCP-only derived analysis).
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: derived analysis — shared dashboard engine over Redis seed caches.
• Freshness budget: per-feed (flights 30 min, unrest 120 min, earthquakes 30 min, fleet 720 min); stale: true when any feed exceeds its budget.

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_signal_convergence","arguments":{"min_domains":3}}
  }'

​

get_focal_points

• API endpoints: none (MCP-only derived analysis).
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: derived analysis — shared dashboard engine over Redis seed caches.
• Freshness budget: up to 30 min per contributing feed before stale: true.

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_focal_points","arguments":{"limit":5}}
  }'

​

simulate_infrastructure_cascade

• API endpoints: none (MCP-only derived analysis).
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: derived analysis — dependency graph built per request from the seeded cable table.
• Freshness budget: up to 25200 min (~17.5 days) for the weekly cable table before stale: true.

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":"simulate_infrastructure_cascade","arguments":{"source_id":"chokepoint:hormuz_strait","disruption_level":0.8}}
  }'

​

get_military_surge

• API endpoints: none (MCP-only derived analysis; posture aggregates are also served by get_military_posture).
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: derived analysis — shared dashboard engine over Redis seed caches.
• Freshness budget: flights 30 min, theater posture 60 min before stale: true.

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_surge","arguments":{"theater":"taiwan"}}
  }'

​

get_population_exposure

• API endpoints: GET /api/displacement/v1/get-population-exposure
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: derived analysis — shared exposure core; events mode reads Redis seed caches.
• Freshness budget: per-feed (earthquakes 30 min, wildfires 360 min, conflicts 1440 min); point and countries modes are computed, cached_at: null.

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_population_exposure","arguments":{"event_source":"earthquakes"}}
  }'

​

get_alert_digest

• API endpoints: none (MCP-only derived analysis).
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: derived analysis — shared digest core over seven Redis seed caches.
• Freshness budget: per-feed (30-360 min); stale: true when any contributing feed exceeds its budget.

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_alert_digest","arguments":{"view":"today"}}
  }'

​

get_hotspot_escalation

• API endpoints: none (MCP-only derived analysis).
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: derived analysis — shared dashboard engine over Redis seed caches.
• Freshness budget: up to 30 min for news/risk/flights, 120 min for unrest before stale: true.

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_hotspot_escalation","arguments":{"limit":10}}
  }'

​

get_china_decision_signals

• Parameters: none, apart from the optional common jmespath projection.
• API endpoint: GET /api/intelligence/v1/get-china-decision-signals
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• 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

• API endpoints: GET /api/military/v1/get-theater-posture
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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

• API endpoints: GET /api/intelligence/v1/get-country-port-activity, GET /api/supply-chain/v1/get-chokepoint-status
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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.
• Per-country content freshness (PortWatch slice): stale: true also flags when a decision-critical country’s own observation (CN/HK) is older than 72 h, even though the run’s heartbeat is fresh and all 174 countries are published. The seeder reuses a cached country payload while upstream max(date) has not advanced, so transport age and record count both read healthy while an individual country’s data is days old. This mirrors the STALE_CONTENT verdict on /api/health for the same seed key — see Health endpoints. stale stays a single boolean, so it does not say which dimension tripped; /api/health names the stale country.

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_supply_vulnerabilities

• API endpoint: GET /api/supply-chain/v1/get-country-vulnerabilities
• Access: subscription — this RPC-backed tool requires a Pro subscription.
• Kind: Redis projection read from supply-chain:vulnerability:v1.
• Freshness: the daily snapshot has a 72-hour TTL. Read each row’s state, reasons, and evidence stale fields because upstream datasets have different freshness budgets.
• Methodology: Commodity Vulnerability Methodology.

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_supply_vulnerabilities","arguments":{"country_code":"AE"}}}

​

get_chokepoint_dependencies

• API endpoint: GET /api/supply-chain/v1/get-chokepoint-dependencies
• Access: subscription — this RPC-backed tool requires a Pro subscription.
• Kind: Redis projection read from supply-chain:chokepoint-dependencies:v1.
• Freshness: the daily snapshot has a 72-hour TTL. An unscored dependency remains in the response with its explicit state and reasons.
• Methodology: Commodity Vulnerability Methodology.

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_chokepoint_dependencies","arguments":{"chokepoint_id":"hormuz_strait","page_size":25}}}

​

get_positive_events

• API endpoints: GET /api/positive-events/v1/list-positive-geo-events
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• 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":{}}
  }'

​

Historical intelligence

​

search_intel_history

• API endpoint: POST /api/intelligence/v1/search-intel-history
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: live RPC — embeds the query, then ranks the history store. Edge-runtime timeout: 12.0s.
• Cost note: every call spends one embeddings round-trip, so the route is rate-limited fail-closed. Prefer one well-phrased query over several near-duplicates.

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_intel_history","arguments":{"query":"port closure after drone strike","domain":"conflict","limit":10}}
  }'

​

get_intel_timeline

• API endpoint: GET /api/intelligence/v1/get-intel-timeline
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: live RPC — one store read, no embedding. 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_intel_timeline","arguments":{"country":"UA","domain":"conflict","limit":50}}
  }'