Operandi MCP server
{
"mcpServers": {
"operandi": {
"command": "uvx",
"args": [
"operandi-mcp"
],
"env": {
"OPERANDI_API_KEY": "<operandi_api_key>",
"OPERANDI_API_URL": "https://..."
}
}
}
}{
"mcpServers": {
"operandi": {
"command": "uvx",
"args": [
"operandi-mcp"
],
"env": {
"OPERANDI_API_KEY": "<operandi_api_key>",
"OPERANDI_API_URL": "https://..."
}
}
}
}{
"mcpServers": {
"operandi": {
"command": "uvx",
"args": [
"operandi-mcp"
],
"env": {
"OPERANDI_API_KEY": "<operandi_api_key>",
"OPERANDI_API_URL": "https://..."
}
}
}
}{
"servers": {
"operandi": {
"command": "uvx",
"args": [
"operandi-mcp"
],
"env": {
"OPERANDI_API_KEY": "${input:operandi_api_key}",
"OPERANDI_API_URL": "${input:operandi_api_url}"
}
}
},
"inputs": [
{
"id": "operandi_api_key",
"type": "promptString",
"description": "Operandi api key",
"password": true
},
{
"id": "operandi_api_url",
"type": "promptString",
"description": "Operandi api url",
"password": true
}
]
}{
"mcpServers": {
"operandi": {
"command": "uvx",
"args": [
"operandi-mcp"
],
"env": {
"OPERANDI_API_KEY": "<operandi_api_key>",
"OPERANDI_API_URL": "https://..."
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall uvx operandi-mcpversion 1.0.3
What it does
Exposes OPERANDI, a catalog of grounded, safety-checked operation packages for real appliances, so agents can call the correct procedures instead of hallucinating button locations or cycles. Designed for robot planners and LLM agents that need to operate physical devices like ovens, washing machines, and refrigerators with manufacturer accuracy.
- An agent identifies a specific appliance model from a photo or nameplate and retrieves the exact, verified procedure to operate it safely.
- A robot planner finds appliances by capability (e.g., 'heat', 'wash', 'defrost') to select the right machine for a task.
- An agent retrieves step-by-step control instructions with grounding, verification signals, and recovery logic instead of guessing at panel buttons.
Tools this server exposes
| Tool | Does |
|---|---|
| identify_appliance | Resolve observed nameplate text, panel labels, or model number to a catalog appliance object. |
| get_operation_package | Retrieve the model-specific executable package including procedures, control map, verification signals, recovery state machine, and safety envelope. |
| list_appliances | Browse available operable appliances, optionally filtered by category. |
| find_by_capability | Find appliances by function such as heat, wash, brew, or defrost. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.