Implement sota-mcp v0.1.0 — 5 tools for Summits on the Air

5 MCP tools: sota_spots (with hours/association/mode filters),
sota_alerts, sota_summit_info, sota_summits_near (geospatial),
sota_activator_stats. All public endpoints via SOTLAS and SOTALive,
no auth required. Rate limited (200ms min delay), in-memory TTL
cache, mock mode via SOTA_MCP_MOCK=1.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: KI7MT

README.md

@@ -1,31 +1,151 @@
 # sota-mcp
 
-MCP server for Summits on the Air (SOTA) -- summit lookup, activator stats, and live spots via the SOTLAS API.
+MCP server for [Summits on the Air (SOTA)](https://www.sota.org.uk/) — live spots, activation alerts, summit info, nearby summits, and activator stats through any MCP-compatible AI assistant.
 
-Part of the [qso-graph](https://qso-graph.io/) collection of amateur radio MCP servers.
+Part of the [qso-graph](https://qso-graph.io/) project. **No authentication required** — uses public [SOTLAS](https://sotl.as/) and [SOTALive](https://www.sotalive.tk/) APIs.
 
-## Planned Tools
+## Install
+
+```bash
+pip install sota-mcp
+```
+
+## Tools
 
 | Tool | Description |
 |------|-------------|
-| `sota_summit_lookup` | Look up a SOTA summit by reference |
-| `sota_activator_stats` | Activator statistics and summit list |
-| `sota_spots` | Current SOTA spots (live activations) |
-| `sota_summit_search` | Search summits by name or association |
-| `sota_leaderboard` | Top activators/chasers rankings |
+| `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) |
+| `sota_activator_stats` | Activator profile, stats, and recent activation history |
 
-## Install
+## 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"
 
-Coming soon. This package is not yet published to PyPI.
+> "What summits are near Boise, Idaho?"
+
+> "Show me KI7MT's SOTA activator stats"
+
+> "Any SOTA alerts for this weekend?"
+
+## Testing Without Network
+
+For testing all tools without hitting the SOTA APIs:
 
 ```bash
-pip install sota-mcp
+SOTA_MCP_MOCK=1 sota-mcp
+```
+
+## MCP Inspector
+
+```bash
+sota-mcp --transport streamable-http --port 8007
 ```
 
-## Data Source
+Then open the MCP Inspector at `http://localhost:8007`.
 
-All data comes from the public [SOTLAS API](https://sotl.as/) and [SOTA API](https://api2.sota.org.uk/). No API key required.
+## Development
+
+```bash
+git clone https://github.com/qso-graph/sota-mcp.git
+cd sota-mcp
+pip install -e .
+```
 
 ## License
 
-GPL-3.0-or-later. See [LICENSE](LICENSE).
+GPL-3.0-or-later

pyproject.toml

@@ -14,7 +14,7 @@ keywords = [
     "mcp", "model-context-protocol", "activator", "chaser",
 ]
 classifiers = [
-    "Development Status :: 1 - Planning",
+    "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "Topic :: Communications :: Ham Radio",
     "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",