docs/mcp-tools-reference.mdx
Rama main · réplica de lectura del repositorio original.
---
title: "MCP Tools Reference"
sidebarTitle: "Tool index"
description: "Index of every MCP tool World Monitor exposes, grouped by category, linking to per-category pages with parameters, freshness windows, backing API endpoints and example calls."
---
Complete reference for every MCP tool. Use this alongside the [MCP Server overview](/mcp-overview) (connection, auth, plans, errors).
Every tool returns the standard MCP content-block format:
```json
{ "jsonrpc": "2.0", "id": 1, "result": { "content": [{ "type": "text", "text": "{...json payload...}" }] } }
```
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:
```bash
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.
<Tip>
The registry grows over time — `tools/list` (or the [server card](https://worldmonitor.app/.well-known/mcp/server-card.json)) is always the authoritative live inventory. Every tool section below carries an **Access** line (`free`, `free-account`, or `subscription`) matching the `_meta["worldmonitor/access"]` marker the server emits.
</Tip>
## 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](/mcp-overview#api-coverage); 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](/mcp-overview#api-coverage) names the enforced categories and links the current follow-up trackers.
The full guide is on [discovery and typed parsing](/mcp-tools/discovery):
- [`describe_tool` — one tool's definition on demand](/mcp-tools/discovery)
- [`outputSchema` — typed parsing without a sample call](/mcp-tools/discovery)
- [Spoken mode for voice agents](/mcp-tools/discovery)
## Markets & prices
[Markets & prices](/mcp-tools/markets): Market quotes, gold, stock and company research, and prediction markets.
- <span id="get_market_data" className="tool-anchor"></span>[`get_market_data`](/mcp-tools/markets#get_market_data)
- <span id="get_gold_intelligence" className="tool-anchor"></span>[`get_gold_intelligence`](/mcp-tools/markets#get_gold_intelligence)
- <span id="get_stock_research" className="tool-anchor"></span>[`get_stock_research`](/mcp-tools/markets#get_stock_research)
- <span id="get_company_intelligence" className="tool-anchor"></span>[`get_company_intelligence`](/mcp-tools/markets#get_company_intelligence)
- <span id="get_prediction_markets" className="tool-anchor"></span>[`get_prediction_markets`](/mcp-tools/markets#get_prediction_markets)
## Macro & economic data
[Macro & economic data](/mcp-tools/macro): Macro indicators, FRED, Eurostat, debt and capital flows.
- <span id="get_economic_data" className="tool-anchor"></span>[`get_economic_data`](/mcp-tools/macro#get_economic_data)
- <span id="get_fred_series" className="tool-anchor"></span>[`get_fred_series`](/mcp-tools/macro#get_fred_series)
- <span id="get_country_macro" className="tool-anchor"></span>[`get_country_macro`](/mcp-tools/macro#get_country_macro)
- <span id="get_eu_housing_cycle" className="tool-anchor"></span>[`get_eu_housing_cycle`](/mcp-tools/macro#get_eu_housing_cycle)
- <span id="get_eu_quarterly_gov_debt" className="tool-anchor"></span>[`get_eu_quarterly_gov_debt`](/mcp-tools/macro#get_eu_quarterly_gov_debt)
- <span id="get_eu_industrial_production" className="tool-anchor"></span>[`get_eu_industrial_production`](/mcp-tools/macro#get_eu_industrial_production)
- <span id="get_price_and_debt_indicators" className="tool-anchor"></span>[`get_price_and_debt_indicators`](/mcp-tools/macro#get_price_and_debt_indicators)
- <span id="get_capital_flows" className="tool-anchor"></span>[`get_capital_flows`](/mcp-tools/macro#get_capital_flows)
## Trade, tariffs & prices
[Trade, tariffs & prices](/mcp-tools/trade): Trade flows, tariffs, import duties, consumer prices, food stocks and procurement.
- <span id="get_wto_trade_flows" className="tool-anchor"></span>[`get_wto_trade_flows`](/mcp-tools/trade#get_wto_trade_flows)
- <span id="get_tariff_averages" className="tool-anchor"></span>[`get_tariff_averages`](/mcp-tools/trade#get_tariff_averages)
- <span id="get_bilateral_tariff" className="tool-anchor"></span>[`get_bilateral_tariff`](/mcp-tools/trade#get_bilateral_tariff)
- <span id="get_us_import_duty" className="tool-anchor"></span>[`get_us_import_duty`](/mcp-tools/trade#get_us_import_duty)
- <span id="get_consumer_prices" className="tool-anchor"></span>[`get_consumer_prices`](/mcp-tools/trade#get_consumer_prices)
- <span id="get_food_stocks" className="tool-anchor"></span>[`get_food_stocks`](/mcp-tools/trade#get_food_stocks)
- <span id="get_procurement_opportunities" className="tool-anchor"></span>[`get_procurement_opportunities`](/mcp-tools/trade#get_procurement_opportunities)
## Country indicators & resources
[Country indicators & resources](/mcp-tools/country-indicators): NO2 activity, demographics, scorecards, resilience, minerals, mine sites and dated macro history.
- <span id="get_no2_activity" className="tool-anchor"></span>[`get_no2_activity`](/mcp-tools/country-indicators#get_no2_activity)
- <span id="get_demographics_capability" className="tool-anchor"></span>[`get_demographics_capability`](/mcp-tools/country-indicators#get_demographics_capability)
- <span id="get_five_factor_scorecard" className="tool-anchor"></span>[`get_five_factor_scorecard`](/mcp-tools/country-indicators#get_five_factor_scorecard)
- <span id="list_five_factor_scorecards" className="tool-anchor"></span>[`list_five_factor_scorecards`](/mcp-tools/country-indicators#list_five_factor_scorecards)
- <span id="get_resilience_indicators" className="tool-anchor"></span>[`get_resilience_indicators`](/mcp-tools/country-indicators#get_resilience_indicators)
- <span id="get_mineral_production" className="tool-anchor"></span>[`get_mineral_production`](/mcp-tools/country-indicators#get_mineral_production)
- <span id="get_commodity_geo" className="tool-anchor"></span>[`get_commodity_geo`](/mcp-tools/country-indicators#get_commodity_geo)
- <span id="get_macro_history" className="tool-anchor"></span>[`get_macro_history`](/mcp-tools/country-indicators#get_macro_history)
## Energy
[Energy](/mcp-tools/energy): Energy supply, prices, oil trade and supply-shock scenarios.
- <span id="get_energy_intelligence" className="tool-anchor"></span>[`get_energy_intelligence`](/mcp-tools/energy#get_energy_intelligence)
- <span id="get_oil_trade_series" className="tool-anchor"></span>[`get_oil_trade_series`](/mcp-tools/energy#get_oil_trade_series)
- <span id="compute_energy_shock" className="tool-anchor"></span>[`compute_energy_shock`](/mcp-tools/energy#compute_energy_shock)
- <span id="get_supply_chain_cost_shock" className="tool-anchor"></span>[`get_supply_chain_cost_shock`](/mcp-tools/energy#get_supply_chain_cost_shock)
- <span id="get_energy_storage" className="tool-anchor"></span>[`get_energy_storage`](/mcp-tools/energy#get_energy_storage)
## Chokepoints & supply chain
[Chokepoints & supply chain](/mcp-tools/chokepoints-supply-chain): Shipping chokepoints, supply vulnerabilities and supply-chain data.
- <span id="get_chokepoint_status" className="tool-anchor"></span>[`get_chokepoint_status`](/mcp-tools/chokepoints-supply-chain#get_chokepoint_status)
- <span id="get_chokepoint_dependencies" className="tool-anchor"></span>[`get_chokepoint_dependencies`](/mcp-tools/chokepoints-supply-chain#get_chokepoint_dependencies)
- <span id="get_supply_vulnerabilities" className="tool-anchor"></span>[`get_supply_vulnerabilities`](/mcp-tools/chokepoints-supply-chain#get_supply_vulnerabilities)
- <span id="get_supply_chain_data" className="tool-anchor"></span>[`get_supply_chain_data`](/mcp-tools/chokepoints-supply-chain#get_supply_chain_data)
## Conflict & security
[Conflict & security](/mcp-tools/conflict-security): Conflict events, crime data, cyber threats, sanctions, test-site seismicity and defense industry.
- <span id="get_conflict_events" className="tool-anchor"></span>[`get_conflict_events`](/mcp-tools/conflict-security#get_conflict_events)
- <span id="get_toronto_reported_occurrences" className="tool-anchor"></span>[`get_toronto_reported_occurrences`](/mcp-tools/conflict-security#get_toronto_reported_occurrences)
- <span id="get_toronto_calls_attended" className="tool-anchor"></span>[`get_toronto_calls_attended`](/mcp-tools/conflict-security#get_toronto_calls_attended)
- <span id="get_cyber_threats" className="tool-anchor"></span>[`get_cyber_threats`](/mcp-tools/conflict-security#get_cyber_threats)
- <span id="get_sanctions_data" className="tool-anchor"></span>[`get_sanctions_data`](/mcp-tools/conflict-security#get_sanctions_data)
- <span id="get_test_site_seismicity" className="tool-anchor"></span>[`get_test_site_seismicity`](/mcp-tools/conflict-security#get_test_site_seismicity)
- <span id="get_defense_industrial_base" className="tool-anchor"></span>[`get_defense_industrial_base`](/mcp-tools/conflict-security#get_defense_industrial_base)
## Military & escalation
[Military & escalation](/mcp-tools/military-escalation): Military air activity and posture, escalation, convergence, exposure, infrastructure cascades and alerts.
- <span id="get_global_air_activity" className="tool-anchor"></span>[`get_global_air_activity`](/mcp-tools/military-escalation#get_global_air_activity)
- <span id="get_military_surge" className="tool-anchor"></span>[`get_military_surge`](/mcp-tools/military-escalation#get_military_surge)
- <span id="get_military_posture" className="tool-anchor"></span>[`get_military_posture`](/mcp-tools/military-escalation#get_military_posture)
- <span id="get_hotspot_escalation" className="tool-anchor"></span>[`get_hotspot_escalation`](/mcp-tools/military-escalation#get_hotspot_escalation)
- <span id="get_population_exposure" className="tool-anchor"></span>[`get_population_exposure`](/mcp-tools/military-escalation#get_population_exposure)
- <span id="simulate_infrastructure_cascade" className="tool-anchor"></span>[`simulate_infrastructure_cascade`](/mcp-tools/military-escalation#simulate_infrastructure_cascade)
- <span id="get_china_decision_signals" className="tool-anchor"></span>[`get_china_decision_signals`](/mcp-tools/military-escalation#get_china_decision_signals)
- <span id="get_alert_digest" className="tool-anchor"></span>[`get_alert_digest`](/mcp-tools/military-escalation#get_alert_digest)
- <span id="get_signal_convergence" className="tool-anchor"></span>[`get_signal_convergence`](/mcp-tools/military-escalation#get_signal_convergence)
- <span id="get_focal_points" className="tool-anchor"></span>[`get_focal_points`](/mcp-tools/military-escalation#get_focal_points)
## Country intelligence
[Country intelligence](/mcp-tools/countries): Country risk, history, coverage and country briefs.
- <span id="get_country_risk" className="tool-anchor"></span>[`get_country_risk`](/mcp-tools/countries#get_country_risk)
- <span id="get_country_history" className="tool-anchor"></span>[`get_country_history`](/mcp-tools/countries#get_country_history)
- <span id="get_country_coverage" className="tool-anchor"></span>[`get_country_coverage`](/mcp-tools/countries#get_country_coverage)
- <span id="open_country_brief" className="tool-anchor"></span>[`open_country_brief`](/mcp-tools/countries#open_country_brief)
- <span id="get_country_brief_section" className="tool-anchor"></span>[`get_country_brief_section`](/mcp-tools/countries#get_country_brief_section)
- <span id="get_country_brief" className="tool-anchor"></span>[`get_country_brief`](/mcp-tools/countries#get_country_brief)
## News intelligence
[News intelligence](/mcp-tools/news): News intelligence, clusters, media perspective and positive events.
- <span id="get_news_intelligence" className="tool-anchor"></span>[`get_news_intelligence`](/mcp-tools/news#get_news_intelligence)
- <span id="get_news_clusters" className="tool-anchor"></span>[`get_news_clusters`](/mcp-tools/news#get_news_clusters)
- <span id="get_media_perspective" className="tool-anchor"></span>[`get_media_perspective`](/mcp-tools/news#get_media_perspective)
- <span id="get_positive_events" className="tool-anchor"></span>[`get_positive_events`](/mcp-tools/news#get_positive_events)
## Signals & verification
[Signals & verification](/mcp-tools/signals): Event classification, entity extraction, claim verification, social and anomaly signals.
- <span id="classify_event" className="tool-anchor"></span>[`classify_event`](/mcp-tools/signals#classify_event)
- <span id="extract_entities" className="tool-anchor"></span>[`extract_entities`](/mcp-tools/signals#extract_entities)
- <span id="verify_claim" className="tool-anchor"></span>[`verify_claim`](/mcp-tools/signals#verify_claim)
- <span id="get_keyword_spikes" className="tool-anchor"></span>[`get_keyword_spikes`](/mcp-tools/signals#get_keyword_spikes)
- <span id="get_social_velocity" className="tool-anchor"></span>[`get_social_velocity`](/mcp-tools/signals#get_social_velocity)
- <span id="list_x_feed" className="tool-anchor"></span>[`list_x_feed`](/mcp-tools/signals#list_x_feed)
- <span id="get_temporal_anomalies" className="tool-anchor"></span>[`get_temporal_anomalies`](/mcp-tools/signals#get_temporal_anomalies)
## Historical intelligence
[Historical intelligence](/mcp-tools/historical-intelligence): The 180-day historical intelligence archive.
- <span id="search_intel_history" className="tool-anchor"></span>[`search_intel_history`](/mcp-tools/historical-intelligence#search_intel_history)
- <span id="get_intel_timeline" className="tool-anchor"></span>[`get_intel_timeline`](/mcp-tools/historical-intelligence#get_intel_timeline)
- <span id="get_similar_events" className="tool-anchor"></span>[`get_similar_events`](/mcp-tools/historical-intelligence#get_similar_events)
## Movement & infrastructure
[Movement & infrastructure](/mcp-tools/movement-infrastructure): Aviation, airspace, maritime, flights, webcams and infrastructure.
- <span id="get_aviation_status" className="tool-anchor"></span>[`get_aviation_status`](/mcp-tools/movement-infrastructure#get_aviation_status)
- <span id="get_airspace" className="tool-anchor"></span>[`get_airspace`](/mcp-tools/movement-infrastructure#get_airspace)
- <span id="get_maritime_activity" className="tool-anchor"></span>[`get_maritime_activity`](/mcp-tools/movement-infrastructure#get_maritime_activity)
- <span id="search_flights" className="tool-anchor"></span>[`search_flights`](/mcp-tools/movement-infrastructure#search_flights)
- <span id="search_flight_prices_by_date" className="tool-anchor"></span>[`search_flight_prices_by_date`](/mcp-tools/movement-infrastructure#search_flight_prices_by_date)
- <span id="find_webcams" className="tool-anchor"></span>[`find_webcams`](/mcp-tools/movement-infrastructure#find_webcams)
- <span id="get_webcam_media" className="tool-anchor"></span>[`get_webcam_media`](/mcp-tools/movement-infrastructure#get_webcam_media)
- <span id="get_infrastructure_status" className="tool-anchor"></span>[`get_infrastructure_status`](/mcp-tools/movement-infrastructure#get_infrastructure_status)
- <span id="get_internet_activity" className="tool-anchor"></span>[`get_internet_activity`](/mcp-tools/movement-infrastructure#get_internet_activity)
## Environment, science & health
[Environment, science & health](/mcp-tools/environment-health): Climate, cyclones, natural disasters, radiation, research and health signals.
- <span id="get_climate_data" className="tool-anchor"></span>[`get_climate_data`](/mcp-tools/environment-health#get_climate_data)
- <span id="get_imd_cyclone_marine" className="tool-anchor"></span>[`get_imd_cyclone_marine`](/mcp-tools/environment-health#get_imd_cyclone_marine)
- <span id="get_natural_disasters" className="tool-anchor"></span>[`get_natural_disasters`](/mcp-tools/environment-health#get_natural_disasters)
- <span id="get_radiation_data" className="tool-anchor"></span>[`get_radiation_data`](/mcp-tools/environment-health#get_radiation_data)
- <span id="get_research_signals" className="tool-anchor"></span>[`get_research_signals`](/mcp-tools/environment-health#get_research_signals)
- <span id="get_health_signals" className="tool-anchor"></span>[`get_health_signals`](/mcp-tools/environment-health#get_health_signals)
## Humanitarian & displacement
[Humanitarian & displacement](/mcp-tools/humanitarian-displacement): Cross-border arrivals and displacement data.
- <span id="get_cross_border_arrivals" className="tool-anchor"></span>[`get_cross_border_arrivals`](/mcp-tools/humanitarian-displacement#get_cross_border_arrivals)
- <span id="get_displacement_data" className="tool-anchor"></span>[`get_displacement_data`](/mcp-tools/humanitarian-displacement#get_displacement_data)
## AI intelligence
[AI intelligence](/mcp-tools/ai-intelligence): The world brief, situation analysis and forecasts.
- <span id="get_world_brief" className="tool-anchor"></span>[`get_world_brief`](/mcp-tools/ai-intelligence#get_world_brief)
- <span id="analyze_situation" className="tool-anchor"></span>[`analyze_situation`](/mcp-tools/ai-intelligence#analyze_situation)
- <span id="get_forecast_predictions" className="tool-anchor"></span>[`get_forecast_predictions`](/mcp-tools/ai-intelligence#get_forecast_predictions)
- <span id="get_forecast_case" className="tool-anchor"></span>[`get_forecast_case`](/mcp-tools/ai-intelligence#get_forecast_case)
- <span id="get_forecast_theaters" className="tool-anchor"></span>[`get_forecast_theaters`](/mcp-tools/ai-intelligence#get_forecast_theaters)
- <span id="get_forecast_scorecard" className="tool-anchor"></span>[`get_forecast_scorecard`](/mcp-tools/ai-intelligence#get_forecast_scorecard)
## Meta & apps
[Meta & apps](/mcp-tools/meta): Sources, allowance, upgrades, tool discovery, issue reports and MCP app views.
- <span id="get_sources" className="tool-anchor"></span>[`get_sources`](/mcp-tools/meta#get_sources)
- <span id="get_mcp_allowance" className="tool-anchor"></span>[`get_mcp_allowance`](/mcp-tools/meta#get_mcp_allowance)
- <span id="start_upgrade" className="tool-anchor"></span>[`start_upgrade`](/mcp-tools/meta#start_upgrade)
- <span id="describe_tool" className="tool-anchor"></span>[`describe_tool`](/mcp-tools/meta#describe_tool)
- <span id="report_issue" className="tool-anchor"></span>[`report_issue`](/mcp-tools/meta#report_issue)
- <span id="open_news_dashboard" className="tool-anchor"></span>[`open_news_dashboard`](/mcp-tools/meta#open_news_dashboard)
- <span id="analyze_news_headlines" className="tool-anchor"></span>[`analyze_news_headlines`](/mcp-tools/meta#analyze_news_headlines)