global-sentinel-mcp
Provides tools to check network anomalies (BGP hijacks, leaks) and outage annotations via Cloudflare Radar API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@global-sentinel-mcp get macro alert for geopolitical risks"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
global-sentinel-mcp
An async MCP server unifying prediction markets, global news events, aviation state, and internet-infrastructure telemetry into one alternative-data layer for macro and financial analysis.
Status: Beta — ready for production use; public API may still shift before 1.0.
Why this exists
Alternative data — prediction-market odds, real-time geopolitical event streams, live aviation transponder data, and internet-infrastructure telemetry — is increasingly central to macro and financial analysis. Each source has its own API shape, authentication model, and update cadence, making it tedious to wire them together for every new project.
global-sentinel-mcp closes that gap by wrapping four public data feeds behind
a single Model Context Protocol (MCP) interface. An LLM agent can ask
probability, event, aviation-state, and internet-telemetry questions in one
place, without knowing the upstream API details. It also exposes a composite
macro alert tool that fuses news events and outage annotations into one
convergence signal with a human-readable explanation.
The server is fully async (httpx.AsyncClient with retry transport), returns
typed Pydantic v2 models for every response and error, ships a TTL cache per
source to stay within upstream rate limits, and installs in one command over
stdio — no web server required.
Related MCP server: pmxt-mcp
Available Tools
Tool | Data Source | What it returns |
| Polymarket | Ranked event odds (probability %, volume, end date) for a query |
| Polymarket | Odds for a specific event id or slug |
| OpenSky Network | Latest ADS-B state for a tail number (N-Number) or ICAO24 hex |
| — (offline) | Pure-Python FAA N-Number ↔ ICAO24 conversion, no network needed |
| GDELT 2.0 | High-impact events for a country, ranked by Goldstein scale |
| Cloudflare Radar | BGP hijacks + leaks and regional outage annotations |
| GDELT + Cloudflare | Composite convergence signal with explanation string |
Quickstart
1. Install
uvx global-sentinel-mcpOr install from PyPI:
pip install global-sentinel-mcp2. Set environment variables (all optional — unset tools degrade gracefully)
# OpenSky — OAuth2 preferred (post-2025 migration), Basic Auth for legacy accounts.
export OPENSKY_CLIENT_ID="your_opensky_client_id"
export OPENSKY_CLIENT_SECRET="your_opensky_client_secret"
# Cloudflare Radar — required for BGP and outage tools.
export CLOUDFLARE_API_TOKEN="your_cf_token"
# Optional.
export LOG_LEVEL="INFO"3. Run
global-sentinel-mcpThe server speaks MCP JSON-RPC over stdio.
Local development
git clone https://github.com/ykshah1309/global-sentinel-mcp
cd global-sentinel-mcp
uv sync --dev
uv run global-sentinel-mcp # run the server
uv run pytest tests/ -v # run the test suite
uv run ruff check src/ tests/ # lint
uv run mypy src/ # type-checkClaude Desktop configuration
Add to claude_desktop_config.json (see claude_desktop_config.example.json):
{
"mcpServers": {
"global-sentinel": {
"command": "uvx",
"args": ["global-sentinel-mcp"],
"env": {
"OPENSKY_CLIENT_ID": "your_opensky_client_id",
"OPENSKY_CLIENT_SECRET": "your_opensky_client_secret",
"CLOUDFLARE_API_TOKEN": "your_cf_token"
}
}
}
}Cursor configuration
Add to .cursor/mcp.json:
{
"mcpServers": {
"global-sentinel": {
"command": "uvx",
"args": ["global-sentinel-mcp"],
"env": {
"OPENSKY_CLIENT_ID": "your_opensky_client_id",
"OPENSKY_CLIENT_SECRET": "your_opensky_client_secret",
"CLOUDFLARE_API_TOKEN": "your_cf_token"
}
}
}
}Environment Variables
Variable | Required for | Description |
| aviation (OAuth2, preferred) | OpenSky OAuth2 client id — register free |
| aviation (OAuth2, preferred) | OpenSky OAuth2 client secret |
| aviation (legacy) | OpenSky Basic Auth username (pre-2025 accounts) |
| aviation (legacy) | OpenSky Basic Auth password |
| BGP + outages | Cloudflare API token with Radar read permissions |
| — | Python log level (DEBUG / INFO / WARNING / ERROR). Default |
Polymarket and GDELT tools require no authentication. Anonymous OpenSky is allowed but heavily rate-limited.
Data Sources
Polymarket (Gamma API)
Crowd-sourced prediction market data. Token prices reflect the crowd's
estimated probability of future events. No API key required. Events expose
outcomes and outcomePrices as JSON-encoded strings — the client parses the
"Yes" leg and returns it as probability_pct.
Docs
GDELT 2.0
The world's largest open-access global news event database, updated every 15 minutes. Events are coded with actors, event types, Goldstein conflict/cooperation scores, and geographic coordinates. Per publish cycle the server downloads and parses the 5 MB export zip exactly once, then answers all country queries from an in-memory DataFrame cache. Docs
OpenSky Network
Public ADS-B flight tracking from a global network of volunteer receivers. Returns real-time position, altitude, velocity, and on-ground status for any aircraft with a Mode S transponder. Post-2025 the service moved to OAuth2 client-credentials; this server handles token refresh automatically and falls back to Basic Auth (legacy) or anonymous if credentials are absent. Docs
Cloudflare Radar
Internet-infrastructure telemetry from Cloudflare's global network. Covers BGP
routing anomalies (/bgp/hijacks/events, /bgp/leaks/events) and regional
outage annotations (/annotations/outages, formerly "traffic anomalies",
renamed by Cloudflare in 2024). Requires a free Cloudflare API token.
Docs
Contributing
See CONTRIBUTING.md for setup instructions, branch naming conventions, testing requirements, and code style guidelines.
License
MIT — Copyright (c) 2026 ykshah1309
Available Tools
7 toolscheck_network_anomaliesA
Check Cloudflare Radar for BGP and internet-outage anomalies.
Input formats:
2-letter country code (
US,CN,IR) → checks BGP hijacks, BGP route leaks, and regional outage annotations for that country.ASN string (
AS15169,AS13335) → checks BGP hijacks and route leaks involving that ASN. Outage annotations require a country and are omitted for ASN-scoped queries.
Requires CLOUDFLARE_API_TOKEN with Radar read permission.
Inputs: country_or_asn (required).
convert_nnumberA
Convert between an FAA N-Number and its ICAO24 hex address.
Input detection is automatic: a leading N followed by digits/letters is
treated as an N-Number; a 6-character hex string as an ICAO24. Returns
both forms plus mode = "n_to_icao" or "icao_to_n". Useful for
cross-referencing aviation data sources that use different identifiers.
Inputs: identifier (required).
get_global_eventsA
Fetch recent high-impact GDELT 2.0 events for a country.
GDELT publishes a new global event export every 15 minutes. Events are
coded with a Goldstein scale from -10 (destabilizing) to +10 (stabilizing).
Pass a 3-letter GDELT country code (e.g. USA, CHN, RUS) or
2-letter FIPS code depending on dataset version.
Results are sorted by Goldstein scale descending and capped at limit.
Each event returns actor country codes, Goldstein score, article count,
and a source URL.
Inputs: country_code (required), min_goldstein_scale, limit.
get_macro_alertA
Composite macro-inflection signal for a region.
Runs three queries concurrently (GDELT events, BGP hijacks, outages) and
emits a single signal_score with a one-line explanation of how the
number was built. Partial failures are tolerated — if one source errors,
the tool still returns the others and records the failure under errors.
Score weighting: |Goldstein| × log(1 + article_count) for each event;
outages weighted by cause (government shutdowns dominate). Zero indicates
a quiet region — the absence of signal is also information.
Inputs: region (required).
get_prediction_event_by_idA
Fetch a single Polymarket event's implied probability by id or slug.
Useful when you already have a Polymarket event identifier (from a prior search, a URL, or an external reference) and want the current odds without re-searching.
Inputs: event_id (required).
get_prediction_oddsA
Search Polymarket for crowd-sourced probability estimates.
Use this tool when the user asks "what are the odds of X?" for any
macro-relevant event — Fed rate decisions, elections, geopolitical
outcomes, commodities. Returns up to limit active markets matching
the query, each with implied probability (0-100), USDC volume, and end
date. Polymarket data is crowd-sourced, not an official forecast.
Example: get_prediction_odds("fed rate cut december", limit=3)
Inputs: query (required), limit.
lookup_aircraft_stateA
Return the latest public ADS-B state vector for a registered aircraft.
Accepts either an FAA N-Number (e.g. N12345, N123AB) or a 6-char
ICAO24 hex (e.g. a061d9). N-Numbers are converted in-process first;
on failure the FAA public registry is consulted as a fallback.
Returns position (lat/lon), barometric altitude (m), ground speed (m/s),
heading (°), on-ground flag, and last-contact timestamp. Requires
OPENSKY_CLIENT_ID + OPENSKY_CLIENT_SECRET (OAuth2, preferred) or
OPENSKY_USERNAME + OPENSKY_PASSWORD (Basic Auth, legacy).
Inputs: tail_or_icao (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct domain: network anomalies, aviation identifiers, geopolitical events, composite alerts, and prediction markets. No two tools perform overlapping functions, so agents can easily distinguish them.
All tool names use snake_case with descriptive verbs like 'check_', 'convert_', 'get_', and 'lookup_'. While different verbs are used, they are appropriate to each action and follow a predictable pattern, with only minor variation.
With 7 tools, the set is well-scoped for a global monitoring server. Each tool provides a specific, non-redundant capability, and the count is manageable for an agent to navigate without being overwhelming or sparse.
The tool surface covers network anomalies, aviation, geopolitical events, and prediction markets, but lacks some expected features like news search or natural disaster monitoring. For a 'sentinel' purpose, there are notable gaps, though core workflows are supported.
Maintenance
Related MCP Connectors
Real-time planetary signal engine and Model Context Protocol (MCP) server for autonomous AI agents.
Hosted MCP server for SEC, FRED, Polymarket, Deribit, OKX, and FMP.
Historical tick, order book and settlement data for Polymarket and Predict.fun crypto up/down markets, plus smart-money lists and backtest quotes, over a read-only MCP server.
Live prices, perps, prediction markets and a paper trading desk over one MCP.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceReal-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.-
- AlicenseCqualityDmaintenanceMCP server that provides a unified prediction market API for multiple venues like Polymarket and Kalshi, allowing AI agents to discover markets, fetch order books, and execute trades through a single interface.328MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for querying and optionally trading across prediction markets (Polymarket, Kalshi, Limitless, Manifold) through a unified API.31MIT
- AlicenseNot gradedqualityDmaintenanceMulti-asset market intelligence MCP server that monitors cryptocurrency movements, equity data, and ECB foreign-exchange reference rates to produce structured market briefs using Gemini.MIT