Iota MCP Server

@qso-graph

Repository Homepage

Basic information

About Iota MCP Server

MCP server for Islands on the Air — lookup, search, nearby, DXCC. Stats

#amateur-radio#iota#islands#dx

Iota MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "iota": {
      "command": "iota-mcp"
    }
  }
}

Iota MCP Server tools

Look up an IOTA group by reference number (e.g., NA-005)

Search groups and islands by name (e.g., Hawaii, Shetland)

List all islands and subgroups in an IOTA group

Bidirectional DXCC-to-IOTA mapping

Programme summary — totals by continent, most/least credited

Find IOTA groups nearest to a lat/lon location

Service version + upstream programme data version (fleet identity attestation)

Overview

What is Iota Mcp?

Iota Mcp is an MCP server for Islands on the Air (IOTA), providing group lookup, island search, DXCC mapping, nearby groups, and programme statistics through any MCP-compatible AI assistant. It is part of the qso-graph project and does not require authentication — all IOTA data is public.

How to use Iota Mcp?

Install with pip install iota-mcp, then configure your MCP client (e.g., Claude Desktop, Claude Code, ChatGPT Desktop, Cursor, VS Code, Gemini CLI) by adding the server config JSON — tools appear automatically. No credentials are needed.

Key features of Iota Mcp

Look up IOTA groups by reference number (e.g., NA‑005)
Search groups and islands by name (e.g., Hawaii)
List all islands and subgroups in an IOTA group
Bidirectional DXCC-to-IOTA mapping
Find IOTA groups nearest to a lat/lon location
Programme statistics: totals by continent, most/least credited
Data cached for 24 hours; IOTA data refreshes daily at 00:00 UTC

Use cases of Iota Mcp

Look up an IOTA group reference (e.g., NA‑005) for contest planning
Search for islands by name such as Shetland
Find IOTA groups near a specific geographic location
Map DXCC entities to IOTA references and vice versa
Retrieve IOTA programme summary statistics

Frequently asked questions

What data source does Iota Mcp use?

Data comes from the official IOTA website JSON downloads: `fulllist.json` (~1.3 MB) for the group/subgroup/island hierarchy and `dxcc_matches_one_iota.json` (~3.5 KB) for DXCC mapping. Data is cached for 24 hours.

Does Iota Mcp require authentication or API keys?

No. All IOTA data is public, and no authentication is required to use this server.

Can I run Iota Mcp with mock data for testing?

Yes. Set the environment variable `IOTA_MCP_MOCK=1` before running to use mock data without network calls.

How can I inspect or debug Iota Mcp?

You can run it with the MCP Inspector using `iota-mcp --transport streamable-http --port 8010`.

What is the license of Iota Mcp?

Iota Mcp is licensed under GPL‑3.0‑or‑later.

Comments

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code