Skip to content

sota-mcp

Summits on the Air integration — spots, alerts, summit info, and nearby search.

pip install sota-mcp

GitHub · PyPI


Tools

All 4 tools are public — no credentials needed.

Tool Description
sota_spots Current and recent SOTA spots
sota_alerts Upcoming activation alerts
sota_summit_info Detailed summit information
sota_summits_near Find summits near a location (geospatial)

Tool Reference

sota_spots

Get current and recent SOTA spots.

Parameter Type Required Description
hours int No Time window in hours. Default: 24
association str No Filter by SOTA association (e.g., "W7I", "G", "VK")
mode str No Filter by mode (e.g., "CW", "SSB", "FT8")

Returns list of spots with activator, summit, frequency, mode, and comments.

sota_alerts

Get upcoming SOTA activation alerts.

Parameter Type Required Description
hours int No Look-ahead window in hours. Default: 16
association str No Filter by SOTA association (e.g., "W7I")

Returns list of alerts with activator, summit, planned date/time, frequencies, and comments.

sota_summit_info

Get detailed summit information by SOTA reference code.

Parameter Type Required Description
summit_code str Yes SOTA reference (e.g., W7I/SI-001, G/LD-001)

Returns summit name, altitude, coordinates, grid, points, validity dates, and activation history.

sota_summits_near

Find SOTA summits near a geographic location. Unique geospatial search capability.

Parameter Type Required Description
latitude float Yes Center latitude (decimal degrees)
longitude float Yes Center longitude (decimal degrees)
radius_km float No Search radius in km. Default: 50.0
limit int No Maximum results. Default: 20

Returns list of nearby summits sorted by distance with code, name, altitude, points, and activation count.


Data Source

sota-mcp uses the official SOTA API exclusively:

  • SOTA API (api2.sota.org.uk) — spots, alerts, summit data, and region listings

No Credential Setup Needed

SOTA's APIs are completely public. Just install and start using it.


Mock Mode

SOTA_MCP_MOCK=1 sota-mcp

MCP Inspector

sota-mcp --transport streamable-http --port 8007