io.github.achildrenmile/oeradio-mcp

Official17 toolsLive

by achildrenmile · TypeScript

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

OERadio MCP Server (io.github.achildrenmile/oeradio-mcp)

The OERadio MCP server is an amateur radio MCP server that provides band plans and related RF parameters, including EIRP, cable loss, antenna gains, and more. It is part of the open source oeradio.at ham radio tool collection, with a live demo available.

🛠️ Key Features

Band plans
EIRP calculations
Cable loss information
Antenna gains
Additional amateur radio related RF data

🚀 Use Cases

Planning amateur radio operations using band plans
Estimating transmitted power via EIRP
Accounting for feedline/cable loss
Applying antenna gain values in link/coverage considerations

⚡ Developer Benefits

MCP server with 17 tools
Topics include hamradio, hamradio-application, and oeradio-at
MIT-licensed implementation

⚠️ Limitations

Only the server’s description and provided excerpt are available here; specific tool names and I/O details are not included in the source data.

Topics

hamradiohamradio-applicationoeradio-at

Captured live from the server via tools/list.

get_band_plan

Gibt Frequenzgrenzen, erlaubte Modes und maximale Sendeleistung für ein Amateurfunkband zurück (IARU Region 1 / Österreich)

Parameters1

band

string

required

Bandbezeichnung wie '20m', '2m', '70cm', '160m'

Raw schema

{
  "type": "object",
  "properties": {
    "band": {
      "type": "string",
      "description": "Bandbezeichnung wie '20m', '2m', '70cm', '160m'"
    }
  },
  "required": [
    "band"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_all_bands

Listet alle verfügbaren Amateurfunkbänder mit Grundinformationen auf

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_frequency

Prüft ob eine Frequenz im Amateurfunk erlaubt ist und gibt das zugehörige Band zurück

Parameters2

frequency	number	required	Frequenz als Zahl
unit	string	optional	Einheit der Frequenz

Raw schema

{
  "type": "object",
  "properties": {
    "frequency": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Frequenz als Zahl"
    },
    "unit": {
      "type": "string",
      "enum": [
        "Hz",
        "kHz",
        "MHz"
      ],
      "default": "kHz",
      "description": "Einheit der Frequenz"
    }
  },
  "required": [
    "frequency"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_eirp

Berechnet EIRP (Equivalent Isotropically Radiated Power) aus Sendeleistung, Kabelverlust und Antennengewinn. Nützlich für Sicherheitsabstands-Berechnungen nach ÖNORM.

Parameters3

power_watts	number	required	Sendeleistung in Watt
cable_loss_db	number	required	Kabelverlust in dB
antenna_gain_dbi	number	required	Antennengewinn in dBi

Raw schema

{
  "type": "object",
  "properties": {
    "power_watts": {
      "type": "number",
      "minimum": 0.001,
      "maximum": 2000,
      "description": "Sendeleistung in Watt"
    },
    "cable_loss_db": {
      "type": "number",
      "minimum": 0,
      "maximum": 50,
      "description": "Kabelverlust in dB"
    },
    "antenna_gain_dbi": {
      "type": "number",
      "minimum": -10,
      "maximum": 50,
      "description": "Antennengewinn in dBi"
    }
  },
  "required": [
    "power_watts",
    "cable_loss_db",
    "antenna_gain_dbi"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_cable_loss

Berechnet die Kabeldämpfung für verschiedene Koaxialkabeltypen bei einer bestimmten Frequenz und Länge

Parameters3

cable_type	string	required	Kabeltyp
length_meters	number	required	Kabellänge in Metern
frequency_mhz	number	required	Frequenz in MHz

Raw schema

{
  "type": "object",
  "properties": {
    "cable_type": {
      "type": "string",
      "enum": [
        "RG58",
        "RG213",
        "H2000Flex",
        "Aircell7",
        "Ecoflex10",
        "Ecoflex15",
        "LMR400",
        "LMR600"
      ],
      "description": "Kabeltyp"
    },
    "length_meters": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 1000,
      "description": "Kabellänge in Metern"
    },
    "frequency_mhz": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 3000,
      "description": "Frequenz in MHz"
    }
  },
  "required": [
    "cable_type",
    "length_meters",
    "frequency_mhz"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

compare_cables

Vergleicht alle verfügbaren Kabeltypen bei einer bestimmten Frequenz und Länge

Parameters2

length_meters	number	required	Kabellänge in Metern
frequency_mhz	number	required	Frequenz in MHz

Raw schema

{
  "type": "object",
  "properties": {
    "length_meters": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 1000,
      "description": "Kabellänge in Metern"
    },
    "frequency_mhz": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 3000,
      "description": "Frequenz in MHz"
    }
  },
  "required": [
    "length_meters",
    "frequency_mhz"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_battery_runtime

Berechnet die Akkulaufzeit basierend auf Kapazität und durchschnittlichem Stromverbrauch. Berücksichtigt Effizienz und Entladetiefe.

Parameters5

capacity_ah	number	required	Akkukapazität in Amperestunden (Ah)
voltage	number	required	Nennspannung des Akkus in Volt
consumption_watts	number	required	Durchschnittlicher Verbrauch in Watt
efficiency	number	optional	Wirkungsgrad des Reglers (0.85 = 85%)
max_discharge_percent	number	optional	Maximale Entladetiefe in % (80% empfohlen für LiFePO4)

Raw schema

{
  "type": "object",
  "properties": {
    "capacity_ah": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 1000,
      "description": "Akkukapazität in Amperestunden (Ah)"
    },
    "voltage": {
      "type": "number",
      "minimum": 1,
      "maximum": 60,
      "description": "Nennspannung des Akkus in Volt"
    },
    "consumption_watts": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 2000,
      "description": "Durchschnittlicher Verbrauch in Watt"
    },
    "efficiency": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 1,
      "default": 0.85,
      "description": "Wirkungsgrad des Reglers (0.85 = 85%)"
    },
    "max_discharge_percent": {
      "type": "number",
      "minimum": 10,
      "maximum": 100,
      "default": 80,
      "description": "Maximale Entladetiefe in % (80% empfohlen für LiFePO4)"
    }
  },
  "required": [
    "capacity_ah",
    "voltage",
    "consumption_watts"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_antenna_gain

Gibt typische Gewinnwerte für verschiedene Antennentypen zurück

Parameters1

antenna_type

string

optional

Antennentyp (z.B. 'dipol', 'yagi-5el') oder leer für alle

Raw schema

{
  "type": "object",
  "properties": {
    "antenna_type": {
      "type": "string",
      "description": "Antennentyp (z.B. 'dipol', 'yagi-5el') oder leer für alle"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_wavelength

Berechnet die Wellenlänge für eine gegebene Frequenz und optional Drahtlängen für Antennen

Parameters3

frequency	number	required	Frequenz
unit	string	optional	Einheit der Frequenz
velocity_factor	number	optional	Verkürzungsfaktor für Draht (0.95 typisch)

Raw schema

{
  "type": "object",
  "properties": {
    "frequency": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Frequenz"
    },
    "unit": {
      "type": "string",
      "enum": [
        "Hz",
        "kHz",
        "MHz",
        "GHz"
      ],
      "default": "MHz",
      "description": "Einheit der Frequenz"
    },
    "velocity_factor": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 1,
      "default": 0.95,
      "description": "Verkürzungsfaktor für Draht (0.95 typisch)"
    }
  },
  "required": [
    "frequency"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_swr_loss

Berechnet den Leistungsverlust durch Fehlanpassung (SWR/VSWR)

Parameters1

swr

number

required

SWR-Wert (z.B. 1.5, 2.0, 3.0)

Raw schema

{
  "type": "object",
  "properties": {
    "swr": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "description": "SWR-Wert (z.B. 1.5, 2.0, 3.0)"
    }
  },
  "required": [
    "swr"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

convert_power

Rechnet Leistungswerte zwischen Watt, dBm und dBW um

Parameters2

value	number	required	Leistungswert
from_unit	string	required	Ausgangseinheit

Raw schema

{
  "type": "object",
  "properties": {
    "value": {
      "type": "number",
      "description": "Leistungswert"
    },
    "from_unit": {
      "type": "string",
      "enum": [
        "W",
        "mW",
        "dBm",
        "dBW"
      ],
      "description": "Ausgangseinheit"
    }
  },
  "required": [
    "value",
    "from_unit"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_oeradio_tools

Listet alle verfügbaren OERadio.at Amateurfunk-Werkzeuge mit URLs und Beschreibungen

Parameters1

callsign_lookup

Sucht ein österreichisches Amateurfunkrufzeichen und gibt Inhaberinformationen zurück. Primäre Quelle: offizielle fb.gv.at Liste, mit Fallback auf QRZ.com und HamQTH.

Parameters2

callsign	string	required	Das zu suchende Rufzeichen (z.B. "OE8YML")
include_address	boolean	optional	Adresse inkludieren wenn verfügbar

Raw schema

{
  "type": "object",
  "properties": {
    "callsign": {
      "type": "string",
      "description": "Das zu suchende Rufzeichen (z.B. \"OE8YML\")"
    },
    "include_address": {
      "type": "boolean",
      "default": false,
      "description": "Adresse inkludieren wenn verfügbar"
    }
  },
  "required": [
    "callsign"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

callsign_available

Prüft ob ein Suffix in Österreich verfügbar ist. Zeigt in welchen Bundesländern das Rufzeichen frei oder belegt ist.

Parameters2

suffix	string	required	2-3 Buchstaben Suffix (z.B. "YML")
district	number	optional	Spezifisches Bundesland prüfen (1-9)

Raw schema

{
  "type": "object",
  "properties": {
    "suffix": {
      "type": "string",
      "description": "2-3 Buchstaben Suffix (z.B. \"YML\")"
    },
    "district": {
      "type": "number",
      "minimum": 1,
      "maximum": 9,
      "description": "Spezifisches Bundesland prüfen (1-9)"
    }
  },
  "required": [
    "suffix"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

callsign_suggest

Generiert Wunschrufzeichen-Vorschläge basierend auf Namen und Präferenzen. Berücksichtigt Verfügbarkeit, Phonetik und CW-Freundlichkeit.

Parameters5

name	string	required	Vor- und/oder Nachname
preferred_district	number	optional	Bevorzugtes Bundesland (1-9)
max_results	number	optional	Maximale Anzahl Vorschläge
exclude_club	boolean	optional	Keine X-Präfixe (Klubrufzeichen) vorschlagen
min_phonetic_score	number	optional	Mindest-Phonetik-Score (0-1)

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Vor- und/oder Nachname"
    },
    "preferred_district": {
      "type": "number",
      "minimum": 1,
      "maximum": 9,
      "description": "Bevorzugtes Bundesland (1-9)"
    },
    "max_results": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Maximale Anzahl Vorschläge"
    },
    "exclude_club": {
      "type": "boolean",
      "default": true,
      "description": "Keine X-Präfixe (Klubrufzeichen) vorschlagen"
    },
    "min_phonetic_score": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "default": 0.5,
      "description": "Mindest-Phonetik-Score (0-1)"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

callsign_validate

Validiert ein Rufzeichen gegen österreichische Regeln. Prüft Format, Bezirk und Suffix-Länge.

Parameters1

callsign

string

required

Zu validierendes Rufzeichen

Raw schema

{
  "type": "object",
  "properties": {
    "callsign": {
      "type": "string",
      "description": "Zu validierendes Rufzeichen"
    }
  },
  "required": [
    "callsign"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

callsign_database_info

Zeigt Informationen über die Rufzeichen-Datenbank (Version, Anzahl Einträge, Statistiken)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md8 KBView on GitHub

OERadio MCP Server

🎙️ 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

json

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

Claude Code (CLI)

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

json

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

ChatGPT (Developer Mode)

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

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

Gemini CLI

Add the server using the command:

bash

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

Or add to your settings.json:

json

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

Clients with stdio only

json

{
  "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

bash

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

Docker Compose

bash

docker compose up -d

Manual

bash

npm install
npm run build
npm start

Development

bash

npm install
npm run dev

Registry

This server is published to the MCP Registry:

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

License

MIT

73 de OE8YML

Install

Tools (17)

get_band_planlist_all_bandscheck_frequencycalculate_eirpcalculate_cable_losscompare_cablescalculate_battery_runtimeget_antenna_gain

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://oeradio-mcp.oeradio.at/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

OERadio MCP Server (io.github.achildrenmile/oeradio-mcp)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_band_plan

list_all_bands

check_frequency

calculate_eirp

calculate_cable_loss

compare_cables

calculate_battery_runtime

get_antenna_gain

calculate_wavelength

calculate_swr_loss

convert_power

list_oeradio_tools

callsign_lookup

callsign_available

callsign_suggest

callsign_validate

callsign_database_info

OERadio MCP Server

What is MCP?

Supported AI Assistants

Available Tools

Radio Calculation Tools

Austrian Callsign Tools

Directory Tools

Available Resources

Supported Data

Bands (IARU Region 1)

Coaxial Cables

Antenna Types

Austrian Callsign Data

OERadio.at Web Tools

Client Configuration

Claude Desktop

Claude Code (CLI)

ChatGPT (Developer Mode)

Gemini CLI

Clients with stdio only

API Endpoints

Self-Hosting

Requirements

Docker

Docker Compose

Manual

Development

Registry

Links

License

Install

Remote endpoint

Related servers