The sota-mcp server provides a Model Context Protocol (MCP) interface for Summits on the Air (SOTA). It exposes live spots, activation alerts, summit details, and nearby summit data through any MCP-compatible AI assistant, without authentication, by leveraging the public SOTA API as part of the QSO-Graph project.

🛠️ Key Features

Live spots and recent activity filtering
Activation alerts and summit information
Nearby summit discovery via MCP
Public API integration with no authentication

🚀 Use Cases

Retrieve current SOTA spots by time window, mode, or association
Track activations and chaser activity for specific summits
Query summit metadata and nearby peaks for planning

⚡ Developer Benefits

Python-based MCP server, simple installation with pip
Clear tools such as sota_spots and sota_alerts for integration
Open integration path within QSO-Graph ecosystem

⚠️ Limitations

No authentication required; relies on public SOTA API
Data freshness depends on public API availability
Limited to SOTA scope and MCP-compatible assistants

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

bash

pip install sota-mcp

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):

json

{
  "mcpServers": {
    "sota": {
      "command": "sota-mcp"
    }
  }
}

Claude Code

Add to .claude/settings.json:

json

{
  "mcpServers": {
    "sota": {
      "command": "sota-mcp"
    }
  }
}

ChatGPT Desktop

json

{
  "mcpServers": {
    "sota": {
      "command": "sota-mcp"
    }
  }
}

Cursor

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

json

{
  "mcpServers": {
    "sota": {
      "command": "sota-mcp"
    }
  }
}

VS Code / GitHub Copilot

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

json

{
  "servers": {
    "sota": {
      "command": "sota-mcp"
    }
  }
}

Gemini CLI

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

json

{
  "mcpServers": {
    "sota": {
      "command": "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:

bash

SOTA_MCP_MOCK=1 sota-mcp

MCP Inspector

bash

sota-mcp --transport streamable-http --port 8007

Then open the MCP Inspector at http://localhost:8007.

Development

bash

git clone https://github.com/qso-graph/sota-mcp.git
cd sota-mcp
pip install -e .

License

GPL-3.0-or-later

io.github.qso-graph/sota-mcp

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

sota-mcp

Install

Tools

Quick Start

Configure your MCP client

Claude Desktop

Claude Code

ChatGPT Desktop

Cursor

VS Code / GitHub Copilot

Gemini CLI

Ask questions

Testing Without Network

MCP Inspector

Development

License

Install

Related servers