io.github.qso-graph/sota-mcp

Get current and recent SOTA spots. Returns live spot feed with summit details. Args: hours: Time window in hours (default 24). association: Filter by SOTA association (e.g., W7I, G, VK). Empty for all. mode: Filter by mode (e.g., CW, SSB, FT8). Empty for all. Returns: List of spots with activator, summit, frequency, mode, and comments.

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. Returns: service_name, service_version (PyPI), and spec_version (SOTA api2).

Get upcoming SOTA activation alerts. Args: hours: Look-ahead window in hours (default 16). association: Filter by SOTA association (e.g., W7I). Empty for all. Returns: List of alerts with activator, summit, planned date/time, frequencies, and comments.

Get detailed summit information by SOTA reference code. Args: summit_code: SOTA reference (e.g., W7I/SI-001, G/LD-001). Returns: Summit details including name, altitude, coordinates, grid, points, validity dates, and activation history.

Find SOTA summits near a geographic location. Args: latitude: Center latitude (decimal degrees). longitude: Center longitude (decimal degrees). radius_km: Search radius in km (default 50). limit: Maximum number of results (default 20). Returns: List of nearby summits sorted by distance with code, name, altitude, points, and activation count.