Airsc is free for everyone. If it helps you, support it with $2–$20.

Support
MCP serverCautionData & analyticsSome setup

worldmonitor

koala73 · koala73/worldmonitor

A real-time global intelligence MCP server offering AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified dashboard.

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

89k stars14kLicense: AGPL-3.0Updated 3 days ago0 opens

Preview

▍

What you can do with it

  • Query real-time global news and geopolitical insights through an AI agent via the MCP server.
  • Monitor country instability scores and related financial market data for analytical purposes.
  • Integrate a custom AI agent to analyze trends from curated news feeds and cross-stream correlations for specific topics.

Try asking your agent

  • “What are the current country instability scores for G7 nations?”
  • “Provide a brief on recent events affecting global oil prices, including cross-stream correlations.”
  • “Analyze the financial market impact of the latest news from the Asia-Pacific region.”

Safety check

Caution

Usable, but read the notes first.

  • ●Contains phrases used in prompt-injection attacks (may just be documentation about them). Read the file before installing.public/.well-known/agent-skills/assess-energy-shock/SKILL.md
  • ●Sends environment variables or tokens over the network.public/.well-known/agent-skills/assess-energy-shock/SKILL.md
  • ●npm package runs a script automatically on install.package.json

Automated scan of the repo files. Always review code you run.

From the README

World Monitor

简体中文 | 日本語 | Русский

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

         

       

     

Documentation  ·  Releases  ·  Contributing


What It Does

  • Curated news feeds across global and regional categories, AI-synthesized into briefs
  • Dual map engine — 3D globe (globe.gl) and WebGL flat map (deck.gl) with a shared map-layer catalog
  • Panel inventory — concrete panel implementations across specialized variants
  • Cross-stream correlation — military, economic, disaster, and escalation signal convergence
  • Country Instability Index (CII) — live CII v8 scores, bands, and approximate 24-hour movement for 31 Tier-1 countries
  • Finance radar — stock exchanges, commodities, crypto, and a market composite
  • Local AI — run everything with Ollama, no API keys required
  • Site variants from a single codebase (world, tech, finance, commodity, happy, energy)
  • Native desktop app (Tauri 2) for macOS, Windows, and Linux
  • Multilingual UI 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.

SurfaceStatusNotes
worldmonitor.app, tech., finance., commodity., happy., energy.StablePublic deployments built from this repo, actively maintained
Desktop binaries (Windows / macOS Apple Silicon / macOS Intel / Linux AppImage)StableOne Tauri binary for every variant — install World Monitor and switch to tech, finance, commodity, energy, or happy in-app. There is deliberately no per-variant download

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


Quick Start

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:

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

CategoryTechnologies
FrontendVanilla TypeScript, Vite, globe.gl + Three.js, deck.gl + MapLibre GL
DesktopTauri 2 (Rust) with Node.js sidecar
AI/MLOllama / OpenRouter, Transformers.js (browser-side)
API ContractsProtocol Buffers and sebuf HTTP annotations
DeploymentVercel Edge Functions, Railway relay, Tauri, PWA
CachingRedis (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. The server also publishes its Agent Skills through the draft io.modelcontextprotocol/skills extension (skills/list, skills/get, and skill://… resource reads).

  • 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 attributed upstream sources across geopolitics, finance, energy, climate, aviation, cyber, military, infrastructure, and news intelligence. Curated feeds and freshness-tracke

View source on GitHub