Real-time global intelligence across 30+ domains with 109 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
Add this skill
npx mdskills install marc-shade/world-intel-mcpComprehensive real-time intelligence MCP server with 109+ tools across 30+ domains and vector search
123# World Intelligence MCP Server45[](https://modelcontextprotocol.io)6[](https://python.org)7[](LICENSE)89Real-time global intelligence across **30+ domains** with **109 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.1011Built 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.1213---1415## What You Get1617| Domain | Tools | Data Sources |18|--------|-------|-------------|19| **Financial Markets** | 7 | Yahoo Finance, CoinGecko, Alternative.me, Mempool |20| **Forex & Currency** | 3 | ECB/Frankfurter (8 major pairs, timeseries, cross rates) |21| **Bonds & Yields** | 2 | FRED, Yahoo Finance (yield curve, bond ETFs, spread analysis) |22| **Earnings** | 2 | Yahoo Finance (mega-cap calendar, surprise history) |23| **SEC Filings** | 3 | SEC EDGAR (full-text search, company filings, 8-K material events) |24| **Company Enrichment** | 1 | Yahoo Finance + GDELT + SEC + GitHub (composite profile) |25| **Macro Composite** | 1 | Weighted 6-signal market verdict (Fear&Greed, VIX, sectors, DXY, BTC, yields) |26| **Economic Indicators** | 3 | EIA energy, FRED macro, World Bank |27| **Central Banks** | 1 | 8 central bank policy rates |28| **BTC Technicals** | 1 | SMA 50/200, golden/death cross, Mayer Multiple |29| **Natural Disasters** | 2 | USGS earthquakes, NASA FIRMS wildfires |30| **Environmental** | 2 | NASA EONET, GDACS disaster alerts |31| **Climate** | 1 | Open-Meteo temperature/precipitation anomalies |32| **Conflict & Security** | 4 | ACLED events, UCDP, unrest detection, humanitarian data |33| **Military & Defense** | 6 | adsb.lol, OpenSky, hexdb.io, surge detection, theater posture, aircraft batch |34| **Infrastructure** | 4 | Cloudflare Radar, submarine cables, cascade analysis, cloud status |35| **Maritime** | 2 | NGA navigation warnings, vessel snapshots |36| **Aviation** | 2 | FAA airport delays, domestic flight snapshot |37| **News & Media** | 3 | 80+ RSS feeds (4-tier), GDELT, trending keywords |38| **Intelligence Analysis** | 8 | Signal convergence, focal points, instability index, risk scores, escalation |39| **NLP Intelligence** | 4 | Entity extraction, event classification, news clustering, keyword spikes |40| **Strategic Synthesis** | 4 | Strategic posture, world brief, fleet report, population exposure |41| **Geospatial** | 11 | Military bases, ports, pipelines, nuclear facilities, cables, datacenters, spaceports, minerals, exchanges, trade routes, cloud regions |42| **AI & Technology** | 4 | arXiv papers, HuggingFace models, Hacker News, GitHub trending |43| **Cyber Threats** | 1 | URLhaus, Feodotracker, CISA KEV, SANS |44| **Health** | 1 | WHO DON, ProMED, CIDRAP disease outbreaks |45| **Space Weather** | 1 | NOAA SWPC (Kp index, solar flares, alerts) |46| **Social & Sanctions** | 3 | Reddit velocity, OFAC SDN list, nuclear test site monitoring |47| **Country Intelligence** | 3 | Country brief, country stocks, financial centers |48| **Prediction Markets** | 1 | Polymarket event contracts |49| **Elections** | 1 | Global election calendar with risk scoring |50| **Displacement** | 1 | UNHCR refugee/IDP data |51| **Shipping** | 1 | Dry bulk shipping stress index |52| **Government** | 1 | USAspending.gov federal contracts |53| **Traffic** | 2 | Road traffic flow, real-time incidents |54| **Cross-Domain Alerts** | 2 | Alert digest, weekly trends |55| **Monitoring** | 2 | Webcams, server health/status |56| **Vector Search** | 5 | Qdrant semantic search, similarity, timeline, stats |57| **Cross-Domain Analytics** | 3 | Correlation, domain summary, trend detection |58| **Reports** | 1 | PDF/HTML multi-domain intelligence reports |5960**Total: 110 tools** across 30+ intelligence domains.6162---6364## Quick Start6566### Install6768```bash69git clone https://github.com/marc-shade/world-intel-mcp.git70cd world-intel-mcp71pip install -e .7273# Optional extras74pip install -e ".[dashboard]" # Live ops-center dashboard75pip install -e ".[vector]" # Qdrant vector store + FastEmbed76pip install -e ".[dev]" # pytest, respx, coverage77```7879### Run as MCP Server8081```bash82world-intel-mcp # stdio mode for Claude Code, Cursor, etc.83```8485### Claude Code Configuration8687Add to `~/.claude.json`:8889```json90{91 "mcpServers": {92 "world-intel-mcp": {93 "command": "world-intel-mcp"94 }95 }96}97```9899### Dashboard100101```bash102intel-dashboard # http://localhost:8501103intel-dashboard --port 9000 # custom port104```105106### PDF/HTML Reports107108```bash109pip install -e ".[pdf]" # requires: brew install pango (macOS)110intel report # full PDF report → ~/.cache/world-intel-mcp/111intel report --format html # HTML (no native deps needed)112intel report -o brief.pdf # custom output path113intel report -s markets,cyber,earthquakes # select sections114```115116Map-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.117118### CLI119120```bash121intel markets # stock indices122intel earthquakes --min-mag 5.0123intel status # cache + circuit breaker health124```125126---127128## Architecture129130```131server.py (MCP stdio) ─┐ ┌─ VectorStore (Qdrant)132cli.py (Click CLI) ├─> sources/*.py ─> Fetcher ─> CircuitBreaker ─┤133dashboard.py (SSE) │ analysis/*.py └─ Cache (SQLite)134collector.py (daemon) ─┘135```136137- **Fetcher**: Centralized async HTTP client (httpx). Retries, per-source rate limiting, stale-data fallback. Auto-stores results in vector store on fresh fetches.138- **CircuitBreaker**: Per-source tracking. 3 consecutive failures trips for 5 minutes. Each RSS feed gets its own breaker.139- **Cache**: SQLite WAL-mode TTL cache. `get()` returns live data, `get_stale()` returns expired data for fallback.140- **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.141- **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).142- **Sources** (`sources/*.py`): 30+ modules, each exports `async def fetch_*(fetcher, **kwargs) -> dict`.143- **Analysis** (`analysis/*.py`): Cross-domain synthesis — signal aggregation, instability indexing, NLP, company enrichment, macro composite.144- **Config** (`config/*.py`): Curated datasets — 22 hotspots, 70+ bases, 40 ports, 24 pipelines, 24 nuclear facilities, 34 cables, 48 datacenters, 27 spaceports, 82 exchanges.145146---147148## MCP Tools Reference149150### Financial Markets (7)151| Tool | Description |152|------|-------------|153| `intel_market_quotes` | Stock index quotes (S&P 500, Dow, Nasdaq, FTSE, Nikkei) |154| `intel_crypto_quotes` | Top crypto prices and market caps from CoinGecko |155| `intel_stablecoin_status` | Stablecoin peg health (USDT, USDC, DAI, FDUSD) |156| `intel_etf_flows` | Bitcoin spot ETF prices and volumes |157| `intel_sector_heatmap` | US equity sector performance (11 SPDR ETFs) |158| `intel_macro_signals` | 7 macro indicators (Fear & Greed, VIX, DXY, gold, 10Y, BTC) |159| `intel_commodity_quotes` | Commodity futures (gold, silver, crude, natgas, grains) |160161### Forex & Currency (3)162| Tool | Description |163|------|-------------|164| `intel_forex_rates` | Latest FX rates from ECB. Filter by base/target currencies |165| `intel_forex_timeseries` | Historical FX rate with trend analysis (configurable days) |166| `intel_major_crosses` | All 8 major pairs + cross rates + DXY proxy |167168### Bonds & Yields (2)169| Tool | Description |170|------|-------------|171| `intel_yield_curve` | US Treasury yield curve (2Y-30Y), 2s10s/3m10y spreads, inversion flag |172| `intel_bond_indices` | Bond ETFs: AGG, TLT, HYG, LQD, TIP with price/change |173174### Earnings (2)175| Tool | Description |176|------|-------------|177| `intel_earnings_calendar` | Upcoming earnings for 20 mega-cap stocks with EPS estimates |178| `intel_earnings_surprise` | Historical earnings surprise (actual vs estimate, trend) |179180### SEC Filings (3)181| Tool | Description |182|------|-------------|183| `intel_sec_filings` | Full-text search across all EDGAR filings |184| `intel_company_filings` | Company filings by ticker (10-K, 10-Q, 8-K) with CIK resolution |185| `intel_recent_8k` | Latest 8-K material events (M&A, exec changes, earnings) |186187### Company Enrichment (1)188| Tool | Description |189|------|-------------|190| `intel_company_profile` | Composite profile: stock quote + financials + news + SEC + GitHub |191192### Macro Composite (1)193| Tool | Description |194|------|-------------|195| `intel_macro_composite` | Weighted market score (0-100) with verdict: RISK_ON to STRONG_CAUTION |196197### Economic (3)198| Tool | Description |199|------|-------------|200| `intel_energy_prices` | Brent/WTI crude oil and natural gas from EIA |201| `intel_fred_series` | FRED economic data (GDP, CPI, unemployment, rates) |202| `intel_world_bank_indicators` | World Bank development indicators by country |203204### Central Banks (1)205| Tool | Description |206|------|-------------|207| `intel_central_bank_rates` | Policy rates for 8 major central banks |208209### BTC Technicals (1)210| Tool | Description |211|------|-------------|212| `intel_btc_technicals` | Bitcoin SMA 50/200, golden/death cross, Mayer Multiple |213214### Natural Disasters (2)215| Tool | Description |216|------|-------------|217| `intel_earthquakes` | USGS earthquakes (configurable magnitude/time/limit) |218| `intel_wildfires` | NASA FIRMS satellite fire hotspots (9 global regions) |219220### Environmental (2)221| Tool | Description |222|------|-------------|223| `intel_environmental_events` | NASA EONET natural events |224| `intel_disaster_alerts` | GDACS disaster alerts with severity scoring |225226### Conflict & Security (4)227| Tool | Description |228|------|-------------|229| `intel_acled_events` | ACLED armed conflict events |230| `intel_ucdp_events` | Uppsala Conflict Data Program events |231| `intel_unrest_events` | Social unrest with Haversine dedup |232| `intel_humanitarian_summary` | HDX humanitarian crisis datasets |233234### Military & Defense (6)235| Tool | Description |236|------|-------------|237| `intel_military_flights` | Military aircraft via adsb.lol (OpenSky fallback) |238| `intel_theater_posture` | Activity across 5 theaters (EU, Indo-Pacific, ME, Arctic, Korea) |239| `intel_aircraft_details` | Aircraft lookup by ICAO24 hex (hexdb.io) |240| `intel_aircraft_batch` | Batch aircraft lookup (multiple hex codes) |241| `intel_military_surge` | Foreign aircraft concentration anomaly detection |242| `intel_usni_fleet` | USNI News naval fleet tracker |243244### Infrastructure (4)245| Tool | Description |246|------|-------------|247| `intel_internet_outages` | Cloudflare Radar internet disruptions |248| `intel_cable_health` | Submarine cable corridor health |249| `intel_cascade_analysis` | Infrastructure cascade simulation |250| `intel_service_status` | Cloud platform health (AWS, Azure, GCP, Cloudflare, GitHub) |251252### Maritime (2)253| Tool | Description |254|------|-------------|255| `intel_nav_warnings` | NGA maritime navigation warnings |256| `intel_vessel_snapshot` | Naval activity at 9 strategic waterways |257258### Geospatial Datasets (10)259| Tool | Description |260|------|-------------|261| `intel_military_bases` | 70 military bases from 9 operators |262| `intel_strategic_ports` | 40 strategic ports across 6 types |263| `intel_pipelines` | 24 oil/gas/hydrogen pipelines |264| `intel_nuclear_facilities` | 24 nuclear power/enrichment/research facilities |265| `intel_undersea_cables` | 34 submarine communications cables |266| `intel_ai_datacenters` | 48 AI/HPC datacenters worldwide |267| `intel_spaceports` | 27 global spaceports |268| `intel_critical_minerals` | 27 strategic mineral deposits |269| `intel_stock_exchanges` | 82 stock exchanges worldwide |270| `intel_trade_routes` | Major trade routes and chokepoints |271272### News & Media (3)273| Tool | Description |274|------|-------------|275| `intel_news_feed` | 80+ global RSS feeds with 4-tier source ranking |276| `intel_trending_keywords` | Trending terms with spike detection |277| `intel_gdelt_search` | GDELT 2.0 global news search |278279### Intelligence Analysis (8)280| Tool | Description |281|------|-------------|282| `intel_signal_convergence` | Geographic convergence of multi-domain signals |283| `intel_focal_points` | Multi-signal focal point detection |284| `intel_signal_summary` | Country-level signal aggregation |285| `intel_temporal_anomalies` | Activity deviations from baselines |286| `intel_instability_index` | Country Instability Index v2 (0-100) |287| `intel_risk_scores` | ACLED-based conflict risk scoring |288| `intel_hotspot_escalation` | Escalation scores for 22 intel hotspots |289| `intel_country_dossier` | Comprehensive country intelligence dossier |290291### NLP Intelligence (4)292| Tool | Description |293|------|-------------|294| `intel_extract_entities` | Named entity extraction (countries, leaders, orgs, CVEs, APTs) |295| `intel_classify_event` | Event classification into 14 threat categories |296| `intel_news_clusters` | Topic clustering by Jaccard similarity |297| `intel_keyword_spikes` | Keyword spike detection with Welford's algorithm |298299### Strategic Synthesis (4)300| Tool | Description |301|------|-------------|302| `intel_strategic_posture` | Composite global risk from 9 weighted domains |303| `intel_world_brief` | Structured daily intelligence summary |304| `intel_fleet_report` | Naval fleet activity report with readiness scoring |305| `intel_population_exposure` | Population at risk near active events (105-city dataset) |306307### Climate (1)308| Tool | Description |309|------|-------------|310| `intel_climate_anomalies` | Open-Meteo temperature/precipitation anomalies |311312### Prediction Markets (1)313| Tool | Description |314|------|-------------|315| `intel_prediction_markets` | Polymarket prediction contracts |316317### Elections (1)318| Tool | Description |319|------|-------------|320| `intel_election_calendar` | Global election calendar with risk scoring |321322### Displacement (1)323| Tool | Description |324|------|-------------|325| `intel_displacement_summary` | UNHCR refugee/IDP statistics |326327### Aviation (2)328| Tool | Description |329|------|-------------|330| `intel_airport_delays` | FAA airport delay status |331| `intel_aviation_domestic` | Global air traffic snapshot from OpenSky |332333### Cyber Threats (1)334| Tool | Description |335|------|-------------|336| `intel_cyber_threats` | Aggregated cyber intel (URLhaus, CISA KEV, SANS) |337338### Space Weather (1)339| Tool | Description |340|------|-------------|341| `intel_space_weather` | Solar activity (Kp index, X-ray flux, SWPC alerts) |342343### AI & Technology (4)344| Tool | Description |345|------|-------------|346| `intel_ai_releases` | arXiv AI papers, HuggingFace models |347| `intel_hacker_news` | Hacker News top stories |348| `intel_trending_repos` | GitHub trending repositories |349| `intel_arxiv_papers` | arXiv paper search |350351### Health (1)352| Tool | Description |353|------|-------------|354| `intel_disease_outbreaks` | WHO DON, ProMED, CIDRAP outbreaks |355356### Social & Sanctions (3)357| Tool | Description |358|------|-------------|359| `intel_social_signals` | Reddit geopolitical discussion velocity |360| `intel_sanctions_search` | OFAC SDN list search |361| `intel_nuclear_monitor` | Seismic monitoring near nuclear test sites |362363### Shipping & Trade (1)364| Tool | Description |365|------|-------------|366| `intel_shipping_index` | Dry bulk shipping stress index |367368### Government (1)369| Tool | Description |370|------|-------------|371| `intel_usa_spending` | USAspending.gov federal contracts |372373### Country Intelligence (3)374| Tool | Description |375|------|-------------|376| `intel_country_brief` | Quick country situation summary |377| `intel_country_stocks` | Stock exchanges and listings by country |378| `intel_financial_centers` | Global financial centers ranking |379380### Extended Geospatial (1)381| Tool | Description |382|------|-------------|383| `intel_cloud_regions` | Cloud provider regions worldwide |384385### Traffic (2)386| Tool | Description |387|------|-------------|388| `intel_traffic_flow` | Road traffic flow data |389| `intel_traffic_incidents` | Real-time traffic incidents |390391### Cross-Domain Alerts (2)392| Tool | Description |393|------|-------------|394| `intel_alert_digest` | Cross-domain alert aggregation |395| `intel_weekly_trends` | Weekly trend analysis |396397### Monitoring (2)398| Tool | Description |399|------|-------------|400| `intel_webcams` | Public webcam locations and live previews |401| `intel_status` | Server health, cache stats, circuit breaker status |402403### Vector Search (5)404| Tool | Description |405|------|-------------|406| `intel_semantic_search` | Natural language search across all accumulated intelligence |407| `intel_similar_events` | Find events similar to a given data point |408| `intel_timeline` | Chronological view of intelligence for a domain/category |409| `intel_vector_stats` | Vector store collection statistics |410| `intel_collect` | Trigger an on-demand collection cycle |411412### Cross-Domain Analytics (3)413| Tool | Description |414|------|-------------|415| `intel_cross_correlate` | Find correlated signals across all domains for a given topic |416| `intel_domain_summary` | Per-category summary of stored intelligence (counts, sources, recency) |417| `intel_trend_detection` | Detect activity surges/drops by comparing recent vs baseline periods |418419### Reports (1)420421| Tool | Description |422|------|-------------|423| `intel_generate_report` | Generate a PDF or HTML intelligence report covering 18 domains in parallel |424425---426427## Vector Store428429The optional Qdrant vector store accumulates intelligence over time for semantic retrieval. All data fetched through the Fetcher is automatically embedded and stored.430431### Setup432433```bash434# Install Qdrant (Docker)435docker run -p 6333:6333 qdrant/qdrant436437# Install vector dependencies438pip install -e ".[vector]"439440# Run the collector daemon (populates vector store 24/7)441intel-collector --daemon # every 5 minutes442intel-collector --daemon --interval 120 # every 2 minutes443intel-collector --sources markets,cyber # specific domains only444intel-collector # single collection cycle445```446447### Semantic Search Examples448449Once data accumulates, AI agents can query across all domains:450451- *"military activity near Taiwan strait"* — finds military flights, naval warnings, theater posture data452- *"cyber threats targeting healthcare"* — finds URLhaus, CISA KEV entries related to healthcare453- *"economic indicators suggesting recession"* — finds yield curve inversions, macro signals, FRED data454455The vector store uses FastEmbed (ONNX-based, BAAI/bge-small-en-v1.5) for embeddings — no GPU required, ~3 second cold start.456457---458459## Environment Variables460461| Variable | Required | Description |462|----------|----------|-------------|463| `ACLED_ACCESS_TOKEN` | No | ACLED conflict events |464| `NASA_FIRMS_API_KEY` | No | Satellite wildfire data |465| `EIA_API_KEY` | No | Energy price data |466| `CLOUDFLARE_API_TOKEN` | No | Internet outage data |467| `FRED_API_KEY` | No | Macro economic data (also used for yield curve) |468| `OPENSKY_CLIENT_ID` | No | Military flight fallback |469| `OPENSKY_CLIENT_SECRET` | No | Military flight fallback |470| `WORLD_INTEL_LOG_LEVEL` | No | Logging level (default: INFO) |471472Everything else uses free, unauthenticated public APIs.473474---475476## Development477478```bash479pip install -e ".[dev]"480pytest # 186 tests481pytest --cov=world_intel_mcp # with coverage482pytest tests/test_forex.py -v # single module483```484485### Adding a New Source4864871. Create `sources/your_source.py` with `async def fetch_your_data(fetcher: Fetcher, **kwargs) -> dict`4882. Use `fetcher.get_json(url, source="your-source", cache_key=..., cache_ttl=300)` — automatic caching, retries, circuit breaking, rate limiting4893. In `server.py`: add `Tool(...)` to `TOOLS`, add `case` to `_dispatch()` (use inline import)4904. Add tests using `respx` to mock HTTP (see `tests/test_forex.py` for pattern)4915. Optionally add to `dashboard/app.py` (SSE) and `cli.py` (Click)492493---494495## License496497MIT498
Full transparency — inspect the skill content before installing.