Iota Mcp

STDIOregistry active

Summary

Pulls data from the official Islands on the Air programme and exposes seven tools for ham radio operators and contesters. You get group lookup by reference (NA-005), island and group search by name, bidirectional DXCC entity mapping, geographic queries to find nearby groups by coordinates, and programme statistics showing credit totals by continent. Data is cached from IOTA's public JSON downloads and refreshes daily. No authentication needed since all IOTA data is public. Useful if you're planning DXpeditions, tracking activations, or building tools around the IOTA awards programme. Part of the qso-graph project.

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

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

pip install iota-mcp

Tools

Tool	Description
`iota_lookup`	Look up an IOTA group by reference number (e.g., NA-005)
`iota_search`	Search groups and islands by name (e.g., Hawaii, Shetland)
`iota_islands`	List all islands and subgroups in an IOTA group
`iota_dxcc`	Bidirectional DXCC-to-IOTA mapping
`iota_stats`	Programme summary — totals by continent, most/least credited
`iota_nearby`	Find IOTA groups nearest to a lat/lon location
`get_version_info`	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": "iota-mcp"
    }
  }
}

Claude Code

Add to .claude/settings.json:

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

ChatGPT Desktop

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

Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

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

VS Code / GitHub Copilot

Add to .vscode/mcp.json in your workspace:

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

Gemini CLI

Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

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

Example Prompts

"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).

Development

git clone https://github.com/qso-graph/iota-mcp.git
cd iota-mcp
pip install -e .

# Run with mock data (no network)
IOTA_MCP_MOCK=1 python -m iota_mcp.server

# Run with MCP Inspector
iota-mcp --transport streamable-http --port 8010

# Security tests
pip install pytest
pytest tests/test_security.py -v

License

GPL-3.0-or-later

Featured

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

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

pip install iota-mcp

Tools

Tool	Description
`iota_lookup`	Look up an IOTA group by reference number (e.g., NA-005)
`iota_search`	Search groups and islands by name (e.g., Hawaii, Shetland)
`iota_islands`	List all islands and subgroups in an IOTA group
`iota_dxcc`	Bidirectional DXCC-to-IOTA mapping
`iota_stats`	Programme summary — totals by continent, most/least credited
`iota_nearby`	Find IOTA groups nearest to a lat/lon location
`get_version_info`	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": "iota-mcp"
    }
  }
}

Claude Code

Add to .claude/settings.json:

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

ChatGPT Desktop

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

Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

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

VS Code / GitHub Copilot

Add to .vscode/mcp.json in your workspace:

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

Gemini CLI

Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

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

Example Prompts

"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).

Development

git clone https://github.com/qso-graph/iota-mcp.git
cd iota-mcp
pip install -e .

# Run with mock data (no network)
IOTA_MCP_MOCK=1 python -m iota_mcp.server

# Run with MCP Inspector
iota-mcp --transport streamable-http --port 8010

# Security tests
pip install pytest
pytest tests/test_security.py -v

License

GPL-3.0-or-later

Iota Mcp

iota-mcp

Install

Tools

Quick Start

Configure your MCP client

Claude Desktop

Claude Code

ChatGPT Desktop

Cursor

VS Code / GitHub Copilot

Gemini CLI

Example Prompts

Data Source

Development

License

Iota Mcp

iota-mcp

Install

Tools

Quick Start

Configure your MCP client

Claude Desktop

Claude Code

ChatGPT Desktop

Cursor

VS Code / GitHub Copilot

Gemini CLI

Example Prompts

Data Source

Development

License

More from qso-graph

Related Search & Web Crawling MCP Servers

More from qso-graph

Related Search & Web Crawling MCP Servers