home / mcp / oeradio mcp server

OERadio MCP Server

Provides a public MCP server delivering radio calculations, band plans, callsign data, and tools for IARU Region 1 operators.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "achildrenmile-oeradio-mcp": {
      "url": "https://oeradio-mcp.oeradio.at/mcp",
      "headers": {
        "YOUR_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can use the OERadio MCP Server to let your AI assistant perform amateur radio calculations and lookups through a standard MCP interface. By connecting your MCP client to the server, you gain immediate access to band plans, antenna data, cable losses, callsign information, and a wide range of utilities for on-the-fly calculations and lookups relevant to IARU Region 1 operations.

How to use

Connect your MCP client to the server at the MCP endpoint https://oeradio-mcp.oeradio.at/mcp. Once connected, you can ask your AI assistant questions like what are the band limits for a given band, how long a dipole should be for a specific frequency, or calculate EIRP for a portable setup. You can also browse data sources such as the complete IARU Region 1 band plan, coaxial cable data, antenna gains, and Austrian callsign information. Use the MCP interface to send JSON-RPC like requests to the server and receive structured results from the tools.

How to install

Prerequisites: you need Node.js 20 or newer installed on your system. Optionally, Docker is available if you prefer containerized deployment.

If you want to run the server locally, follow these steps in order:

1) Prepare your environment by ensuring Node.js is installed. Check with node -v and npm -v.

Additional sections

Configuration and access details are provided for connecting MCP clients. You will connect via the central MCP endpoint and can use either HTTP-based remote access or a local stdio setup depending on your client.

Health and status of the MCP server can be checked through the health endpoint at /health and the root endpoint provides server info and a list of available tools.

Available tools

get_band_plan

Retrieve the IARU Region 1 band plan for a specified band.

list_all_bands

List all amateur radio bands available in the MCP tools.

check_frequency

Verify whether a given frequency falls within amateur radio bands.

calculate_eirp

Compute effective isotropic radiated power from transmitter power, cable loss, and antenna gain.

calculate_cable_loss

Calculate attenuation of coaxial cables over a given length and frequency.

compare_cables

Compare performance of different cable types at a specified frequency and length.

calculate_battery_runtime

Estimate battery runtime for portable operation.

get_antenna_gain

Provide typical gains for common antenna types.

calculate_wavelength

Compute wavelength and derive approximate antenna lengths.

calculate_swr_loss

Estimate power loss due to SWR mismatch.

convert_power

Convert between Watt, dBm, and dBW.

callsign_lookup

Search Austrian callsigns across official sources and external fallbacks.

callsign_available

Check if a suffix is available across Austrian districts.

callsign_suggest

Generate callsign suggestions based on a name.

callsign_validate

Validate callsigns against Austrian rules.

callsign_database_info

Show database version and statistics for Austrian callsigns.

list_oeradio_tools

List all OERadio tools with their URLs.