worldmonitor-mcp
MCP server and CLI around koala73/worldmonitor, plus direct handlers for public-data providers that need more fidelity than the dashboard proxies. It covers markets, geopolitics, military activity, cyber events, climate, and supply chains.
Why
Research often needs FRED, SEC EDGAR, ACLED, GDELT, vessel tracking, public flight data, congressional trades, and sanctions lists in one consistent interface. koala73 already aggregates much of that in a real-time dashboard; this project adds programmatic access through MCP and a CLI.
What's in it
The services are grouped by domain:
| Category | Services |
|---|---|
| Markets & financial | market · economic · treasury · cftc · congress · onchain · sentiment · trading (scored briefs) |
| Geopolitics & intel | intelligence · conflict · military · unrest · displacement |
| News & research | news · research · article extraction |
| Environmental | climate · weather-agriculture · wildfire · seismology |
| Supply chain & trade | supply-chain · maritime (AIS) · trade |
| Infra & cyber | infrastructure · cyber · aviation (military flight tracking) |
| Gov & regulation | government · sec-edgar · economic-calendar |
| Other | prediction (Polymarket etc.) · humanitarian · positive events · legacy bulk |
Most services proxy the upstream worldmonitor API. Direct extensions cover providers such as SEC EDGAR, FRED, USDA, NOAA, CFTC, CBOE, Treasury Fiscal Data, the Federal Register, and OpenSanctions. A separate research service combines selected sources into structured briefs.
How it works
Each service declares its tools, endpoints, and parameter schemas in src/services/*. The server iterates the registry at startup and registers every tool. Adding a tool is one file change.
Routing splits two ways per tool. Direct handlers bypass the upstream and call the underlying provider. Proxy handlers forward to the configured worldmonitor base URL. Each tool declares which path it takes in its registry entry.
A defensive layer handles bounded retries on 429 and 5xx responses, validates responses that should be JSON, recognizes known-broken endpoints, and truncates oversized arrays before they overwhelm a client context.
Article extraction uses direct fetch and archival fallbacks when a source is unavailable; provider rules and access restrictions still apply. Optional keys unlock rate-limited or paid endpoints.
Credits
koala73/worldmonitor does the data and aggregation work — that's the heavy lifting. AGPL-3.0. This repo is the MCP wrapper plus the direct-API extensions.
mahimn · worldmonitor-mcp · copy reviewed jul 2026