Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
RIGOL_RESOURCENoThe 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

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

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.6/5.0

Scored across 10 tools

Disambiguation4/5

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.

Naming Consistency3/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityNo data
ResponsivenessOutdated data