Skip to main content
Glama

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.

PyPI version Python 3.11+ MIT License CI Publish

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

get_prediction_odds

Polymarket

Ranked event odds (probability %, volume, end date) for a query

get_prediction_event_by_id

Polymarket

Odds for a specific event id or slug

lookup_aircraft_state

OpenSky Network

Latest ADS-B state for a tail number (N-Number) or ICAO24 hex

convert_nnumber

— (offline)

Pure-Python FAA N-Number ↔ ICAO24 conversion, no network needed

get_global_events

GDELT 2.0

High-impact events for a country, ranked by Goldstein scale

check_network_anomalies

Cloudflare Radar

BGP hijacks + leaks and regional outage annotations

get_macro_alert

GDELT + Cloudflare

Composite convergence signal with explanation string


Quickstart

1. Install

uvx global-sentinel-mcp

Or install from PyPI:

pip install global-sentinel-mcp

2. 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-mcp

The 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-check

Claude 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

OPENSKY_CLIENT_ID

aviation (OAuth2, preferred)

OpenSky OAuth2 client id — register free

OPENSKY_CLIENT_SECRET

aviation (OAuth2, preferred)

OpenSky OAuth2 client secret

OPENSKY_USERNAME

aviation (legacy)

OpenSky Basic Auth username (pre-2025 accounts)

OPENSKY_PASSWORD

aviation (legacy)

OpenSky Basic Auth password

CLOUDFLARE_API_TOKEN

BGP + outages

Cloudflare API token with Radar read permissions

LOG_LEVEL

—

Python log level (DEBUG / INFO / WARNING / ERROR). Default INFO.

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 tools
check_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

    A4.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Real-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.
      -
    • A
      license
      C
      quality
      D
      maintenance
      MCP 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.
      32
      8
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Multi-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