Connects to the public SOTA API to surface amateur radio summit activation data without requiring authentication. Exposes five tools: current spots with time and mode filters, upcoming activation alerts, summit lookup by reference code, geospatial search for summits near coordinates, and version info. Useful if you're working with Summits on the Air data and want to query live activations, check who's on which peak, or find summits within range of a location. Part of the QSO-Graph project. Includes a mock mode for testing without network calls and works with any MCP client through stdio transport.
MCP server for Summits on the Air (SOTA) — live spots, activation alerts, summit info, and nearby summits through any MCP-compatible AI assistant.
Part of the QSO-Graph project. No authentication required — uses the public SOTA API exclusively.
pip install sota-mcp
| Tool | Description |
|---|---|
sota_spots | Current and recent spots with time window and association/mode filters |
sota_alerts | Upcoming scheduled activation alerts |
sota_summit_info | Summit details by SOTA reference code |
sota_summits_near | Find summits near coordinates (geospatial search) |
get_version_info | Service version + upstream spec version (fleet identity attestation) |
No credentials needed — just install and configure your MCP client.
sota-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.
Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):
{
"mcpServers": {
"sota": {
"command": "sota-mcp"
}
}
}
Add to .claude/settings.json:
{
"mcpServers": {
"sota": {
"command": "sota-mcp"
}
}
}
{
"mcpServers": {
"sota": {
"command": "sota-mcp"
}
}
}
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"sota": {
"command": "sota-mcp"
}
}
}
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"sota": {
"command": "sota-mcp"
}
}
}
Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):
{
"mcpServers": {
"sota": {
"command": "sota-mcp"
}
}
}
"What SOTA spots are active right now?"
"Tell me about summit W7I/SI-001"
"What summits are near Boise, Idaho?"
"Any SOTA alerts for this weekend?"
For testing all tools without hitting the SOTA APIs:
SOTA_MCP_MOCK=1 sota-mcp
sota-mcp --transport streamable-http --port 8007
Then open the MCP Inspector at http://localhost:8007.
git clone https://github.com/qso-graph/sota-mcp.git
cd sota-mcp
pip install -e .
GPL-3.0-or-later