Skip to main content
Glama
AetherLink SDR MCP

AetherLink SDR MCP

by N-Erickson

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

AetherLink SDR MCP Server. Controls RTL-SDR and HackRF software-defined radio hardware for spectrum analysis, signal decoding (ADS-B aircraft, AIS ships, POCSAG pagers, Meteor-M satellites, ISM band devices), recording, and transmission (HackRF only). All frequencies are in Hz. Spectrum, recording and audio tools need sdr_connect first. The decoder tools (aviation_*, pager_*, marine_*, ism_*, satellite_*) run external programs that take exclusive control of the radio; Python-side control is paused while one runs and restored when it is stopped. Pager (POCSAG) and AIS decoding have built-in decoders that need no extra software. The first attached RTL-SDR is opened automatically, and the receiver location is auto-detected for aircraft distances and satellite pass prediction (latitude/longitude arguments override it).

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
sdr_connectC

Connect to SDR hardware (RTL-SDR or HackRF) for Python-side control: spectrum analysis, scanning, IQ and audio recording, HackRF transmit.

sdr_disconnectA

Stop all activity and disconnect from SDR hardware

sdr_set_frequencyC

Set SDR center frequency in Hz

sdr_set_gainC

Set SDR gain in dB or 'auto'

sdr_get_statusA

Get current SDR status: connection, tuning, which decoders are running, and whether an external decoder currently holds the radio

sdr_list_devicesA

List attached RTL-SDR and HackRF devices (index, name, serial) without opening them

sdr_set_sample_rateB

Set the SDR sample rate in Hz (RTL-SDR 225 kHz-3.2 MHz, HackRF 2-20 MHz)

sdr_set_ppmB

Set the RTL-SDR frequency correction in parts per million (from rtl_test -p or a known reference)

sdr_set_bias_teeA

Enable or disable antenna port power (bias tee) for powering an LNA (RTL-SDR Blog V3/V4, HackRF)

aviation_track_aircraftA

Start tracking aircraft via ADS-B on 1090 MHz (dump1090, or rtl_adsb from the RTL-SDR drivers). Takes exclusive control of the RTL-SDR until aviation_stop_tracking or the duration elapses.

aviation_stop_trackingB

Stop tracking aircraft and return the radio to Python control

aviation_get_aircraftC

Get list of currently tracked aircraft

pager_start_decodingA

Start decoding POCSAG pager messages with the built-in decoder (no extra software; 512/1200/2400 baud at once). Runs until pager_stop_decoding or the duration ends. Common paging frequencies: 152-153 MHz, 454 MHz, 929-931 MHz; pager_find_frequencies can locate active channels.

pager_stop_decodingA

Stop decoding POCSAG pager messages and return the radio to Python control

pager_get_messagesC

Get decoded pager messages (newest last)

pager_find_frequenciesA

Scan the common paging bands (VHF 152-153/157-158 MHz, UHF 454-455/462-463 MHz, 929-932 MHz) for narrowband carriers that are likely pager channels, strongest first. Needs sdr_connect. Follow up with pager_start_decoding on a candidate.

marine_track_vesselsA

Start tracking ships via AIS (161.975 and 162.025 MHz, both channels) with the built-in receiver (no extra software). Runs until marine_stop_tracking or the duration ends. Needs a coastal or waterway location.

marine_stop_trackingA

Stop tracking ships and return the radio to Python control

marine_get_vesselsC

Get list of tracked vessels

satellite_decode_meteorA

Start decoding a Meteor-M weather satellite LRPT pass with SatDump in the background. Takes exclusive control of the RTL-SDR for the duration. Check progress with satellite_get_status; images land in the recordings directory.

satellite_get_statusA

Get the status and results of the current or last Meteor-M decode

satellite_stop_decodingA

Stop the running Meteor-M decode early and return the radio to Python control

satellite_predict_passesA

Predict upcoming Meteor-M passes over a location (rise/set times, peak elevation, azimuths) using current orbital elements from Celestrak. Needs network access. Use it to decide when to run satellite_decode_meteor.

spectrum_analyzeB

Perform spectrum analysis (FFT, signal detection) at the current frequency

spectrum_scanB

Scan a frequency range for signals (at most 2000 steps)

recording_startC

Start recording raw IQ samples (complex float32) to a file

recording_stopB

Stop the current IQ recording

audio_record_startB

Start recording demodulated audio (FM/AM) at the current frequency to a WAV file

audio_record_stopC

Stop the current audio recording

hackrf_set_tx_gainC

Set HackRF transmit gain (0-47 dB)

signal_generatorA

Generate and transmit a test signal (HackRF only, max 60 s). Transmission on aviation, public safety, cellular, GNSS and other protected bands is refused.

ism_start_scanningA

Start scanning ISM bands for devices (433/315/868/915 MHz) using rtl_433. Takes exclusive control of the RTL-SDR until ism_stop_scanning.

ism_stop_scanningA

Stop ISM band scanning and return the radio to Python control

ism_get_devicesB

Get list of detected ISM band devices (weather stations, sensors, etc.)

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
SDR StatusCurrent SDR hardware status
Tracked AircraftCurrently tracked aircraft from ADS-B
Waterfall DataRecent waterfall display data
Scan ResultsLatest frequency scan results

TDQS

B3.4/5.0

Scored across 34 tools

Disambiguation4/5

Tools are cleanly separated by domain prefix (sdr_, aviation_, pager_, marine_, satellite_, ism_, spectrum_, recording_, audio_record_), and the recurring start/stop/get triads make intent obvious. The only mild overlaps are spectrum_scan vs ism_start_scanning (mitigated by rtl_433-specific wording) and recording_start (IQ) vs audio_record_start (WAV), which descriptions do clarify.

Naming Consistency4/5

Strong, predictable domain-prefix + verb_noun pattern (sdr_set_frequency, aviation_track_aircraft, pager_get_messages, ism_stop_scanning) applied across nearly all 34 tools. Deviations are few: signal_generator (noun phrase, no prefix) and hackrf_set_tx_gain (device prefix instead of sdr_), plus the slightly longer audio_record_start/stop.

Tool Count2/5

34 tools is heavy for a single MCP server and exceeds a comfortable surface; the per-decoder start/stop/get triads multiply quickly. Each group is individually justified by the domain, but marginal entries like signal_generator and hackrf_set_tx_gain could be folded into general SDR controls.

Completeness4/5

Core lifecycle is well covered: device discovery, connect/disconnect, frequency, sample rate, gain, ppm, bias tee, status, plus spectrum, recording, audio, TX and four decoder families with prediction support. Minor gaps exist around demodulation mode/bandwidth/squelch settings (audio recording implies a demod choice that cannot be set) and no recording file management or listing.

Maintenance

ActivityNo data
ResponsivenessOutdated data