iota-mcp
This server provides read-only access to the Islands on the Air (IOTA) amateur radio programme database—no authentication needed.
Look up a group by reference (
iota_lookup) — details like name, DXCC entity, bounding box, center coordinates, credit percentage, and island count for refs such as NA-005.Search by name (
iota_search) — find groups and individual islands by text (e.g., Hawaii, Shetland), with a configurable result limit.List islands in a group (
iota_islands) — full hierarchy of subgroups and their individual islands for a reference.Map DXCC ↔ IOTA (
iota_dxcc) — bidirectionally translate a DXCC entity number to IOTA groups, or an IOTA ref to its DXCC entities.Get programme statistics (
iota_stats) — totals for groups and islands, breakdown by continent, DXCC entity count, and most/least credited groups.Find nearby groups (
iota_nearby) — great-circle distance from a lat/lon to each group's bounding-box center, ranked nearest first.Check version/identity (
get_version_info) — service version plus upstream IOTA data revision for fleet drift detection.
Provides tools for looking up IOTA groups, searching islands, mapping DXCC, and retrieving programme statistics, usable through GitHub Copilot in VS Code.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@iota-mcp Show me all islands in EU-005"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
iota-mcp
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
uvx iota-mcp # run it; nothing to installRelated MCP server: qrz-mcp
Tools
Tool | Description |
| Look up an IOTA group by reference number (for example, NA-005) |
| Search groups and islands by name (for example, 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) |
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):
{
"mcpServers": {
"iota": {
"command": "uvx",
"args": ["iota-mcp"]
}
}
}Claude Code
Add to .claude/settings.json:
{
"mcpServers": {
"iota": {
"command": "uvx",
"args": ["iota-mcp"]
}
}
}ChatGPT Desktop
{
"mcpServers": {
"iota": {
"command": "uvx",
"args": ["iota-mcp"]
}
}
}Cursor
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"iota": {
"command": "uvx",
"args": ["iota-mcp"]
}
}
}VS Code / GitHub Copilot
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"iota": {
"command": "uvx",
"args": ["iota-mcp"]
}
}
}Gemini CLI
Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):
{
"mcpServers": {
"iota": {
"command": "uvx",
"args": ["iota-mcp"]
}
}
}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
IOTA_MCP_MOCK=1 iota-mcpMCP Inspector
iota-mcp --transport streamable-http --port 8010Then open the MCP Inspector at http://localhost:8010.
Development
git clone https://github.com/qso-graph/iota-mcp.git
cd iota-mcp
uv sync --group dev
uv run pytestLicense
GPL-3.0-or-later
Available Tools
7 toolsget_version_infoGet Version InfoARead-onlyIdempotent
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.
Inputs: no named parameters. Returns: object
iota_dxccIota DxccARead-onlyIdempotent
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.
Inputs: refno, dxcc_num. Returns: object
iota_islandsIota IslandsARead-onlyIdempotent
List all islands and subgroups in an IOTA group.
Returns the full hierarchy: subgroups containing individual islands.
Inputs: refno (required). Returns: object
iota_lookupIota LookupARead-onlyIdempotent
Look up an IOTA group by reference number.
Returns group details including name, DXCC entity, bounding box, center coordinates, credit percentage, and island count.
Inputs: refno (required). Returns: object
iota_nearbyIota NearbyARead-onlyIdempotent
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.
Inputs: latitude (required), longitude (required), limit. Returns: object
iota_searchIota SearchARead-onlyIdempotent
Search IOTA groups and islands by name.
Searches both group names and individual island names. Results are deduplicated by IOTA reference number.
Inputs: query (required), limit. Returns: object
iota_statsIota StatsARead-onlyIdempotent
Get IOTA programme summary statistics.
Returns total groups and islands, breakdown by continent, DXCC entity count, and most/least credited groups.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: version metadata, reference lookup, name search, island hierarchy, statistics, DXCC mapping, and proximity search. The only plausible overlap is lookup versus search, but they are separated by reference number versus name, and the descriptions make the boundary clear.
Six tools share a predictable iota_ prefix and are readable together, though the pattern is noun-oriented rather than a strict verb_noun convention. get_version_info is a minor deviation as a meta tool with a different prefix, but it is clear and not confusing.
Seven tools is well scoped for a read-only IOTA reference server. Each tool covers a meaningful operation, and there are no redundant or filler endpoints.
The surface covers lookup by reference, search by name, island hierarchy, DXCC mapping, proximity search, statistics, and version metadata. Minor gaps such as listing or filtering all groups without a name query are workable through existing search and mapping tools.
Maintenance
Related MCP Connectors
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
Automate 1,000+ services from any MCP-compatible AI agent: build Applets, run actions and queries.
Read and update your Everway trips and itineraries from any MCP-compatible AI assistant.
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
Related MCP Servers
- AlicenseAqualityAmaintenanceMCP server for HamQTH.com — callsign lookup, DX cluster spots, Reverse Beacon Network, DXCC resolution, and more through any MCP-compatible AI assistant.8126 PyPIGPL 3.0
- AlicenseAqualityAmaintenanceMCP server for QRZ.com — callsign lookups, DXCC entity resolution, and logbook queries through any MCP-compatible AI assistant.6269 PyPI4GPL 3.0
- AlicenseAqualityAmaintenanceMCP server for Parks on the Air (POTA) providing live activator spots, park details, activator/hunter stats, and scheduled activations through any MCP-compatible AI assistant.11147 PyPI3GPL 3.0
- AlicenseBqualityAmaintenanceMCP server for Summits on the Air (SOTA) — live spots, activation alerts, summit info, and nearby summits through any MCP-compatible AI assistant.5113 PyPI1GPL 3.0