Odel
MCP server: One MCP server.

WSPR

@qso-graphRun by its publisher: served from their own domain, namespace checked by the registry.MCP server · External

WSPR beacon analytics MCP server. Band openings, path analysis, solar correlation.

Statisticsv0.4.0GPL-3.0Python
Freeno charge per call
How to install

Runs on your machine from its package; the steps are below.

What it does

  1. Reads
  2. Writes
  3. High impact

At most: only reads or looks up information.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

PyPIwspr-mcpv0.4.0

Run

uvx wspr-mcp

MCP client config

{
  "mcpServers": {
    "wspr": {
      "command": "uvx",
      "args": [
        "wspr-mcp"
      ]
    }
  }
}
README4 min read

wspr-mcp

PyPI MCP Registry

MCP server for WSPR (Weak Signal Propagation Reporter) beacon data — live spots, band activity, top beacons, propagation paths, SNR trends, and more through any MCP-compatible AI assistant.

Data from wspr.live (~2.7 billion spots, 2008-present). Part of the qso-graph project. No authentication required — all public data.

Install

bash
uvx wspr-mcp            # run it; nothing to install

Tools

ToolDescriptionKey Parameters
wspr_spotsRecent WSPR spots with flexible filteringcallsign, band, hours, grid, min/max SNR, min distance
wspr_band_activityPer-band spot counts, station counts, distances, and SNRhours
wspr_top_beaconsTop transmitters ranked by spot count or max distanceband, hours, sort_by (spots/distance), limit
wspr_top_spottersTop receivers ranked by spot count or max distanceband, hours, sort_by (spots/distance), limit
wspr_propagationPropagation between two locations — auto-widens to field-level proxy for sparse endpointstx, rx, band, hours
wspr_grid_activityAll WSPR activity in/out of a Maidenhead grid squaregrid (2 or 4 char), band, hours
wspr_longest_pathsLongest distance WSPR paths in a time windowband, hours, min_distance, limit
wspr_snr_trendHourly SNR trend for a specific path over timetx, rx, band, hours
get_version_infoService version + upstream spec version (fleet identity attestation)—

What is WSPR?

WSPR beacons transmit a 2-minute encoded signal at very low power (typically 200 mW to 5 W). Each decoded spot proves a propagation path exists between two locations on a specific band. With thousands of beacons worldwide transmitting 24/7, WSPR provides continuous, automated propagation monitoring across all HF bands.

Good Neighbour Policy

wspr.live is a volunteer-run service that mirrors all wsprnet.org data into a public ClickHouse database. We take our responsibility as a good neighbour seriously:

MeasureDetail
Rate limiting3 seconds between requests (20 req/min max)
Circuit breakerOpens after 3 consecutive failures; exponential backoff up to 5 minutes. Prevents hammering a struggling service.
Time-bounded queriesEvery query filters by time (max 72 hours). No unbounded full-table scans.
Band filteringQueries filter by band whenever the user provides one — this hits wspr.live's indexes efficiently.
Column selectionWe SELECT only the columns each tool needs (8-10 per query), never SELECT *.
Result limitsAll queries cap results (200 spots, 50 leaderboard entries).
Response caching2-10 minute TTL per tool. Identical queries within the window hit local cache with zero network traffic.
Request timeout20-second timeout — we don't hold connections open on a shared service.
User-Agent headerEvery request identifies itself as wspr-mcp/{version} so the operators can reach us if needed.

If wspr.live is down or overloaded, the circuit breaker backs off automatically. We don't retry in a tight loop.

Quick Start

No credentials needed — just install and configure your MCP client.

Configure your MCP client

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

json
{
  "mcpServers": {
    "wspr": {
      "command": "uvx",
      "args": ["wspr-mcp"]
    }
  }
}

Claude Code

Add to .claude/settings.json:

json
{
  "mcpServers": {
    "wspr": {
      "command": "uvx",
      "args": ["wspr-mcp"]
    }
  }
}

ChatGPT Desktop

json
{
  "mcpServers": {
    "wspr": {
      "command": "uvx",
      "args": ["wspr-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

json
{
  "mcpServers": {
    "wspr": {
      "command": "uvx",
      "args": ["wspr-mcp"]
    }
  }
}

VS Code / GitHub Copilot

Add to .vscode/mcp.json in your workspace:

json
{
  "servers": {
    "wspr": {
      "command": "uvx",
      "args": ["wspr-mcp"]
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

json
{
  "mcpServers": {
    "wspr": {
      "command": "uvx",
      "args": ["wspr-mcp"]
    }
  }
}

Ask questions

"Show me recent WSPR spots on 20m"

"What bands are open right now?"

"Who are the top WSPR beacons on 20m today?"

"What are the longest WSPR paths in the last 24 hours?"

"Is there propagation between Idaho (DN13) and central Europe (JN48)?"

"Any WSPR paths between DN13 and Bouvet (JD15)?" (auto-widens to DN↔JD if no exact match)

"What's happening in grid square JN48?"

"How's the SNR trending between K9AN and G8JNJ on 20m?"

"Who are the best WSPR receivers sorted by distance?"

Testing Without Network

bash
WSPR_MCP_MOCK=1 wspr-mcp

MCP Inspector

bash
wspr-mcp --transport streamable-http --port 8009

Development

bash
git clone https://github.com/qso-graph/wspr-mcp.git
cd wspr-mcp
uv sync --group dev
uv run pytest

License

GPL-3.0-or-later

Similar modules

Browse Statistics