AetherLink SDR MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| SDR Status | Current SDR hardware status |
| Tracked Aircraft | Currently tracked aircraft from ADS-B |
| Waterfall Data | Recent waterfall display data |
| Scan Results | Latest frequency scan results |
TDQS
Scored across 34 tools
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.
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.
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.
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.