Rigol DS1202Z-E MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RIGOL_RESOURCE | No | The VISA address of the oscilloscope. Use `rigol-mcp --list-usb` to discover the actual VISA address, then pass `--resource` or set `RIGOL_RESOURCE`. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Start with inspect_signal() for a compact report of all enabled channels. No identify/status preflight is needed; the server handles identity and sequencing. Use measure for one specific quantity, waveform for trace detail. Follow next_actions when readings are unavailable; do not invent signal values. Simulated results are not real measurements. Single only arms a trigger. For screenshots, channel setup, trigger settings or other advanced tasks, use discover_operations(query=task), then request the chosen operation's schema. Use advanced_read for observation and advanced_control for changes. For saved full-memory captures, use waveform.overview before exact sample reads; waveform.image is an optional visual envelope. Never request an entire raw capture as text. Settings readback is authoritative; do not assume a write matched the request.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| inspect_signalA | Start here: inspect all enabled channels, or one channel, in one call. Returns acquisition freshness, frequency/amplitude readings with units, probe ratios, unavailable readings and concrete next actions. No setup, identify, or status call needed. Does not change acquisition or settings. Null readings are not proof of no signal. |
| identifyA | Read model, serial, firmware, and whether this is a simulator. |
| statusA | Read acquisition status, timebase, channel scales, units, and probe ratios. |
| measureB | Read a built-in measurement. Invalid/no-signal readings return null with valid=false. |
| waveformA | Read a compact screen-waveform summary from a STOPPED scope. Set include_samples=true only when the individual time/amplitude arrays are needed. Changes waveform transfer source/format/range; does not stop or restart acquisition. Leaves transfer settings at BYTE/NORMAL. Not a full-memory capture. |
| acquisitionA | Start, stop, or arm a single acquisition. Requires --allow-control. Run/single may replace an existing captured waveform. Single returns before triggering. |
| set_timebaseA | Change horizontal scale in YT mode and read back the actual setting. Requires --allow-control. Scope may round to a supported 1-2-5 scale. |
| discover_operationsA | Find advanced capabilities by task. Supply an operation ID to get its exact schema and effects. No instrument access. Planned entries cannot execute; search results stay compact. |
| advanced_readA | Execute a discovered read operation. Exact parameters come from discover_operations. Screenshots return a saved artifact receipt; artifact.image explicitly retrieves the image. waveform.overview is a bounded saved-data envelope; waveform.image returns its optional PNG. Cannot change acquisition or channel/trigger settings. |
| advanced_controlA | Execute a discovered control or full-memory capture, requiring --allow-control. Validates before writing; returns actual settings and any partial failure. Changes may invalidate a retained capture. Inspect readback before retrying. Settings changes do not generally roll back; decode.capture explicitly restores the previous core setup. Full-memory capture performs its documented transfer/acquisition cleanup. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
identify, acquisition, set_timebase, and the discover/advanced trio are cleanly separated. inspect_signal intentionally bundles readings that also appear in status and measure, so a few boundaries are fuzzy, but the descriptions make the intended entry point clear.
Names mix bare verbs (identify, measure), bare nouns (status, waveform, acquisition), verb_noun (inspect_signal, set_timebase), and adjective_noun (advanced_read, advanced_control). Multiword names are consistently snake_case and readable, but there is no single predictable convention.
10 tools is a well-scoped size for an oscilloscope MCP. The discover/advanced abstraction prevents a large flat command surface while keeping common workflows directly accessible.
Core read, inspect, measure, waveform, acquisition, and timebase workflows are covered, and advanced discovery/control extends the surface. Direct front-panel setup for vertical channel and trigger configuration is not exposed as dedicated tools, leaving notable but workable gaps.