GNURadio MCP Server

What is GNURadio MCP Server?

GNURadio MCP Server (formerly GR-MCP, now called Marconi) is an LLM-driven RF tool for Claude Code. It lets you describe what you want on the air in plain language, then surveys the spectrum, builds and runs receivers, examines signals, and leaves behind reproducible RF projects (SigMF captures, YAML pipelines, .grc flowgraphs). It is currently simulation-only — no hardware support yet.

How to use GNURadio MCP Server?

Install it in Claude Code by running /plugin marketplace add yoelbassin/gr-mcp then /plugin install marconi. The uv tool starts the MCP server on first use with no further configuration. Ask in plain language, for example "Simulate an FM station at 100.3 MHz and build me a receiver." Artifacts are saved under artifacts/ in the server’s working directory, or can be redirected via the MARCONI_WORKSPACE environment variable.

Key features of GNURadio MCP Server

• Survey spectrum (PSD, signal detection, spectrogram)
• Simulate a registered device from a description
• Build, demodulate, validate, and run a receiver
• Debug when a receiver outputs no signal
• Closed-loop transmit-then-receive in simulation
• Escape hatch to direct Python library access

Use cases of GNURadio MCP Server

• Simulate a radio station and automatically build a matching receiver
• Analyze an existing IQ capture file to detect and decode signals
• Debug a receiver that produces no output
• Run reproducible RF experiments in simulation