Sota Mcp

io.github.qso-graphPublished by GitHub account qso-graphv0.4.1Updated Nov 3, 2026

Summits on the Air MCP server. Summit lookup, spots, alerts, nearby summits.

The publisher's own server: Sota

VerifiedSTDIODesktop onlyLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

Read-only MCP server for Summits on the Air (SOTA) that lets an assistant look up live spots, activation alerts, summit details and nearby summits.

What you can do
  • Retrieve current and recent SOTA spots, with time-window and association/mode filters
  • List upcoming scheduled activation alerts
  • Look up summit details by SOTA reference code
  • Find summits near a geographic location
  • Check the service version and upstream API spec version to compare deployments
When to use it
Useful for amateur-radio operators and SOTA chasers or activators who want an assistant to answer questions about what is being spotted right now, what activations are scheduled, or which summits are near a place.
Requirements
Runs locally as a Python package (sota-mcp) launched with uvx, so a Python/uv toolchain is needed. No credentials or API keys; it uses the public SOTA API, so network access is required. A mock mode exists for offline testing.
Before you install
All tools are read-only lookups against public SOTA data; no accounts, secrets or write actions are involved. Queries, including coordinates for nearby-summit searches, are sent to the public SOTA API.

Installation

In SourceWeft

  1. Open Sota Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

sota-mcp

[PyPI] [MCP Registry]

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
uvx sota-mcp            # run it; nothing to install

Tools

ToolDescription
sota_spotsCurrent and recent spots with time window and association/mode filters
sota_alertsUpcoming scheduled activation alerts
sota_summit_infoSummit details by SOTA reference code
sota_summits_nearFind summits near coordinates (geospatial search)
get_version_infoService 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": "uvx",      "args": ["sota-mcp"]    }  }}
Claude Code

Add to .claude/settings.json:

json
{  "mcpServers": {    "sota": {      "command": "uvx",      "args": ["sota-mcp"]    }  }}
ChatGPT Desktop
json
{  "mcpServers": {    "sota": {      "command": "uvx",      "args": ["sota-mcp"]    }  }}
Cursor

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

json
{  "mcpServers": {    "sota": {      "command": "uvx",      "args": ["sota-mcp"]    }  }}
VS Code / GitHub Copilot

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

json
{  "servers": {    "sota": {      "command": "uvx",      "args": ["sota-mcp"]    }  }}
Gemini CLI

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

json
{  "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:

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.gitcd sota-mcpuv sync --group devuv run pytest

License

GPL-3.0-or-later

Source: README.md at commit 2153c87

Tools

5

get_version_info

Get Version Info

Get sota-mcp service version and upstream spec version. Returns the running PyPI version of sota-mcp and the SOTA api2 endpoint contract in use. Use this to confirm fleet alignment across MCP deployments — agents can compare service_version and spec_version across servers to detect drift without going outside the MCP protocol.

Takes no parameters.

sota_spots

Sota Spots

Get current and recent SOTA spots. Returns live spot feed with summit details.

Parametersmodehoursassociation

sota_alerts

Sota Alerts

Get upcoming SOTA activation alerts.

Parametershoursassociation

sota_summit_info

Sota Summit Info

Get detailed summit information by SOTA reference code.

Parameterssummit_coderequired

sota_summits_near

Sota Summits Near

Find SOTA summits near a geographic location.

Parameterslimitlatituderequiredlongituderequiredradius_km

Version history

9
  1. v0.4.1LatestOct 29, 2026
  2. v0.2.3Oct 26, 2026
  3. v0.2.1Oct 26, 2026
  4. v0.2.0Oct 12, 2026
  5. v0.1.10Oct 11, 2026
  6. v0.1.9Oct 7, 2026
  7. v0.1.8Oct 6, 2026
  8. v0.1.7Sep 29, 2026
  9. v0.1.1Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Sota integrations

Sota

io.sotaOfficial publisher

Sota's MCP server lets an assistant create and manage sota.io PaaS projects: deploy apps, read logs, set variables, roll back and manage domains.

Streamable HTTPWeb executable
Cloud & Infrastructure14 toolsOct 25, 2026

sota-anchor

Published by GitHub account luckmanqasim

Checks recent papers, repositories and packages so a coding agent verifies whether something already exists before building it from scratch.

STDIODesktop only
Web Search & ScrapingNot validated yetNov 4, 2026

Sota

Published by GitHub account sota-deploy

Sota lets an AI assistant deploy and manage web apps on sota.io: deploy code, read logs, set environment variables, roll back, and handle projects and customdom

STDIODesktop only
Cloud & InfrastructureNot validated yetOct 24, 2026

CSS SOTA

Published by GitHub account LuSrodri

Lets an assistant check CSS feature Baseline status and browser support, and audit stylesheets against a support target.

Streamable HTTPWeb executable
Web Search & Scraping6 toolsOct 24, 2026