io.github.qso-graph/iota-mcp

Get iota-mcp service version and upstream programme data version. Returns the running PyPI version of iota-mcp and the IOTA programme data revision 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 (IOTA programme data).

Look up an IOTA group by reference number. Returns group details including name, DXCC entity, bounding box, center coordinates, credit percentage, and island count. Args: refno: IOTA reference number (e.g., NA-005, EU-005, AF-001). Returns: Group details with coordinates, DXCC mapping, and island count.

Search IOTA groups and islands by name. Searches both group names and individual island names. Results are deduplicated by IOTA reference number. Args: query: Search text (e.g., Hawaii, Shetland, Comoro). limit: Maximum results to return (default 25). Returns: List of matching IOTA groups with details.

List all islands and subgroups in an IOTA group. Returns the full hierarchy: subgroups containing individual islands. Args: refno: IOTA reference number (e.g., NA-005, EU-005). Returns: Subgroup hierarchy with island names and IDs.

Bidirectional DXCC-to-IOTA mapping. Provide either dxcc_num to find all IOTA groups for a DXCC entity, or refno to find which DXCC entities an IOTA group belongs to. Args: dxcc_num: DXCC entity number (e.g., 291 for USA, 223 for England). refno: IOTA reference number (e.g., EU-005). Returns: Mapping between DXCC entities and IOTA groups.

Get IOTA programme summary statistics. Returns total groups and islands, breakdown by continent, DXCC entity count, and most/least credited groups. Returns: Programme-wide statistics and summaries.

Find IOTA groups nearest to a location. Computes great-circle distance from the given coordinates to the center of each IOTA group's bounding box. Args: latitude: Latitude in decimal degrees (e.g., 43.6 for Boise). longitude: Longitude in decimal degrees (e.g., -116.2 for Boise). limit: Maximum results to return (default 20). Returns: List of nearest IOTA groups sorted by distance in km.