io.github.qso-graphPublished by GitHub account qso-graphv0.6.1Updated Nov 3, 2026
WSPR beacon analytics MCP server. Band openings, path analysis, solar correlation.
Read-only MCP server for WSPR beacon data from wspr.live, letting an assistant query live spots, band openings, propagation paths and SNR trends.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
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.
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.
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:
If wspr.live is down or overloaded, the circuit breaker backs off automatically. We don't retry in a tight loop.
No credentials needed — just install and configure your MCP client.
Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):
Add to .claude/settings.json:
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
Add to .vscode/mcp.json in your workspace:
Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):
"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?"
GPL-3.0-or-later
Source: README.md at commit 7a34887
Get Version Info
Get wspr-mcp service version and upstream spec version. Returns the running PyPI version of wspr-mcp and the wspr.live ClickHouse schema revision in use. Use this to confirm fleet alignment across MCP deployments — agents can compare service_version and spec_version across servers to detect drift without going outside the MCP protocol.
Takes no parameters.
Wspr Spots
Get recent WSPR spots. WSPR beacons transmit every 2 minutes on precise frequencies. Each spot is a 2-minute integration proving a propagation path exists.
bandgridhourslimitmax_snrmin_snrcallsignmin_distanceWspr Band Activity
Get per-band WSPR activity summary. Shows spot counts, TX/RX station counts, average and max distance, and average SNR for each band. The best indicator of which bands are open right now.
hoursWspr Top Beacons
Get top WSPR transmitters ranked by spot count or max distance. Shows the most active or most far-reaching WSPR beacon operators. Useful for finding who's putting out a big signal on a band.
bandhourslimitsort_byWspr Top Spotters
Get top WSPR receivers ranked by spot count or max distance. Shows the most prolific or most sensitive WSPR receiving stations. Useful for finding good receivers to monitor for propagation.
bandhourslimitsort_byWspr Propagation
Get WSPR-derived propagation between two locations. Shows which bands have been open between two endpoints, with spot counts, SNR statistics, and hours of opening. Accepts callsigns or grid squares (or a mix). Searches both directions automatically.
rxrequiredtxrequiredbandhoursWspr Grid Activity
Get all WSPR activity in or out of a Maidenhead grid square. Shows summary stats and recent spots for a geographic area. Use 2-character grid (e.g., DN) for a wide area or 4-character (e.g., DN13) for a specific region.
bandgridrequiredhourslimitWspr Longest Paths
Get the longest WSPR paths in the given time window. WSPR's precise timing and low power make it the gold standard for detecting marginal propagation. Long paths here prove the band is open.
bandhourslimitmin_distanceWspr Snr Trend
Get SNR trend over time for a specific WSPR path. Shows hourly SNR buckets for a path between two endpoints. Useful for seeing when a band opens and closes on a specific path, and how signal strength varies over time.
rxrequiredtxrequiredbandhours90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
uvx wspr-mcp # run it; nothing to install{ "mcpServers": { "wspr": { "command": "uvx", "args": ["wspr-mcp"] } }}{ "mcpServers": { "wspr": { "command": "uvx", "args": ["wspr-mcp"] } }}{ "mcpServers": { "wspr": { "command": "uvx", "args": ["wspr-mcp"] } }}{ "mcpServers": { "wspr": { "command": "uvx", "args": ["wspr-mcp"] } }}{ "servers": { "wspr": { "command": "uvx", "args": ["wspr-mcp"] } }}{ "mcpServers": { "wspr": { "command": "uvx", "args": ["wspr-mcp"] } }}WSPR_MCP_MOCK=1 wspr-mcpwspr-mcp --transport streamable-http --port 8009git clone https://github.com/qso-graph/wspr-mcp.gitcd wspr-mcpuv sync --group devuv run pytest