
World Intelligence MCP Server by marc-shade: Setup for Claude and Cursor
Lets Claude and Cursor pull markets, conflict, disaster, cyber and news data from free public sources.
This is a community project by marc-shade. It collects data from free public feeds such as USGS, SEC EDGAR, OpenSky and GDELT, and hands it to your assistant as briefs and lookups. It runs on your computer and is installed from the GitHub repo, not from a package index. Most tools need no key, but a few need free keys from the data provider. It keeps a local database of what it fetches.
Good for
- Analysts who want cited briefs on a country, region or event
- Researchers tracking markets, sanctions and SEC filings in one place
- Anyone who wants alerts when something changes inside an area they define
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Local-only server; ChatGPT cannot reach it.
Local-only server; n8n cannot reach it.
Install World Intelligence MCP
Claude Code
- 1
Copy this prompt.
Add the World Intelligence MCP server to Claude Code. Run this command: claude mcp add world-intel -- world-intel-mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Python 3.11+, pip install from the cloned repo.
Not on a package index. Clone https://github.com/marc-shade/world-intel-mcp, run pip install -e . inside it, then use the world-intel-mcp command in your client. Python 3.11 or newer is needed. Optional extras add the dashboard and vector search.
Built from the package data we hold. Not yet tested by us.
Tools
Writes a cited brief of what is happening
Gathers a bounded overview across the data sources and returns a situation brief with a numbered source list.
Try: “Give me a situation brief for today.”
Network ·
intel_situation_briefMorning brief across all domains
Returns a cited markdown digest of top current events by domain, with recent headlines.
Try: “Give me the daily intelligence digest.”
Network ·
intel_daily_digestDaily summary of global risk
Returns a structured summary with risk overview, focal areas, top story clusters and anomalies.
Try: “Show the world brief.”
Network ·
intel_world_briefScores global risk across nine areas
Combines military, political, conflict, infrastructure and other domains into one composite risk view.
Try: “What is the global strategic posture?”
Network ·
intel_strategic_postureBuilds a country profile
Compiles economy, stock market, elections, sanctions and news for one country.
Try: “Make a dossier on Taiwan.”
Network ·
intel_country_dossierWrites a country brief
Generates a brief from World Bank and ACLED data, using a local Ollama model when available and data only otherwise.
Try: “Brief me on Ethiopia.”
Network ·
intel_country_briefScores country instability
Computes a 0 to 100 instability score from unrest, conflict, security and information signals.
Try: “Which countries have the highest instability score?”
Network ·
intel_instability_indexScores 22 global hotspots
Gives escalation scores from baseline risk, military activity and conflict signals.
Try: “Which hotspots are escalating?”
Network ·
intel_hotspot_escalationFinds where signals overlap
Detects places where earthquakes, conflict and military activity coincide.
Try: “Where are multiple signals converging?”
Network ·
intel_signal_convergenceSaves a named area to watch
Stores a named circle (point and radius) as an area of interest for later briefs and change checks. It is saved on your machine.
Try: “Define an area called Pittsburgh, 50 km around 40.44, -79.99.”
Write ·
intel_aoi_defineSaves a polygon area to watch
Stores a named area bounded by 3 to 64 points, such as a strait or border region.
Try: “Define the Taiwan Strait as a polygon.”
Write ·
intel_aoi_define_polygonSaves a route area to watch
Stores a route of waypoints with a width, such as a shipping lane.
Try: “Define the Suez approach as a corridor 80 km wide.”
Write ·
intel_aoi_define_corridorEdits a saved area
Renames or resizes a saved area without losing its history.
Try: “Resize Pittsburgh to 100 km.”
Write ·
intel_aoi_updateDeletes a saved area
Deletes a user-defined area of interest by name.
Try: “Delete the Pittsburgh area.”
Delete ·
intel_aoi_deleteLists your saved areas
Lists all areas of interest you have defined.
Try: “List my areas.”
Read ·
intel_aoi_listBriefs one saved area
Returns a cited brief for one area covering earthquakes, military flights, wildfires, conflict events and more.
Try: “Brief me on the Taiwan Strait area.”
Network ·
intel_aoi_briefShows what changed in an area
Shows what entered or left a saved area since the last sweep.
Try: “What changed in Suez Approach?”
Write ·
intel_aoi_changesSweeps all saved areas
Runs the change check across every area you defined in one call.
Try: “Run my area digest.”
Write ·
intel_aoi_digestLists recent earthquakes
Gets recent earthquakes from USGS.
Try: “Any big earthquakes this week?”
Network ·
intel_earthquakesTracks military aircraft
Looks up military aircraft through the OpenSky Network, optionally in a bounding box.
Try: “Show military flights over the Black Sea.”
Network ·
intel_military_flightsShows military air presence by region
Counts military aircraft across five theaters such as Europe, the Indo-Pacific and the Middle East.
Try: “What is the military air posture in the Indo-Pacific?”
Network ·
intel_theater_postureShows US Navy fleet positions
Reads the USNI Fleet Tracker for ships, carrier groups and regions.
Try: “Where are the US carrier groups?”
Network ·
intel_usni_fleetLists armed conflict events
Gets conflict events from ACLED by country and days. It needs ACLED sign-in details.
Try: “Show conflict events in Sudan this week.”
Network ·
intel_acled_eventsLists state-based violence events
Gets events from the UCDP dataset; the README says the API needs an access token.
Try: “Show recent UCDP events.”
Network ·
intel_ucdp_eventsSummarizes cyber threat feeds
Combines four public feeds including CISA KEV and URLhaus.
Try: “What are the latest cyber threats?”
Network ·
intel_cyber_threatsFlags disease outbreaks
Combines WHO, ProMED and CIDRAP alerts and flags high-concern pathogens.
Try: “Any new outbreaks?”
Network ·
intel_disease_outbreaksGets stock index quotes
Gets index quotes such as the S&P 500, Dow and Nikkei.
Try: “How are the major indexes doing?”
Network ·
intel_market_quotesGets crypto prices
Gets top coin prices, market caps and 7-day trends from CoinGecko.
Try: “Show the top 10 crypto prices.”
Network ·
intel_crypto_quotesGets commodity prices
Gets gold, silver, oil, natural gas and grain futures.
Try: “What are oil and gold at?”
Network ·
intel_commodity_quotesShows the US Treasury yield curve
Returns maturities from 2 to 30 years, key spreads and inversion detection. It uses a FRED key.
Try: “Is the yield curve inverted?”
Network ·
intel_yield_curveGets Federal Reserve data series
Gets series such as GDP, unemployment and CPI. It needs a FRED key.
Try: “Show US CPI for the last two years.”
Network ·
intel_fred_seriesLists central bank rates
Gives policy rates for 15 major central banks.
Try: “What are the Fed and ECB rates?”
Network ·
intel_central_bank_ratesLists Polymarket odds
Gets active Polymarket questions with probabilities and volumes.
Try: “What are the top prediction markets?”
Network ·
intel_prediction_marketsSearches SEC filings
Runs a full-text search of SEC EDGAR by form type and dates.
Try: “Find recent 8-K filings mentioning tariffs.”
Network ·
intel_sec_filingsLists a company's filings
Gets recent 10-K, 10-Q and 8-K filings for a ticker.
Try: “Show Nvidia's latest filings.”
Network ·
intel_company_filingsSearches the OFAC sanctions list
Searches the US Treasury SDN list by name or country.
Try: “Is this company on the OFAC list?”
Network ·
intel_sanctions_searchReads the news feeds
Aggregates 119 RSS feeds across 24 categories.
Try: “Show the latest security headlines.”
Network ·
intel_news_feedSearches global news
Searches GDELT for articles or volume timelines.
Try: “Search GDELT for coverage of the election.”
Network ·
intel_gdelt_searchLooks up military bases
Queries a built-in dataset of 120+ bases from nine operators.
Try: “List Chinese bases in the South China Sea.”
Read ·
intel_military_basesLooks up undersea cables
Queries a built-in dataset of 30+ cable routes with landing points and capacity.
Try: “Which cables land in Egypt?”
Read ·
intel_undersea_cablesShows solar activity
Gets Kp index, flare class and solar wind from NOAA.
Try: “Is there a solar storm?”
Network ·
intel_space_weatherLists severe US weather alerts
Gets active National Weather Service alerts.
Try: “Any severe weather alerts in Texas?”
Network ·
intel_weather_alertsSearches stored history
Searches the intelligence data you have stored locally using natural language. It needs the optional vector extra.
Try: “Search my history for Taiwan Strait activity.”
Files ·
intel_semantic_searchPulls fresh data into storage
Triggers a collection cycle that fetches the sources and stores the results locally.
Try: “Run a collection cycle.”
Write ·
intel_collectMakes a PDF or HTML report
Generates a report covering markets, conflict, earthquakes, cyber and more, and returns the file path.
Try: “Generate an intelligence report as PDF.”
Write ·
intel_generate_reportShows server health
Reports source health, cache freshness and statistics.
Try: “Is the server healthy?”
Read ·
intel_status
Read from the source code
Permissions
medium risk · 4 things to watch
Medium risk
The assistant reads public data from many providers and writes a local cache and any areas you define. The one delete tool only removes your own saved areas.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It deletes saved areas
intel_aoi_delete removes an area you defined. It only touches the server's own local data, not remote accounts. github.com
It keeps a local database of what it fetches
Results and history go to a SQLite file at ~/.cache/world-intel-mcp/cache.db by default, kept for a year unless you change the retention settings. Set WORLD_INTEL_CACHE_DB to move it. github.com
Tool results are third-party text
News, feeds and filings come from the open internet. Treat them as untrusted text, since a headline can try to steer the model. github.com
Built as a single-user local tool
The security policy says it is meant to run as a stdio server under one user account on that user's machine. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. Most tools only read; the area-of-interest, collect and report tools write local files. |
|---|---|
| Talks to | Public data providers such as USGS, SEC EDGAR, OpenSky, GDELT, CoinGecko and Polymarket |
| Sign-in and keys | No sign-in for the server. Optional provider keys are read from environment variables. |
| Scopes |
|
Questions
Is the World Intelligence MCP server official?
No. It is a community project by marc-shade. It is not made by any of the data providers it reads.
Does it need API keys?
No keys are needed to start. A few tools need free provider keys, such as FRED for macro data, ACLED for conflict events and NASA FIRMS for wildfires.
How do I install it?
It is not on npm or PyPI. Clone the GitHub repo and install it with pip as shown in the install box, then point your client at the world-intel-mcp command.
How many tools does it have?
The latest release, v0.10.0, registers 132 tools. The main branch is at version 0.11.0 and registers 160, so a fresh clone of main has more than the release. This page lists 46 of them, so the list is partial.
Does it save data on my computer?
Yes. It keeps a cache and history database and any areas you define in a SQLite file under ~/.cache/world-intel-mcp by default.
Can it send data to a third party?
It calls public data providers to get its results. The situation brief and country brief tools use a local Ollama model if you run one, and fall back to a plain data summary if not.
Which clients does it work in?
Clients that start a local program, such as Claude Code, Claude Desktop and Cursor. ChatGPT and n8n cannot reach a local server.
Information
updated Nov 2, 2026
- Publisher
- Community
- Transport
- stdio
- Auth
- None
- Version
- 0.10.0
- License
- MIT
- Last commit
- Oct 18, 2026
- Open issues
- 0
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 5Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com