docs/overview.mdx
World Monitor runs six specialized variants from a single codebase, each optimized for different monitoring needs.
| Variant | URL | Focus |
|---|---|---|
| 🌍 World Monitor | worldmonitor.app | Geopolitical intelligence, military tracking, conflict monitoring, infrastructure security |
| 💻 Tech Monitor | tech.worldmonitor.app | Technology sector intelligence, AI/startup ecosystems, cloud infrastructure, tech events |
| 😊 Happy Monitor | happy.worldmonitor.app | Curated positive news, global progress tracking, science breakthroughs, conservation wins |
| 💰 Finance Monitor | finance.worldmonitor.app | Global markets, stock exchanges, central banks, commodities, forex, crypto, economic indicators |
| ⛏️ Commodity Monitor | commodity.worldmonitor.app | Commodity markets, mining sites, processing plants, supply chains, trade flows |
| ⚡ Energy Monitor | energy.worldmonitor.app | Oil & gas pipelines, storage facilities, tanker positions, chokepoints, energy infrastructure and shocks |
A compact variant switcher in the header allows seamless navigation between variants while preserving your map position and panel configuration.
This section gives procurement, security, and engineering teams a concise view of the current platform. The detailed variant descriptions continue below.
World Monitor combines an interactive 3D globe and flat map, configurable intelligence panels, source-attributed news and OSINT, market and economic data, country risk and resilience scoring, infrastructure and supply-chain analysis, scenario modelling, AI-generated briefs, and alerting workflows. The generated product inventory currently records 56 map-layer definitions, 109 concrete panel implementations, and six product variants. The panel figure counts concrete classes that extend the shared Panel base in src/components; the base class itself is excluded, and a class reused by multiple variants is counted once.
| Capability | Current scope |
|---|---|
| Country risk and resilience | Country Instability Index (CII v8) scores with signed 24-hour movement for 31 Tier-1 countries. The Country Resilience Index ranks a 196-country public universe across 6 domains and 21 active dimensions on a 6-hour schedule. |
| Signal and infrastructure analysis | Geographic convergence, temporal anomalies, and cross-source correlation combine related events. Infrastructure Cascade models dependencies across a 350-node infrastructure graph. |
| Decision support | Source-linked AI briefs, probabilistic forecasts with machine-checkable resolution criteria and scorecard context, Route Explorer, and the Scenario Engine. |
| Company and procurement workflows | The MCP company-intelligence tool combines market context, SEC filing search, and material 8-K events. Global Procurement Intelligence uses seeded public opportunities from supported government and multilateral portals. Availability still depends on deployment credentials and source health. |
| Delivery surfaces | Hosted web dashboard and installable PWA, native desktop applications for macOS, Windows, and Linux, and a self-hosted stack. The desktop application includes a local Node.js sidecar and supports local LLM endpoints such as Ollama and LM Studio. |
| Language coverage | The interface supports 28 languages. Arabic and Persian use right-to-left layouts. This documentation site is currently available in English and Simplified Chinese. |
For the complete product surface, see Features & Interface. For the processing model, caching, resilience controls, and deployment components, see Architecture. Methodology pages explain how the platform calculates algorithms and composite signals.
World Monitor does not apply one refresh interval to every dataset. Each source follows a cadence that matches how frequently its upstream provider publishes useful observations. Fast-moving feeds use live or minute-level pipelines; institutional datasets retain their daily, weekly, or monthly publication schedules.
The following cycles describe specific product surfaces. REST and MCP freshness budgets can differ from dashboard polling intervals.
| Data domain | Normal product cycle | Important qualification |
|---|---|---|
| Maritime tracking | AIS uses a live WebSocket when enabled; snapshot surfaces refresh in about 5–15 minutes | MCP live-transit summaries use a 30-minute freshness budget. PortWatch-derived products are slower, with 12–36-hour budgets and source values that can be weekly. |
| Aviation | Live military-flight and airport-operations surfaces refresh in about 2–5 minutes | Other flight feeds are provider-dependent; MCP flight-backed tools use a 30-minute freshness budget. |
| Market data | The dashboard refreshes market quotes every 12 minutes | MCP market data uses a 30-minute freshness budget. CFTC, FRED, and other institutional series follow their own publication schedules. |
| Dashboard news and OSINT | 20-minute dashboard refresh cycle | Publisher timing varies. A refresh can return the same latest article when no new item is published. |
| Conflict and unrest | GDELT bulk materialisation runs on a 15-minute cycle | The MCP unrest slice permits data up to 2 hours old before it is marked stale. Other conflict sources keep source-specific schedules. |
| Country Resilience Index | Scheduled every 6 hours | A successful cycle does not imply that every upstream series published a new value. |
| Institutional economic data | Daily, weekly, or monthly | BIS, Eurostat, IMF, World Bank, and similar datasets retain their native release calendars. |
These are operating targets, not a promise that an upstream publisher will release a new observation in each window. Cache-backed API and MCP responses include timestamps and a stale indicator where supported. See the MCP tool reference for per-tool freshness budgets, Health endpoints for monitoring semantics, and status.worldmonitor.app for current service status.
World Monitor publishes a public, searchable Data Source Catalog. Its manifest-derived inventory currently lists 534 active providers, 536 upstream hosts, 296 structured endpoints, and 268 news and OSINT feeds. The separate application inventory records 632 configured feed definitions, and the Telegram catalog enables 56 channels. These figures describe different inventory layers and should not be added together.
Across those inventories, World Monitor combines structured APIs, public and licensed datasets, official government and multilateral sources, news feeds, and reviewed OSINT. Representative providers include ACLED, UCDP, GDELT, UNHCR/OCHA, IMF, World Bank, BIS, Eurostat, FRED, USGS, NASA, Open-Meteo, Cloudflare Radar, AIS and ADS-B providers, and hundreds of news publishers. RSS configuration can include source tier, state affiliation, and propaganda-risk metadata. Telegram configuration uses a different schema with tier, topic, and region metadata. Cross-source corroboration can improve ranking and confidence, but it is not a universal prerequisite for every alert.
Start with the public Data Source Catalog to search and filter providers by signal domain or source type. For collection methods, coverage, credibility tiers, and bias metadata, use the Data Sources methodology. For the host-level attribution and terms-review posture, use the machine-generated Source Attribution inventory. Generation checks detect repository drift, but an inventory entry is not by itself a legal clearance. Source availability and licensing can differ by feature and deployment model.
| Option | Best for | Main requirements |
|---|---|---|
| Hosted dashboard | Analysts who need the complete visual product | A modern browser. Public capabilities need no customer-side integration; paid features require the applicable World Monitor account or plan. |
| Live map embed | Articles, portals, and internal dashboards | A page that permits an HTTPS iframe. The embed exposes allow-listed public map layers only and does not expose account or premium state. |
| REST API | Applications, data pipelines, and higher-volume batch reads | 36 generated service contracts and more than 200 versioned HTTP paths described by OpenAPI 3.1. Standard server-to-server access uses an API key in X-WorldMonitor-Key. See the reference for current routing status, then review the quickstart, authentication, versioning policy, and REST rate limits. |
| MCP server | Claude, Cursor, and custom AI agents | Streamable HTTP with 63 tools, 6 workflow prompts, 10 interactive apps, and optional JMESPath response filtering. Catalog discovery is public; data calls require OAuth 2.1 or a World Monitor API key. MCP entitlements and metering are documented separately from REST API-plan allowances. |
| Official SDKs and CLI | Python, Ruby, Go, and JavaScript applications or shell automation | The relevant language runtime and an API key for data calls. The zero-dependency SDKs and npm CLI support hosted and self-hosted base URLs. |
| Notification channels | General domain alerts to operational systems | A billed PRO account and Clerk bearer token. Supported delivery channels include signed HTTPS webhooks, Telegram, Slack, Discord, email, and Web Push. Availability depends on the event domain and channel configuration. |
| Shipping webhooks | Chokepoint disruption notifications | A PRO-capable API key and a public HTTPS callback that passes the documented SSRF checks. Deliveries are HMAC-SHA256 signed and at least once. These webhooks are domain-specific, not a general platform-wide event bus. |
| Agent discovery | Automated onboarding and agent-native workflows | Standard .well-known metadata, llms.txt, OpenAPI assets, an MCP server card, and a catalog of 25 installable agent skills. Discovery metadata is public; data-bearing operations still require the applicable credentials. |
| Self-hosted deployment | Teams that need to operate the stack themselves | Node.js 22+, Docker or Podman, Redis, deployment secrets, and compliance with the AGPL or separate commercial license. See Getting Started. |
For browser-based API calls, review the CORS policy. For generated clients, the bundled OpenAPI specification is the machine-readable contract.
The primary variant focuses on geopolitical intelligence, military tracking, and infrastructure security monitoring.
| Panel | Purpose |
|---|---|
| AI Insights | LLM-synthesized world brief with focal point detection |
| AI Strategic Posture | Theater-level military force aggregation with strike capability assessment |
| Country Instability Index | Real-time CII v8 stability scores and signed 24-hour movement deltas for 31 Tier-1 countries |
| Strategic Risk Overview | Composite risk score combining all intelligence modules |
| Infrastructure Cascade | Dependency analysis for cables, pipelines, and chokepoints |
| Live Intelligence | GDELT-powered topic feeds (Military, Cyber, Nuclear, Sanctions) |
500+ curated news feeds across geopolitics, defense, energy, think tanks, and regional news (Middle East, Africa, Latin America, Asia-Pacific), backed by 536+ observed upstream hosts.
The tech variant (tech.worldmonitor.app) provides specialized layers for technology sector monitoring.
| Layer | Description |
|---|---|
| Tech HQs | Headquarters of major tech companies (Big Tech, unicorns, public companies) |
| Startup Hubs | Major startup ecosystems with ecosystem tier, funding data, and notable companies |
| Cloud Regions | AWS, Azure, GCP data center regions with zone counts |
| Accelerators | Y Combinator, Techstars, 500 Startups, and regional accelerator locations |
| Tech Events | Upcoming conferences and tech events with countdown timers |
| Layer | Description |
|---|---|
| AI Datacenters | 313 AI compute clusters tracked from Epoch AI dataset |
| Undersea Cables | Submarine fiber routes critical for cloud connectivity |
| Internet Outages | Network disruptions affecting tech operations |
| Region | Notable Companies |
|---|---|
| Silicon Valley | Apple, Google, Meta, Nvidia, Intel, Cisco, Oracle, VMware |
| Seattle | Microsoft, Amazon, Tableau, Expedia |
| New York | Bloomberg, MongoDB, Datadog, Squarespace |
| London | Revolut, Deliveroo, Darktrace, Monzo |
| Tel Aviv | Wix, Check Point, Monday.com, Fiverr |
| Dubai/MENA | Careem, Noon, Anghami, Property Finder, Kitopi |
| Riyadh | Tabby, Presight.ai, Ninja, XPANCEO |
| Singapore | Grab, Razer, Sea Limited |
| Berlin | Zalando, Delivery Hero, N26, Celonis |
| Tokyo | Sony, Toyota, SoftBank, Rakuten |
The finance variant (finance.worldmonitor.app) provides specialized layers for global financial markets and economic intelligence.
| Layer | Description |
|---|---|
| Stock Exchanges | Major global stock exchanges with live status |
| Financial Centers | Key financial hubs and banking districts |
| Central Banks & Institutions | 14 central-bank and supranational finance institutions, including policy-rate tracking plus BIS/IMF context |
| Commodity Hubs | Commodity exchanges (LME, CME, SHFE, NYMEX) |
| Gulf Investments | GCC sovereign wealth and investment zones |
| Panel | Description |
|---|---|
| Live Commodity Prices | Real-time commodity futures and spot prices |
| Market Radar | VWAP-based anomaly detection with volume confirmation |
| Sector Heatmap | Visual sector performance across global markets |
| Gulf Economies | Indices, currencies, and oil data for 6 GCC countries |
| Supply Chain | Maritime chokepoint disruption scores and shipping indices |
| WTO Trade Policy | Active trade restrictions, tariff trends, bilateral trade flows |
| Premium Stock Analysis | AI-powered stock analysis with backtesting |
The commodity variant (commodity.worldmonitor.app) focuses on mining, metals, energy commodities, and critical mineral supply chains.
| Layer | Description |
|---|---|
| Mining Sites | Major mine sites worldwide (operational, planned, suspended) |
| Processing Plants | Smelters, refineries, and separation plants |
| Commodity Ports | Mineral export/import ports and terminals |
| Commodity Hubs | Global commodity exchanges |
| Trade Routes | Commodity trade routes and shipping lanes |
| Critical Minerals | Lithium, cobalt, rare earth deposits with operator data |
| Pipelines | Oil and gas pipeline infrastructure |
| Panel | Description |
|---|---|
| Live Commodity Prices | Real-time futures and spot prices |
| Mining & Commodity Stocks | Major mining company equities |
| Sector Heatmap | Commodity sector performance visualization |
| Gold & Silver | Precious metals news and analysis |
| Energy Markets | Oil, gas, and energy commodity tracking |
| Critical Minerals & Battery Metals | Lithium, cobalt, nickel supply intelligence |
| Mining Policy & ESG | Regulatory and environmental compliance tracking |
| Supply Chain & Shipping | Freight indices, port congestion, route disruptions |
The happy variant (happy.worldmonitor.app) curates positive news, human progress data, and uplifting stories.
| Layer | Description |
|---|---|
| Positive Events | Curated good news and positive developments worldwide |
| Acts of Kindness | Community and humanitarian highlights |
| Happiness Index | Country-level happiness and wellbeing data |
| Species Recovery | Conservation wins and wildlife recovery stories |
| Renewable Installations | New renewable energy projects and milestones |
| Panel | Description |
|---|---|
| Good News Feed | Curated positive news from around the world |
| Human Progress | Long-term progress metrics (poverty, literacy, health) |
| Live Counters | Real-time humanity counters (births, trees planted, etc.) |
| Today's Hero | Daily spotlight on impactful individuals |
| Breakthroughs | Science and technology breakthroughs |
| 5 Good Things | Daily digest of five positive stories |
| Conservation Wins | Wildlife and ecosystem recovery stories |
| Renewable Energy | Clean energy milestones and deployment data |