English Français العربية

cc.operandi/operandi

Registre officiel IA et agents

Grounded, safety-checked appliance operation packages for robots and agents. Zero-config trial.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package operandi-mcp
Claude Code 
claude mcp add operandi -e 'OPERANDI_API_URL=https://api.operandi.cc' -e 'OPERANDI_API_KEY=<your operandi_api_key>' -- uvx operandi-mcp==1.0.3
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "operandi": {
            "command": "uvx",
            "args": [
                "operandi-mcp==1.0.3"
            ],
            "env": {
                "OPERANDI_API_URL": "https://api.operandi.cc",
                "OPERANDI_API_KEY": "<your operandi_api_key>"
            }
        }
    }
}

Variables d'environnement

  • OPERANDI_API_URL Base URL of the OPERANDI API (default https://api.operandi.cc; use your hosted URL in prod).
  • OPERANDI_API_KEY secret Optional: your OPERANDI key. Leave unset for a zero-config instant trial (the server mints + caches its own key, 2 packages included).

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. OPERANDI MCP Server — operate real appliances from any agent
  2. Tools
  3. Why an agent wants this
  4. Setup — zero config
  5. Notes

OPERANDI MCP Server — operate real appliances from any agent

mcp-name: cc.operandi/operandi

operandi_mcp_server.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

ToolWhat it does
identify_applianceResolve observed nameplate text / panel labels / model → a catalog object (call first).
get_operation_packageThe robot-executable package: model-exact procedures, control map + grounding, per-step verification signals, recovery state machine, safety envelope.
list_appliancesBrowse operable appliances (optionally by category).
find_by_capabilityFind appliances by function (heat / wash / brew / defrost …).

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-mcp

That'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": {"OPERANDI_API_KEY": "ok_live_..."} 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 identify_appliance then get_operation_package and answer from grounded data.

Notes

  • The server is a thin, API-key-authenticated REST client — the same binary works against local dev or the hosted service by changing OPERANDI_API_URL.
  • Auth is Authorization: Bearer <key>; 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: pytest tests/test_mcp_server.py.

Questions fréquentes

Qu'est-ce que cc.operandi/operandi ?

Grounded, safety-checked appliance operation packages for robots and agents. Zero-config trial.

Comment installer cc.operandi/operandi ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add operandi -e 'OPERANDI_API_URL=https://api.operandi.cc' -e 'OPERANDI_API_KEY=<your operandi_api_key>' -- uvx operandi-mcp==1.0.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour cc.operandi/operandi ?

Oui. Il attend OPERANDI_API_KEY, à renseigner dans sa configuration.

cc.operandi/operandi est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient cc.operandi/operandi ?

Il est publié par ArchieAngelBeWithUs-prog. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.