Oeradio MCP

🚀 OERadio MCP Server

This is a public MCP (Model Context Protocol) server that offers amateur radio tools and calculations for operators in IARU Region 1.

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

🚀 Quick Start

The Model Context Protocol (MCP) is an open - standard that enables AI assistants to utilize external tools. Initially developed by Anthropic, MCP is now supported by Claude, ChatGPT, and Gemini. With this server, you can pose questions to your AI assistant, such as "What are the band limits for 20m?" or "How long should my dipol be for 14.2 MHz?", and obtain instant calculations.

✨ Features

Supported AI Assistants

Available Tools

Radio Calculation Tools

Austrian Callsign Tools

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

Available Resources

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

Calculators (Blick - Series)

Learning Tools

Utilities

💻 Usage Examples

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
4. 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"]
    }
  }
}

📚 Documentation

API Endpoints

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