io.github.qso-graph/pota-mcp

Get pota-mcp service version and upstream spec version. Returns the running PyPI version of pota-mcp and the POTA API revision currently 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 (POTA API).

Get current POTA activator spots. Returns live spot feed with park details, grid squares, and coordinates. All filters are optional — omit to get all active spots. Args: band: Filter by band (e.g., 20m, 40m). Empty for all bands. mode: Filter by mode (e.g., CW, FT8, SSB). Empty for all modes. location: Filter by location code (e.g., US-ID, CA-ON). Empty for all. program: Filter by program prefix (e.g., US, VE, G). Empty for all. Returns: List of active spots with activator, frequency, park, grid, and coordinates.

Get detailed park information by POTA reference code. Args: reference: Park reference code (e.g., US-0001, CA-5580, G-0001). Returns: Park details including name, coordinates, grid, type, location, access methods, agencies, website, and first activation info.

Get activation and QSO counts for a POTA park. Args: reference: Park reference code (e.g., US-0001). Returns: Activation attempts, successful activations, and total contacts.

Get POTA activator and hunter statistics for a callsign. Args: callsign: Callsign to look up (e.g., K4SWL, KI7MT). Returns: Activator stats (activations, parks, QSOs), hunter stats (parks worked, QSOs), awards, and endorsements.

Get upcoming scheduled POTA activations. Returns: List of scheduled activations with activator, park, date, time window, planned frequencies, and comments.

List all POTA parks in a state, province, or country. Args: location: Location code (e.g., US-ID for Idaho, CA-ON for Ontario, G for England). Returns: List of parks with reference, name, coordinates, grid, type, and activation/contact counts.

Find POTA parks near a geographic point. Fetches all parks in the given location and filters by distance. Useful for finding 2-fer candidates near an activation site. Args: location: Location code (e.g., US-ID, CA-ON). Required to scope the search. latitude: Center point latitude (e.g., 43.617). longitude: Center point longitude (e.g., -115.993). radius_km: Search radius in km (default 50, max 500). limit: Maximum parks to return (default 25, max 100). Returns: Parks within radius, sorted by distance, with distance_km field added.