Sota Mcp

by qso-graph

368 downloads Not rated yet

About

MCP server for Summits on the Air — summit lookup, spots, alerts, nearby summits

Explore

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

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Sota Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

pip install sota-mcp

sota-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.

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)

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

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"
    }
}

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.