iota-mcp
[PyPI]
[MCP Registry]
MCP server for Islands on the Air (IOTA) — group lookup, island search, DXCC mapping, nearby groups, and programme statistics through any MCP-compatible AI assistant.
Part of the qso-graph project. No authentication required — all IOTA data is public.
Install
Tools
Quick Start
No credentials needed — just install and configure your MCP client.
Configure your MCP client
iota-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.
Claude Desktop
Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):
Claude Code
Add to .claude/settings.json:
ChatGPT Desktop
Cursor
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
VS Code / GitHub Copilot
Add to .vscode/mcp.json in your workspace:
Gemini CLI
Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):
Ask questions
"Look up IOTA group NA-005"
"Search for islands named Shetland"
"What IOTA groups are near Boise, Idaho?"
"Show me all islands in EU-005"
"What IOTA references map to DXCC 291?"
"Give me IOTA programme statistics"
Data Source
Data comes from the official IOTA website JSON downloads:
- fulllist.json — complete group/subgroup/island hierarchy (~1.3 MB)
- dxcc_matches_one_iota.json — 1:1 DXCC-to-IOTA mapping (~3.5 KB)
Data is downloaded once and cached for 24 hours (IOTA refreshes daily at 00:00 UTC).
Testing Without Network
MCP Inspector
Then open the MCP Inspector at http://localhost:8010.
Development
License
GPL-3.0-or-later