Sota Mcp
About
MCP server for Summits on the Air — summit lookup, spots, alerts, nearby summits
Details
- Author
- qso-graph
- Downloads
- 368
- Categories
- Other
Jump to
- Live and recent SOTA spots with time window and filters
- Upcoming scheduled activation alerts
- Summit details by SOTA reference code
- Geospatial search for summits near coordinates
- Version information for fleet identity attestation
- No authentication required, uses public API only
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Sota McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the package with pip install sota-mcp, then configure your MCP client (e.g., Claude Desktop, Claude Code, ChatGPT Desktop, Cursor, VS Code / GitHub Copilot, Gemini CLI) by adding a JSON entry with "command": "sota-mcp". After restarting the client, the tools appear automatically. For testing without network, run SOTA_MCP_MOCK=1 sota-mcp.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"sota mcp": {
"sota": {
"command": "sota-mcp"
}
}
}
}McpServers
{
"sota": {
"command": "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
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):
{
"mcpServers": {
"sota": {
"command": "sota-mcp"
}
}
}
Claude Code
Add to .claude/settings.json:
{
"mcpServers": {
"sota": {
"command": "sota-mcp"
}
}
}
ChatGPT Desktop
{
"mcpServers": {
"sota": {
"command": "sota-mcp"
}
}
}
Cursor
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"sota": {
"command": "sota-mcp"
}
}
}
VS Code / GitHub Copilot
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"sota": {
"command": "sota-mcp"
}
}
}
Gemini CLI
Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):
{
"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:
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
pip install -e .
License
GPL-3.0-or-later
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
