Iota Mcp

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

FAQ from Iota Mcp

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.