World Intel Mcp

World Intelligence MCP Server

[](https://modelcontextprotocol.io) [](https://python.org) [](LICENSE)

Real-time global intelligence across 30+ domains with 113 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 | 8 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 | 4 | Cloudflare Radar, submarine cables, cascade analysis, cloud status | | Maritime | 2 | NGA navigation warnings, vessel snapshots | | Aviation | 2 | FAA airport delays, domestic flight snapshot | | News & Media | 3 | 80+ 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 |

Total: 113 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), 35+ 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 43 sources in parallel and populates the vector store. Run once or as a daemon (default: 5-minute interval).
• 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: RISKON to STRONGCAUTION |

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 8 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 with Haversine dedup | | intel_humanitarian_summary | HDX humanitarian crisis datasets |

Military & Defense (6)

| Tool | Description | |------|-------------| | intel_military_flights | Military aircraft via adsb.lol (OpenSky fallback) | | intel_theater_posture | Activity across 5 theaters (EU, Indo-Pacific, ME, Arctic, Korea) | | intel_aircraft_details | Aircraft lookup by ICAO24 hex (hexdb.io) | | intel_aircraft_batch | Batch aircraft lookup (multiple hex codes) | | intel_military_surge | Foreign aircraft concentration anomaly detection | | intel_usni_fleet | USNI News naval fleet tracker |

Infrastructure (4)

| Tool | Description | |------|-------------| | intel_internet_outages | Cloudflare Radar internet disruptions | | intel_cable_health | Submarine cable corridor health | | intel_cascade_analysis | Infrastructure cascade simulation | | intel_service_status | Cloud platform health (AWS, Azure, GCP, Cloudflare, GitHub) |

Maritime (2)

| Tool | Description | |------|-------------| | intel_nav_warnings | NGA maritime navigation warnings | | intel_vessel_snapshot | Naval activity at 9 strategic waterways |

Geospatial Datasets (10)

| Tool | Description | |------|-------------| | intel_military_bases | 70 military bases from 9 operators | | intel_strategic_ports | 40 strategic ports across 6 types | | intel_pipelines | 24 oil/gas/hydrogen pipelines | | intel_nuclear_facilities | 24 nuclear power/enrichment/research facilities | | intel_undersea_cables | 34 submarine communications cables | | intel_ai_datacenters | 48 AI/HPC datacenters worldwide | | intel_spaceports | 27 global spaceports | | intel_critical_minerals | 27 strategic mineral deposits | | intel_stock_exchanges | 82 stock exchanges worldwide | | intel_trade_routes | Major trade routes and chokepoints |

News & Media (3)

| Tool | Description | |------|-------------| | intel_news_feed | 80+ global RSS feeds with 4-tier source ranking | | intel_trending_keywords | Trending terms with spike detection | | intel_gdelt_search | GDELT 2.0 global news search |

Intelligence Analysis (8)

| Tool | Description | |------|-------------| | intel_signal_convergence | Geographic convergence of multi-domain signals | | intel_focal_points | Multi-signal focal point detection | | intel_signal_summary | Country-level signal aggregation | | intel_temporal_anomalies | Activity deviations from baselines | | intel_instability_index | Country Instability Index v2 (0-100) | | intel_risk_scores | ACLED-based conflict risk scoring | | intel_hotspot_escalation | Escalation scores for 22 intel hotspots | | intel_country_dossier | Comprehensive country intelligence dossier |

NLP Intelligence (4)

| Tool | Description | |------|-------------| | intel_extract_entities | Named entity extraction (countries, leaders, orgs, CVEs, APTs) | | intel_classify_event | Event classification into 14 threat categories | | intel_news_clusters | Topic clustering by Jaccard similarity | | intel_keyword_spikes | Keyword spike detection with Welford's algorithm |

Strategic Synthesis (4)

| Tool | Description | |------|-------------| | intel_strategic_posture | Composite global risk from 9 weighted domains | | intel_world_brief | Structured daily intelligence summary | | intel_fleet_report | Naval fleet activity report with readiness scoring | | intel_population_exposure | Population at risk near active events (105-city dataset) |

Climate (1)

| Tool | Description | |------|-------------| | intel_climate_anomalies | Open-Meteo temperature/precipitation anomalies |

Prediction Markets (1)

| Tool | Description | |------|-------------| | intel_prediction_markets | Polymarket prediction contracts |

Elections (1)

| Tool | Description | |------|-------------| | intel_election_calendar | Global election calendar with risk scoring |

Displacement (1)

| Tool | Description | |------|-------------| | intel_displacement_summary | UNHCR refugee/IDP statistics |

Aviation (2)

| Tool | Description | |------|-------------| | intel_airport_delays | FAA airport delay status | | intel_aviation_domestic | Global air traffic snapshot from OpenSky |

Cyber Threats (1)

| Tool | Description | |------|-------------| | intel_cyber_threats | Aggregated cyber intel (URLhaus, CISA KEV, SANS) |

Space Weather (1)

| Tool | Description | |------|-------------| | intel_space_weather | Solar activity (Kp index, X-ray flux, SWPC alerts) |

AI & Technology (4)

| Tool | Description | |------|-------------| | intel_ai_releases | arXiv AI papers, HuggingFace models | | intel_hacker_news | Hacker News top stories | | intel_trending_repos | GitHub trending repositories | | intel_arxiv_papers | arXiv paper search |

Health (1)

| Tool | Description | |------|-------------| | intel_disease_outbreaks | WHO DON, ProMED, CIDRAP outbreaks |

Social & Sanctions (3)

| Tool | Description | |------|-------------| | intel_social_signals | Reddit geopolitical discussion velocity | | intel_sanctions_search | OFAC SDN list search | | intel_nuclear_monitor | Seismic monitoring near nuclear test sites |

Shipping & Trade (1)

| Tool | Description | |------|-------------| | intel_shipping_index

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: marc-shade
• Source: marc-shade/world-intel-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.