Marconi 🤖

        o)))
        |
    .-------.
    | o   o |
    |   v   |
    '-------'
Hi! I'm Marco.

LLM-driven RF for Claude Code. Describe what you want on the air and I survey the
spectrum, build and run the receiver, look at the signal, and leave a reproducible
RF project behind — SigMF captures, YAML pipelines, and .grc flowgraphs you own.

> Early development — v1.0 is simulation-only (no hardware yet). See ROADMAP.md.

> Proviously known as GNURadio/GR-MCP.

Requirements

- uv and Python ≥ 3.13
- GNU Radio 3.10+ installed system-wide (conda-forge,
your distro's package manager, or Homebrew) — needed to run pipelines and
simulate. Analyzing existing IQ files doesn't require it.

Install

In Claude Code:

/plugin marketplace add yoelbassin/gr-mcp
/plugin install marconi

That's it — uv starts the MCP server on first use and loads the skills. Nothing
else to configure.

Use it

Ask in plain language:

> "Simulate an FM station at 100.3 MHz and build me a receiver."

> "Here's a capture, mystery.wav — survey what's on the air, then decode the strongest carrier."

I pick the right skill and drive the workflow end to end:

- survey-spectrum — what's present (PSD, signal detection, spectrogram)
- simulate-scene — register a simulated device from a description
- build-receiver — channelize, demodulate, validate, run, verify, save
- debug-no-signal — locate the fault when a receiver outputs nothing
- tx-experiment — closed-loop transmit-then-receive in simulation
- escape-hatch — drop to the Python library when no tool fits

Artifacts land under artifacts/ in the server's working directory; set
MARCONI_WORKSPACE to put them elsewhere.

License

GPL-3.0-or-later.