io.github.qso-graph/sota-mcp
Summits on the Air MCP server. Summit lookup, spots, alerts, nearby summits.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
sota-mcpclaude mcp add sota-mcp -- uvx sota-mcp==0.4.1
{
"mcpServers": {
"sota-mcp": {
"command": "uvx",
"args": [
"sota-mcp==0.4.1"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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
Questions fréquentes
Qu'est-ce que io.github.qso-graph/sota-mcp ?
Summits on the Air MCP server. Summit lookup, spots, alerts, nearby summits.
Comment installer io.github.qso-graph/sota-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add sota-mcp -- uvx sota-mcp==0.4.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.qso-graph/sota-mcp ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.qso-graph/sota-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence GPL-3.0.
Qui maintient io.github.qso-graph/sota-mcp ?
Il est publié par qso-graph. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.