Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"wspr": {
"command": "wspr-mcp"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
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.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'wspr-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked wspr-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in analytics
MCP server that enables AI agents to perform comprehensive web audits using Google Lighthouse with 13+ tools for performance, accessibility, SEO, and security analysis.
MCP server for Dynatrace Managed to access logs, events, and metrics.
An MCP server that provides [describe what your server does]
MCP server for Yandex.Direct API — campaigns, ads, statistics, keywords. Bearer token auth.
MCP Security Weekly
Get CVE alerts and security updates for io.github.qso-graph/wspr-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
pip install wspr-mcp
| Tool | Description | Key Parameters |
|---|---|---|
wspr_spots | Recent WSPR spots with flexible filtering | callsign, band, hours, grid, min/max SNR, min distance |
wspr_band_activity | Per-band spot counts, station counts, distances, and SNR | hours |
wspr_top_beacons | Top transmitters ranked by spot count or max distance | band, hours, sort_by (spots/distance), limit |
wspr_top_spotters | Top receivers ranked by spot count or max distance | band, hours, sort_by (spots/distance), limit |
wspr_propagation | Propagation between two locations — auto-widens to field-level proxy for sparse endpoints | tx, rx, band, hours |
wspr_grid_activity | All WSPR activity in/out of a Maidenhead grid square | grid (2 or 4 char), band, hours |
wspr_longest_paths | Longest distance WSPR paths in a time window | band, hours, min_distance, limit |
wspr_snr_trend | Hourly SNR trend for a specific path over time | tx, rx, band, hours |
get_version_info | Service version + upstream spec version (fleet identity attestation) | — |
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:
| Measure | Detail |
|---|---|
| Rate limiting | 3 seconds between requests (20 req/min max) |
| Circuit breaker | Opens after 3 consecutive failures; exponential backoff up to 5 minutes. Prevents hammering a struggling service. |
| Time-bounded queries | Every query filters by time (max 72 hours). No unbounded full-table scans. |
| Band filtering | Queries filter by band whenever the user provides one — this hits wspr.live's indexes efficiently. |
| Column selection | We SELECT only the columns each tool needs (8-10 per query), never SELECT *. |
| Result limits | All queries cap results (200 spots, 50 leaderboard entries). |
| Response caching | 2-10 minute TTL per tool. Identical queries within the window hit local cache with zero network traffic. |
| Request timeout | 20-second timeout — we don't hold connections open on a shared service. |
| User-Agent header | Every 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.
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):
{
"mcpServers": {
"wspr": {
"command": "wspr-mcp"
}
}
}
Add to .claude/settings.json:
{
"mcpServers": {
"wspr": {
"command": "wspr-mcp"
}
}
}
{
"mcpServers": {
"wspr": {
"command": "wspr-mcp"
}
}
}
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"wspr
... [View full README on GitHub](https://github.com/qso-graph/wspr-mcp#readme)