Sota
Summits on the Air MCP server. Summit lookup, spots, alerts, nearby summits.
Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
At most: only reads or looks up information.
What it costs
FreeOdel 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).
Run
uvx sota-mcp
MCP client config
{
"mcpServers": {
"sota": {
"command": "uvx",
"args": [
"sota-mcp"
]
}
}
}sota-mcp
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.
Install
uvx sota-mcp # run it; nothing to install
Tools
| 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) |
Quick Start
No credentials needed — just install and configure your MCP client.
Configure your MCP client
sota-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.
Claude Desktop
Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):
{
"mcpServers": {
"sota": {
"command": "uvx",
"args": ["sota-mcp"]
}
}
}
Claude Code
Add to .claude/settings.json:
{
"mcpServers": {
"sota": {
"command": "uvx",
"args": ["sota-mcp"]
}
}
}
ChatGPT Desktop
{
"mcpServers": {
"sota": {
"command": "uvx",
"args": ["sota-mcp"]
}
}
}
Cursor
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"sota": {
"command": "uvx",
"args": ["sota-mcp"]
}
}
}
VS Code / GitHub Copilot
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"sota": {
"command": "uvx",
"args": ["sota-mcp"]
}
}
}
Gemini CLI
Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):
{
"mcpServers": {
"sota": {
"command": "uvx",
"args": ["sota-mcp"]
}
}
}
Ask questions
"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?"
Testing Without Network
For testing all tools without hitting the SOTA APIs:
SOTA_MCP_MOCK=1 sota-mcp
MCP Inspector
sota-mcp --transport streamable-http --port 8007
Then open the MCP Inspector at http://localhost:8007.
Development
git clone https://github.com/qso-graph/sota-mcp.git
cd sota-mcp
uv sync --group dev
uv run pytest
License
GPL-3.0-or-later
