World Intelligence MCP Server

Real-time global intelligence across 30+ domains with 132 MCP tools, a live ops-center dashboard, a CLI, and a Qdrant vector store for enterprise-grade semantic search across accumulated intelligence. All data comes from free, public APIs: no paid subscriptions required.

Built for AI agents that need world awareness: market conditions, geopolitical risk, military posture, supply chain disruptions, cyber threats, and more — all queryable via the Model Context Protocol. The vector store enables natural language queries like "military activity near Taiwan" or "cyber threats targeting healthcare" across all historical data.

---

What You Get

| Domain | Tools | Data Sources | |--------|-------|-------------| | Financial Markets | 7 | Yahoo Finance, CoinGecko, Alternative.me, Mempool | | Forex & Currency | 3 | ECB/Frankfurter (8 major pairs, timeseries, cross rates) | | Bonds & Yields | 2 | FRED, Yahoo Finance (yield curve, bond ETFs, spread analysis) | | Earnings | 2 | Yahoo Finance (mega-cap calendar, surprise history) | | SEC Filings | 3 | SEC EDGAR (full-text search, company filings, 8-K material events) | | Company Enrichment | 1 | Yahoo Finance + GDELT + SEC + GitHub (composite profile) | | Macro Composite | 1 | Weighted 6-signal market verdict (Fear&Greed, VIX, sectors, DXY, BTC, yields) | | Economic Indicators | 6 | AAA fuel prices, EIA energy, FRED macro, World Bank | | Central Banks | 1 | 15 central bank policy rates | | BTC Technicals | 1 | SMA 50/200, golden/death cross, Mayer Multiple | | Natural Disasters | 2 | USGS earthquakes, NASA FIRMS wildfires | | Environmental | 2 | NASA EONET, GDACS disaster alerts | | Climate | 1 | Open-Meteo temperature/precipitation anomalies | | Conflict & Security | 4 | ACLED events, UCDP, unrest detection, humanitarian data | | Military & Defense | 6 | adsb.lol, OpenSky, hexdb.io, surge detection, theater posture, aircraft batch | | Infrastructure | 5 | Cloudflare Radar, submarine cables, cascade analysis, cloud status, RIPEstat BGP/RPKI | | Maritime | 2 | NGA navigation warnings, vessel snapshots | | Aviation | 2 | FAA airport delays, domestic flight snapshot | | News & Media | 3 | 119 RSS feeds (4-tier), GDELT, trending keywords | | Intelligence Analysis | 8 | Signal convergence, focal points, instability index, risk scores, escalation | | NLP Intelligence | 4 | Entity extraction, event classification, news clustering, keyword spikes | | Strategic Synthesis | 4 | Strategic posture, world brief, fleet report, population exposure | | Geospatial | 11 | Military bases, ports, pipelines, nuclear facilities, cables, datacenters, spaceports, minerals, exchanges, trade routes, cloud regions | | AI & Technology | 4 | arXiv papers, HuggingFace models, Hacker News, GitHub trending | | Cyber Threats | 1 | URLhaus, Feodotracker, CISA KEV, SANS | | Health | 1 | WHO DON, ProMED, CIDRAP disease outbreaks | | Space Weather | 1 | NOAA SWPC (Kp index, solar flares, alerts) | | Social & Sanctions | 3 | Reddit velocity, OFAC SDN list, nuclear test site monitoring | | Country Intelligence | 3 | Country brief, country stocks, financial centers | | Prediction Markets | 1 | Polymarket event contracts | | Elections | 1 | Global election calendar with risk scoring | | Displacement | 1 | UNHCR refugee/IDP data | | Shipping | 1 | Dry bulk shipping stress index | | Government | 1 | USAspending.gov federal contracts | | Traffic | 2 | Road traffic flow, real-time incidents | | Cross-Domain Alerts | 2 | Alert digest, weekly trends | | Monitoring | 2 | Webcams, server health/status | | Vector Search | 5 | Qdrant semantic search, similarity, timeline, stats | | Cross-Domain Analytics | 3 | Correlation, domain summary, trend detection | | Reports | 1 | PDF/HTML multi-domain intelligence reports | | Daily Digest | 1 | Cited markdown morning brief: top events, headlines, trends, and timeline | | AOI Geofences | 10 | User-defined areas of interest in three shapes (circle, polygon, corridor): define/list/update/delete, a cited multi-domain brief, hotspot escalation scoring, and enter/leave change detection for a user's own area. News is scoped to the place the area sits in (OSM Nominatim reverse geocoding, no key), not to the area's name | | Severe Weather | 2 | NWS active CAP alerts (US), Meteoalarm (39 EU countries) | | Space Launches | 1 | Launch Library 2 upcoming launches | | Volcanoes | 1 | Smithsonian GVP weekly activity report | | Tropical Cyclones | 2 | NHC (Atlantic, E/C Pacific) + JTWC (NW Pacific, N Indian, S Hemisphere) | | Situation Brief | 1 | Cited situational awareness brief over MCP: bounded server-side overview synthesized via local Ollama, with a mechanically-cited fallback |

Total: 132 tools across 30+ intelligence domains.

---

Quick Start

Install

git clone https://github.com/marc-shade/world-intel-mcp.git
cd world-intel-mcp
pip install -e .

# Optional extras
pip install -e ".[dashboard]"  # Live ops-center dashboard
pip install -e ".[vector]"     # Qdrant vector store + FastEmbed
pip install -e ".[dev]"        # pytest, respx, coverage

Run as MCP Server

world-intel-mcp  # stdio mode for Claude Code, Cursor, etc.

Claude Code Configuration

Add to ~/.claude.json:

{
  "mcpServers": {
    "world-intel-mcp": {
      "command": "world-intel-mcp"
    }
  }
}

Dashboard

intel-dashboard              # http://localhost:8501
intel-dashboard --port 9000  # custom port

PDF/HTML Reports

pip install -e ".[pdf]"      # requires: brew install pango (macOS)
intel report                 # full PDF report → ~/.cache/world-intel-mcp/
intel report --format html   # HTML (no native deps needed)
intel report -o brief.pdf    # custom output path
intel report -s markets,cyber,earthquakes  # select sections

Map-first ops center: Leaflet map with toggle-able layers (quakes, military, conflict, fires, convergence, nuclear, infrastructure, your AOI geofences with last-sweep counts), 47 live SSE feeds, HUD bar, glassmorphic panels, per-source circuit breaker health.

CLI

intel markets              # stock indices
intel earthquakes --min-mag 5.0
intel status               # cache + circuit breaker health

---

Architecture

server.py     (MCP stdio) ─┐                                               ┌─ VectorStore (Qdrant)
cli.py        (Click CLI)  ├─> sources/*.py ─> Fetcher ─> CircuitBreaker ─┤
dashboard.py  (SSE)        │    analysis/*.py                              └─ Cache (SQLite)
collector.py  (daemon)    ─┘

• Fetcher: Centralized async HTTP client (httpx). Retries, per-source rate limiting, stale-data fallback. Auto-stores results in vector store on fresh fetches.
• CircuitBreaker: Per-source tracking. 3 consecutive failures trips for 5 minutes. Each RSS feed gets its own breaker.
• Cache: SQLite WAL-mode TTL cache. get() returns live data, get_stale() returns expired data for fallback.
• VectorStore: Qdrant + FastEmbed (BAAI/bge-small-en-v1.5, 384-dim). Async background worker queue for non-blocking storage. Enables semantic search across all accumulated intelligence.
• Collector: Standalone daemon that fetches all 51 sources in parallel and populates the vector store. Run once or as a daemon (default: 5-minute interval). Includes the AOI change sweep, so a running daemon continuously watches every defined geofence.
• Sources (sources/*.py): 30+ modules, each exports async def fetch_*(fetcher, **kwargs) -> dict.
• Analysis (analysis/*.py): Cross-domain synthesis — signal aggregation, instability indexing, NLP, company enrichment, macro composite.
• Config (config/*.py): Curated datasets — 22 hotspots, 70+ bases, 40 ports, 24 pipelines, 24 nuclear facilities, 34 cables, 48 datacenters, 27 spaceports, 82 exchanges.

---

MCP Tools Reference

Financial Markets (7)

| Tool | Description | |------|-------------| | intel_market_quotes | Stock index quotes (S&P 500, Dow, Nasdaq, FTSE, Nikkei) | | intel_crypto_quotes | Top crypto prices and market caps from CoinGecko | | intel_stablecoin_status | Stablecoin peg health (USDT, USDC, DAI, FDUSD) | | intel_etf_flows | Bitcoin spot ETF prices and volumes | | intel_sector_heatmap | US equity sector performance (11 SPDR ETFs) | | intel_macro_signals | 7 macro indicators (Fear & Greed, VIX, DXY, gold, 10Y, BTC) | | intel_commodity_quotes | Commodity futures (gold, silver, crude, natgas, grains) |

Forex & Currency (3)

| Tool | Description | |------|-------------| | intel_forex_rates | Latest FX rates from ECB. Filter by base/target currencies | | intel_forex_timeseries | Historical FX rate with trend analysis (configurable days) | | intel_major_crosses | All 8 major pairs + cross rates + DXY proxy |

Bonds & Yields (2)

| Tool | Description | |------|-------------| | intel_yield_curve | US Treasury yield curve (2Y-30Y), 2s10s/3m10y spreads, inversion flag | | intel_bond_indices | Bond ETFs: AGG, TLT, HYG, LQD, TIP with price/change |

Earnings (2)

| Tool | Description | |------|-------------| | intel_earnings_calendar | Upcoming earnings for 20 mega-cap stocks with EPS estimates | | intel_earnings_surprise | Historical earnings surprise (actual vs estimate, trend) |

SEC Filings (3)

| Tool | Description | |------|-------------| | intel_sec_filings | Full-text search across all EDGAR filings | | intel_company_filings | Company filings by ticker (10-K, 10-Q, 8-K) with CIK resolution | | intel_recent_8k | Latest 8-K material events (M&A, exec changes, earnings) |

Company Enrichment (1)

| Tool | Description | |------|-------------| | intel_company_profile | Composite profile: stock quote + financials + news + SEC + GitHub |

Macro Composite (1)

| Tool | Description | |------|-------------| | intel_macro_composite | Weighted market score (0-100) with verdict: RISK_ON to STRONG_CAUTION |

Economic (6)

| Tool | Description | |------|-------------| | intel_gas_prices | Daily US retail gasoline, diesel, and E85 prices from AAA | | intel_residential_natgas | US residential natural gas prices from EIA | | intel_electricity_rates | US electricity retail rates by sector/state from EIA | | intel_energy_prices | Brent/WTI crude oil and natural gas from EIA | | intel_fred_series | FRED economic data (GDP, CPI, unemployment, rates) | | intel_world_bank_indicators | World Bank development indicators by country |

Central Banks (1)

| Tool | Description | |------|-------------| | intel_central_bank_rates | Policy rates for 15 major central banks |

BTC Technicals (1)

| Tool | Description | |------|-------------| | intel_btc_technicals | Bitcoin SMA 50/200, golden/death cross, Mayer Multiple |

Natural Disasters (2)

| Tool | Description | |------|-------------| | intel_earthquakes | USGS earthquakes (configurable magnitude/time/limit) | | intel_wildfires | NASA FIRMS satellite fire hotspots (9 global regions) |

Environmental (2)

| Tool | Description | |------|-------------| | intel_environmental_events | NASA EONET natural events | | intel_disaster_alerts | GDACS disaster alerts with severity scoring |

Conflict & Security (4)

| Tool | Description | |------|-------------| | intel_acled_events | ACLED armed conflict events | | intel_ucdp_events | Uppsala Conflict Data Program events | | intel_unrest_events | Social unrest w