app.worldmonitor/mcp

Official39 tools

by koala73 · TypeScript

World Monitor

Live global intelligence: real-time markets, conflicts, country risk, chokepoints, energy. 39 tools.

Real-time global intelligence on markets, conflicts, risks, and energy with 39 tools.

global intelligencereal-time marketsgeopolitical riskcountry risk assessmentenergy monitoringconflict tracking

Topics

aidashboardgeopoliticsmonitoringnewsosintopensourcepalantirsituationagentmcpmcp-server

Captured live from the server via tools/list.

get_market_data

Real-time equity quotes, commodity prices (including gold futures GC=F), crypto prices, forex FX rates (USD/EUR, USD/JPY

Parameters (5)

symbolsarray
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_classarray
Restrict the response to one or more asset classes. Omit for all.
limitnumber
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).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_conflict_events

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

Parameters (5)

countrystring
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_fatalitiesnumber
Drop events below this fatality count (UCDP deathsBest / unrest fatalities).
limitnumber
Cap each event list to at most this many items (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_aviation_status

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

Parameters (6)

disrupted_onlyboolean
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.
countrystring
Filter to one country by name (case-insensitive substring, e.g. "united states").
iatastring
Filter to a single airport by IATA code (e.g. "JFK").
limitnumber
Cap the alert list to at most this many items (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_news_intelligence

AI-classified geopolitical threat news summaries, GDELT intelligence signals, cross-source signals, and security advisor

Parameters (7)

topicstring
Filter GDELT intelligence to a single topic.
categorystring
Filter top news stories to one category (e.g. "conflict", "economy"; fallback is "general").
countrystring
Filter top stories and travel advisories to one ISO 3166-1 alpha-2 country code (case-insensitive).
alerts_onlyboolean
Keep only top stories flagged as alerts.
limitnumber
Cap each list (top stories, signals, advisories) to at most this many items (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_natural_disasters

Recent earthquakes (USGS), active wildfires (NASA FIRMS), and natural hazard events.

Parameters (6)

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

get_military_posture

Theater posture assessment and military risk scores.

Parameters (5)

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

get_cyber_threats

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

Parameters (6)

threat_typestring
Filter to one threat type (case-insensitive substring, e.g. "malware", "vulnerability", "c2").
min_severitystring
Drop threats below this severity level.
countrystring
Filter to one ISO 3166-1 alpha-2 country code (many threats have no country and are dropped by this filter).
limitnumber
Cap the threat list to at most this many items (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_economic_data

Macro economic indicators: Fed Funds rate (FRED), economic calendar events, fuel prices, ECB FX rates, EU yield curve, e

Parameters (5)

datasetarray
Restrict the response to one or more sub-datasets. Omit for the full economic bundle.
countrystring
Filter the country-keyed datasets (fuel-prices, BIS DSR/property, economic calendar) to one ISO 3166-1 alpha-2 code.
limitnumber
Cap each list dataset (calendar, spending, earnings) to at most this many items (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_country_macro

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

Parameters (4)

countriesarray
ISO 3166-1 alpha-2 country codes to keep across all four IMF datasets (e.g. ["US","DE","CN"]). Omit for all ~210 countries.
limitinteger
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).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

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.

Parameters (4)

countriesarray
Eurostat geo codes to keep — ISO 3166-1 alpha-2, but "EL" for Greece, plus aggregates "EA20" and "EU27_2020". Omit for all.
limitinteger
Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_eu_quarterly_gov_debt

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

Parameters (4)

countriesarray
Eurostat geo codes to keep — ISO 3166-1 alpha-2, but "EL" for Greece, plus aggregates "EA20" and "EU27_2020". Omit for all.
limitinteger
Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_eu_industrial_production

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

Parameters (4)

countriesarray
Eurostat geo codes to keep — ISO 3166-1 alpha-2, but "EL" for Greece, plus aggregates "EA20" and "EU27_2020". Omit for all.
limitinteger
Cap the country map to at most this many entries when no countries filter is supplied (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_prediction_markets

Active Polymarket event contracts with current probabilities.

Parameters (6)

categorystring
Restrict to one market category bucket. Omit for all three.
querystring
Keep only markets whose title contains this text (case-insensitive).
sourcestring
Filter to one prediction-market source.
limitnumber
Cap each category bucket to at most this many markets (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_sanctions_data

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

Parameters (6)

countrystring
Filter sanctioned entities and pressure scores to one ISO 3166-1 alpha-2 country code.
entity_typestring
Filter to one entity type (case-insensitive substring, e.g. "vessel", "aircraft", "person", "entity").
querystring
Keep only sanctioned entities whose name contains this text (case-insensitive).
limitnumber
Cap the entity list and recent pressure entries to at most this many items (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_displacement_data

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

Parameters (4)

countriesarray
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.
limitnumber
Cap the per-country and top-flow lists to at most this many items (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_health_signals

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

Parameters (7)

signal_typearray
Restrict to disease outbreaks, air-quality stations, or both. Omit for both.
countrystring
Filter outbreaks and air-quality stations to one ISO 3166-1 alpha-2 country code.
diseasestring
Keep only outbreaks whose disease name contains this text (case-insensitive).
min_aqinumber
Drop air-quality stations below this AQI value.
limitnumber
Cap the outbreak and station lists to at most this many items (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_energy_intelligence

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

Parameters (5)

datasetarray
Restrict the response to one or more energy sub-datasets. Omit for the full bundle.
countrystring
Filter the country-keyed datasets (Ember electricity mix, gas storage, fuel shortages, energy disruptions, fossil-share) to one ISO 3166-1 alpha-2 code.
limitnumber
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).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_climate_data

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

Parameters (5)

datasetarray
Restrict the response to one or more climate sub-datasets. Omit for the full bundle.
countrystring
Filter the country-tagged datasets (climate disasters, air-quality stations) to one ISO 3166-1 alpha-2 code.
limitnumber
Cap each list dataset (anomalies, disasters, stations, news, alerts) to at most this many items (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_infrastructure_status

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

Parameters (5)

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

get_supply_chain_data

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

Parameters (5)

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

get_tariff_trends

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

Parameters (5)

datasetarray
Restrict the response to one or more sub-datasets. Omit for the full bundle.
countrystring
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.
limitnumber
Cap each list dataset (tariff datapoints, BigMac countries, debt entries) to at most this many items (default 30, pass 0 for no cap).
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_chokepoint_status

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

Parameters (5)

chokepointstring
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").
datasetarray
Restrict the response to one or more sub-datasets. Omit for the full bundle.
limitnumber
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.
summaryboolean
Return counts + 3-item samples instead of full lists. Useful when you only need shape/size or want to budget context before drilling in.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_positive_events

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

Parameters (4)

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

get_radiation_data

Radiation observation levels from global monitoring stations.

Parameters (5)

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

get_research_signals

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

Parameters (5)

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

get_forecast_predictions

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

Parameters (5)

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

get_social_velocity

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

Parameters (4)

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

get_world_brief

AI-generated world intelligence brief.

Parameters (2)

geo_contextstring
Optional focus context (e.g. "Middle East tensions", "US-China trade war")
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_country_brief

AI-generated per-country intelligence brief.

Parameters (3)

country_codestringrequired
ISO 3166-1 alpha-2 country code, e.g. "US", "DE", "CN", "IR"
frameworkstring
Optional analytical framework instructions to shape the analysis lens (e.g. Ray Dalio debt cycle, PMESII-PT)
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_country_risk

Structured risk intelligence for a specific country: Composite Instability Index (CII) score 0-100, component breakdown

Parameters (2)

country_codestringrequired
ISO 3166-1 alpha-2 country code, e.g. "RU", "IR", "CN", "UA"
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_consumer_prices

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

Parameters (2)

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

get_airspace

Live ADS-B aircraft over a country.

Parameters (3)

country_codestringrequired
ISO 3166-1 alpha-2 country code (e.g. "AE", "US", "GB", "JP")
typestring
Filter: all flights (default), civilian only, or military only
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

get_maritime_activity

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

Parameters (2)

country_codestringrequired
ISO 3166-1 alpha-2 country code (e.g. "AE", "SA", "JP", "EG")
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

analyze_situation

AI geopolitical situation analysis (DeductionPanel).

Parameters (4)

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

generate_forecasts

Generate live AI geopolitical and economic forecasts.

Parameters (3)

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

search_flights

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

Parameters (9)

originstringrequired
IATA code for the departure airport, e.g. "JFK"
destinationstringrequired
IATA code for the arrival airport, e.g. "LHR"
departure_datestringrequired
Departure date in YYYY-MM-DD format
return_datestring
Return date in YYYY-MM-DD format for round trips (optional)
cabin_classstring
Cabin class: "economy", "premium_economy", "business", or "first" (optional, default economy)
max_stopsstring
Max stops: "0" or "non_stop" for nonstop, "1" or "one_stop" for max one stop, or omit for any (optional)
passengersnumber
Number of passengers (1-9, default 1)
sort_bystring
Sort order: "price" (cheapest), "duration", "departure", or "arrival" (optional)
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

search_flight_prices_by_date

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

Parameters (10)

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

get_commodity_geo

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

Parameters (3)

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

describe_tool

Return the full uncompressed definition of one tool by name.

Parameters (2)

tool_namestringrequired
Exact tool name from tools/list.
jmespathstring
Optional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.

README.md13 KBView on GitHub

World Monitor

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

<a href="https://worldmonitor.app"><img src="https://img.shields.io/badge/Web_App-worldmonitor.app-blue?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Web App"></a>  <a href="https://tech.worldmonitor.app"><img src="https://img.shields.io/badge/Tech_Variant-tech.worldmonitor.app-0891b2?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Tech Variant"></a>  <a href="https://finance.worldmonitor.app"><img src="https://img.shields.io/badge/Finance_Variant-finance.worldmonitor.app-059669?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Finance Variant"></a>  <a href="https://commodity.worldmonitor.app"><img src="https://img.shields.io/badge/Commodity_Variant-commodity.worldmonitor.app-b45309?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Commodity Variant"></a>  <a href="https://happy.worldmonitor.app"><img src="https://img.shields.io/badge/Happy_Variant-happy.worldmonitor.app-f59e0b?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Happy Variant"></a>  <a href="https://energy.worldmonitor.app"><img src="https://img.shields.io/badge/Energy_Variant-energy.worldmonitor.app-eab308?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Energy Variant"></a> <a href="https://www.npmjs.com/package/worldmonitor"><img src="https://img.shields.io/npm/v/worldmonitor?style=for-the-badge&logo=npm&logoColor=white&label=npm%20i%20worldmonitor&color=CB3837" alt="npm i worldmonitor"></a>  <a href="https://www.npmjs.com/package/worldmonitor"><img src="https://img.shields.io/badge/CLI-npx%20worldmonitor-CB3837?style=for-the-badge&logo=npm&logoColor=white" alt="npx worldmonitor"></a>  <a href="https://pypi.org/project/worldmonitor-sdk/"><img src="https://img.shields.io/pypi/v/worldmonitor-sdk?style=for-the-badge&logo=pypi&logoColor=white&label=pip%20install%20worldmonitor-sdk&color=3775A9" alt="pip install worldmonitor-sdk"></a>  <a href="https://rubygems.org/gems/worldmonitor"><img src="https://img.shields.io/gem/v/worldmonitor?style=for-the-badge&logo=rubygems&logoColor=white&label=gem%20install%20worldmonitor&color=E9573F" alt="gem install worldmonitor"></a>  <a href="https://pkg.go.dev/github.com/koala73/worldmonitor/sdk/go"><img src="https://img.shields.io/badge/go%20get-sdk%2Fgo-00ADD8?style=for-the-badge&logo=go&logoColor=white" alt="go get github.com/koala73/worldmonitor/sdk/go"></a> <a href="https://worldmonitor.app/api/download?platform=windows-exe"><img src="https://img.shields.io/badge/Download-Windows_(.exe)-0078D4?style=for-the-badge&logo=windows&logoColor=white" alt="Download Windows"></a>  <a href="https://worldmonitor.app/api/download?platform=macos-arm64"><img src="https://img.shields.io/badge/Download-macOS_Apple_Silicon-000000?style=for-the-badge&logo=apple&logoColor=white" alt="Download macOS ARM"></a>  <a href="https://worldmonitor.app/api/download?platform=macos-x64"><img src="https://img.shields.io/badge/Download-macOS_Intel-555555?style=for-the-badge&logo=apple&logoColor=white" alt="Download macOS Intel"></a>  <a href="https://worldmonitor.app/api/download?platform=linux-appimage"><img src="https://img.shields.io/badge/Download-Linux_(.AppImage)-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="Download Linux"></a> <a href="https://www.worldmonitor.app/docs/documentation">Documentation</a>  ·  <a href="https://github.com/koala73/worldmonitor/releases/latest">Releases</a>  ·  <a href="https://www.worldmonitor.app/docs/contributing">Contributing</a>

World Monitor Dashboard

What It Does

500+ curated news feeds across 15 categories, AI-synthesized into briefs
Dual map engine — 3D globe (globe.gl) and WebGL flat map (deck.gl) with 56 map layer types
Cross-stream correlation — military, economic, disaster, and escalation signal convergence
Country Instability Index (CII) — server-authoritative CII v8 stress scoring for 31 Tier-1 countries
Finance radar — 29 stock exchanges, commodities, crypto, and 7-signal market composite
Local AI — run everything with Ollama, no API keys required
6 site variants from a single codebase (world, tech, finance, commodity, happy, energy)
Native desktop app (Tauri 2) for macOS, Windows, and Linux
25 languages with native-language feeds and RTL support

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

Support Status

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

Surface	Status	Notes
`worldmonitor.app`, `tech.`, `finance.`, `commodity.`, `happy.`, `energy.`	Stable	Public deployments built from this repo, actively maintained
Desktop binaries (Windows / macOS Apple Silicon / macOS Intel / Linux AppImage)	Stable	One Tauri binary that switches variants in-app; current CI release targets are `full` and `tech`

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

Quick Start

bash

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

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

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

For variant-specific development:

bash

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

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

Tech Stack

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

Full stack details in the architecture docs.

Programmatic Access

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

MCP server — https://worldmonitor.app/mcp (Streamable HTTP). Public tools/list; tools/call authenticates with a X-WorldMonitor-Key header or OAuth.
REST API — base https://api.worldmonitor.app, described by the OpenAPI spec.

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

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

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

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

Flight Data

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

Data Sources

WorldMonitor aggregates 65+ external providers and APIs across geopolitics, finance, energy, climate, aviation, cyber, military, infrastructure, and news intelligence — surfaced through 500+ curated feeds and tracked by a freshness monitor covering 35 source groups. See the full data sources catalog for providers, feed tiers, and collection methods.

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

bash

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

License

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

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

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

Author

Elie Habib — GitHub

Contributors

Security Acknowledgments

We thank the following researchers for responsibly disclosing security issues:

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

See our Security Policy for responsible disclosure guidelines.

<a href="https://worldmonitor.app">worldmonitor.app</a>  ·  <a href="https://www.worldmonitor.app/docs/documentation">docs.worldmonitor.app</a>  ·  <a href="https://finance.worldmonitor.app">finance.worldmonitor.app</a>  ·  <a href="https://commodity.worldmonitor.app">commodity.worldmonitor.app</a>

Star History

Install

claude_desktop_config.json

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

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