oeradio-mcp

achildrenmile/oeradio-mcp
0 starsMITCommunity

Install to Claude Code

This server doesn't publish a one-line install command. Follow the setup in the source repository.

Summary

Amateur radio MCP server with band plans, EIRP, cable loss, antenna gains, and more

README.md

OERadio MCP Server

![Featured on oeradio.at](https://oeradio.at/werkzeuge/) ![Live Demo](https://oeradio-mcp.oeradio.at/mcp) ![License: MIT](https://opensource.org/licenses/MIT)

🎙️ Part of the oeradio.at open source ham radio tool collection. Browse all tools → oeradio.at/werkzeuge

Public MCP (Model Context Protocol) server providing amateur radio tools and calculations for IARU Region 1 operators.

Endpoint: https://oeradio-mcp.oeradio.at/mcp Author: OE8YML License: MIT

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI assistants to use external tools. Originally developed by Anthropic, MCP is now supported by Claude, ChatGPT, and Gemini. With this server, you can ask your AI assistant questions like "What are the band limits for 20m?" or "How long should my dipol be for 14.2 MHz?" and get instant calculations.

Supported AI Assistants

| Platform | MCP Support | Notes | |----------|-------------|-------| | Claude Desktop | Yes | Full support | | Claude Code (CLI) | Yes | Full support | | ChatGPT Desktop | Yes | Requires Developer Mode (Pro/Plus/Team/Enterprise) | | Gemini CLI | Yes | Since December 2025 | | claude.ai (web) | No | Desktop app only | | chatgpt.com (web) | No | Desktop app only |

Available Tools

Radio Calculation Tools

| Tool | Description | |------|-------------| | get_band_plan | Get IARU Region 1 band plan for a specific band | | list_all_bands | List all amateur radio bands | | check_frequency | Check if a frequency is within amateur bands | | calculate_eirp | Calculate EIRP/ERP from power, cable loss, and antenna gain | | calculate_cable_loss | Calculate coaxial cable attenuation | | compare_cables | Compare all cable types at a given frequency and length | | calculate_battery_runtime | Calculate battery runtime for portable operation | | get_antenna_gain | Look up typical antenna gain values | | calculate_wavelength | Calculate wavelength and antenna lengths | | calculate_swr_loss | Calculate power loss from SWR mismatch | | convert_power | Convert between Watt, dBm, and dBW |

Austrian Callsign Tools

| Tool | Description | |------|-------------| | callsign_lookup | Search Austrian callsigns (fb.gv.at, QRZ.com, HamQTH fallback) | | callsign_available | Check if a suffix is available across Austrian districts | | callsign_suggest | Generate callsign suggestions based on name | | callsign_validate | Validate callsigns against Austrian rules | | callsign_database_info | Show database version and statistics |

The callsign tools use the official Austrian callsign list from fb.gv.at as the primary data source. External lookups (QRZ.com, HamQTH) include warnings when a callsign is found externally but not in the official list.

Directory Tools

| Tool | Description | |------|-------------| | list_oeradio_tools | List all OERadio.at amateur radio web tools with URLs |

Available Resources

| URI | Description | |-----|-------------| | bandplan://iaru-region1/complete | Complete IARU Region 1 band plan | | cables://coaxial/all | Attenuation data for all coaxial cables | | antennas://gains/all | Typical antenna gain values | | oeradio://tools/all | Complete OERadio.at tools directory | | callsigns://districts | Austrian amateur radio districts (OE1-OE9) | | callsigns://license-classes | Austrian license class information |

Supported Data

Bands (IARU Region 1)

2200m, 630m, 160m, 80m, 60m, 40m, 30m, 20m, 17m, 15m, 12m, 10m, 6m, 2m, 70cm, 23cm, 13cm

Coaxial Cables

RG58, RG213, H2000Flex, Aircell7, Ecoflex10, Ecoflex15, LMR400, LMR600

Antenna Types

Dipol, Groundplane, Vertical, Yagi (3/5/7 elements), Quad (2 elements), J-Pole, Slim Jim, Collinear (X50/X200/X510)

Austrian Callsign Data

  • Source: Official callsign list from fb.gv.at (FernmeldebĂĽro)
  • Updates: Automatic monthly updates via GitHub Actions
  • Districts: OE1 (Wien), OE2 (Salzburg), OE3 (NĂ–), OE4 (Burgenland), OE5 (OĂ–), OE6 (Steiermark), OE7 (Tirol), OE8 (Kärnten), OE9 (Vorarlberg)
  • License Classes: Class 1 (CEPT full), Class 3 (CEPT restricted), Class 4 (Beginner)

The callsign database is updated automatically on the 2nd of each month and contains ~7,500 entries.

OERadio.at Web Tools

All tools are available at https://oeradio.at/werkzeuge/

Calculators (Blick-Series): | Tool | URL | Description | |------|-----|-------------| | AkkuBlick | https://akkublick.oeradio.at | Battery planner for portable operation | | AntennenBlick | https://antennenblick.oeradio.at | Antenna information and calculations | | BandBlick | https://bandblick.oeradio.at | IARU Region 1 band plan viewer | | KabelBlick | https://kabelblick.oeradio.at | Coaxial cable attenuation calculator | | StrahlBlick | https://strahlblick.oeradio.at | RF safety calculator (EIRP) | | RelaisBlick | https://relaisblick.oeradio.at | Austrian repeater map |

Learning Tools: | Tool | URL | Description | |------|-----|-------------| | OE-CEPT | https://oecept.oeradio.at | Austrian amateur radio exam trainer | | CQ...Nothing | https://cqnothing.oeradio.at | HF troubleshooting scenario trainer | | FirstContact | https://firstcontact.oeradio.at | Shortwave beginner tutorial | | PrefixPlay | https://prefixplay.oeradio.at | Callsign prefix learning game | | QBlitz | https://qblitz.oeradio.at | Q-codes rapid trainer | | QSOBuddy | https://qsobuddy.oeradio.at | QSO conversation practice | | MorseFleet | https://morsefleet.oeradio.at | Morse code Battleship game (10-25 WPM) |

Utilities: | Tool | URL | Description | |------|-----|-------------| | QSL Card Generator | https://qsl.oeradio.at | Create custom QSL confirmation cards | | FunkPilot | https://funkpilot.oeradio.at | AI assistant for amateur radio | | Dobratschrunde | https://dobratschrunde.oeradio.at | Guestbook for Dobratsch radio round |

Client Configuration

Claude Desktop

Add to your configuration file:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/claude/claude_desktop_config.json
{
  "mcpServers": {
    "oeradio": {
      "type": "streamable-http",
      "url": "https://oeradio-mcp.oeradio.at/mcp"
    }
  }
}

Claude Code (CLI)

Add to ~/.config/claude/settings.json:

{
  "mcpServers": {
    "oeradio": {
      "type": "streamable-http",
      "url": "https://oeradio-mcp.oeradio.at/mcp"
    }
  }
}

ChatGPT (Developer Mode)

Requires ChatGPT Pro, Plus, Team, or Enterprise account.

  1. Go to Settings > Connectors > Advanced
  2. Enable Developer Mode
  3. Click Create and enter:
  • Name: OERadio
  • URL: https://oeradio-mcp.oeradio.at/mcp
  1. In chat: Click + > More > Developer mode and select OERadio

Gemini CLI

Add the server using the command:

gemini mcp add --transport http oeradio https://oeradio-mcp.oeradio.at/mcp

Or add to your settings.json:

{
  "mcpServers": {
    "oeradio": {
      "url": "https://oeradio-mcp.oeradio.at/mcp"
    }
  }
}

Clients with stdio only

{
  "mcpServers": {
    "oeradio": {
      "command": "npx",
      "args": ["mcp-remote", "https://oeradio-mcp.oeradio.at/mcp"]
    }
  }
}

API Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | / | GET | Server info and tool list | | /health | GET | Health check | | /mcp | POST | MCP JSON-RPC requests | | /mcp | GET | MCP SSE stream (with session ID) | | /mcp | DELETE | End session |

Self-Hosting

Requirements

  • Node.js 20+
  • Docker (optional)

Docker

docker build -t oeradio-mcp .
docker run -d -p 3000:3000 --name oeradio-mcp oeradio-mcp

Docker Compose

docker compose up -d

Manual

npm install
npm run build
npm start

Development

npm install
npm run dev

Registry

This server is published to the MCP Registry:

  • Name: io.github.achildrenmile/oeradio-mcp
  • Version: 1.0.0

Links

  • Website: https://oeradio.at
  • MCP Endpoint: https://oeradio-mcp.oeradio.at/mcp
  • Health Check: https://oeradio-mcp.oeradio.at/health
  • GitHub: https://github.com/achildrenmile/oeradio-mcp

License

MIT

---

73 de OE8YML

Related MCP servers

Browse all →