mcp-server-onkyo
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ONKYO_HOST | No | Receiver IP address | 192.168.1.50 |
| ONKYO_PORT | No | eISCP port | 60128 |
| ONKYO_MAX_VOLUME | No | Safety cap on the display scale. Enforced by the server, not left to the model | 50 |
| ONKYO_VOLUME_STEPS | No | Raw volume steps per display unit: 2 for newer models with 0.5 steps (TX-NR6050, TX-NR7100), 1 for older ones | 2 |
| ONKYO_DISCOVERY_ADDR | No | Where the discovery query is sent | 255.255.255.255 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
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 |
|---|---|
| discover_receiversA | Find Onkyo/Integra/Pioneer receivers on the local network. Returns each receiver's IP address, model, eISCP port and MAC address. |
| get_statusA | Get a receiver's current power state, master volume (0-100), mute state, selected input and listening mode. If there are several receivers on the network, call discover_receivers first and pass the one you want. |
| set_powerB | Turn the main zone on, or put it into standby. |
| set_volumeA | Set master volume on the receiver's 0-100 display scale (0.5 steps on newer models). Values above the configured safety cap are clamped. |
| set_muteC | Mute or unmute the main zone. |
| set_inputA | Select the main zone's input source. Names match the receiver's front-panel labels (e.g. "bd-dvd" for the BD/DVD input, "net" for network streaming). The receiver must be on. |
| set_listening_modeA | Set the main zone's listening mode (surround processing). "direct" and "pure-audio" play the source unprocessed; "dolby-surround" and "dts-neural-x" upmix to all speakers and play Dolby Atmos / DTS:X content natively. The receiver must be on, and may reject modes that don't suit the current input signal. |
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 7 tools
Each tool targets a clearly distinct action or receiver property; discover_receivers and get_status are separated by network discovery vs single-device state read. The set_* tools each control a different aspect with no overlapping purposes.
All tool names follow a consistent snake_case verb_noun pattern (discover_receivers, get_status, set_power, etc.). The mix of discover/get/set verbs is semantically appropriate and predictable.
Seven tools is well-scoped for controlling an Onkyo receiver, covering discovery, status, and the main control operations without redundancy or filler.
The surface covers the core main-zone lifecycle: discovery, status, power, volume, mute, input, and listening mode. Secondary-zone control, tone adjustments, or sleep timers are absent, but these are minor gaps for the stated main-zone purpose.