Operandi MCP server
cc.operandi/operandi·v1.0.3Grounded, safety-checked appliance operation packages for robots and agents. Zero-config trial.
0 stars12 downloads/wk
Reviews
Write oneNobody has reviewed Operandi yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Operandi tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan4 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 65 days ago12/15
- Maintainer identitynamespace and repository owner differ3/10
How Operandi compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 71/100
- higher than 36% of 48,255 servers
- Downloads a week
- 12
- more than 3% of 12,191 servers with a package
Install Operandi in Claude Code, Cursor or VS Code
claude mcp add operandi -- uvx operandi-mcp
What the publisher says
From the Operandi repository's README, as published. We do not edit it. Read it on GitHub
OPERANDI MCP Server — operate real appliances from any agent
mcp-name: cc.operandi/operandi
operandimcpserver.py exposes OPERANDI over the Model Context Protocol so any MCP-capable agent host (Claude Desktop, Claude Code, or your own agent runtime) can identify an appliance and pull its grounded, safety-checked, robot-executable operation package as native tools.
This is the "build for agents" surface: the customer is a robot's planner / an LLM agent, not a human reading PDFs.
Tools
Why an agent wants this
A general model, cold, gives confidently-wrong physical instructions on ordinary appliances a large fraction of the time (OPERANDI Stage A: 24% of cold instructions were would-fail, including invented buttons and cycles). Grounded in the package these tools return, that fell to 0 hallucinations, 96% exact. The tools turn "guess the buttons" into "read the manufacturer's ground truth". See ../docs/BUSINESS_MODEL.md.
Setup — zero config
pip install operandi-mcpThat's it. No key needed for your first packages: on first use the server mints an instant trial key itself (POST /v1/trial — no signup, 2 operation packages included, cached at ~/.operandi/mcp_key). When the trial is spent, tool responses tell the agent exactly how to sign up free (10 packages/month) or go Pro.
Have a key already? Set it and it wins over the trial:
export OPERANDI_API_KEY=ok_live_...Claude Desktop / Claude Code config
{
"mcpServers": {
"operandi": { "command": "operandi-mcp" }
}
}(Optionally add "env": {"OPERANDIAPIKEY": "oklive..."} once you have an account key.)
Then ask the agent: "Identify the Samsung ME20H705MSS and give me the safe procedure to defrost 0.5 kg of mince." — it will call identifyappliance then getoperation_package and answer from grounded data.
Notes
or the hosted service by changing OPERANDIAPIURL.
- The server is a thin, API-key-authenticated REST client — the same binary works against local dev
pytest tests/testmcpserver.py.
- Auth is Authorization: Bearer ; a missing/invalid key surfaces as a tool error, not a crash.
- Transport is newline-delimited JSON-RPC 2.0 (the MCP stdio transport). Offline protocol tests:
Nothing above is checked by us. What we check is on the safety report.
Operandi: common questions
- Is Operandi MCP server safe?
- Mostly: it is graded B (71/100). Read the Operandi safety report
- How do I install Operandi?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Operandi need an API key?
- Yes. The registry entry asks for
OPERANDI_API_KEY. - Is Operandi maintained?
- The last commit was 105 days ago (2026-07-22). The latest release is v1.0.3.
- How does Operandi compare with other MCP servers?
- safety score 71/100 (higher than 36% of 48,255 servers); downloads a week 12 (more than 3% of 12,191 servers with a package). Full comparison.