openquantum-mcp

Model Context Protocol (MCP) server for Open Quantum.

Any MCP-compatible client (Claude, Cursor, VS Code, Grok, and others) can discover backends, submit quantum jobs, wait for completion, and summarize results using your Open Quantum SDK credentials.

One stdio server, standard MCP tools — nothing client-specific in the package.

Docs: docs.openquantum.com/mcp

Install

pip install openquantum-sdk openquantum-mcp

Requires Python 3.10+. openquantum-mcp depends on openquantum-sdk and installs it if needed:

pip install openquantum-mcp

Verify without starting the stdio server:

python -c "import openquantum_mcp; print(openquantum_mcp.__version__)"
python -m openquantum_mcp --version
python -m openquantum_mcp --help

Authentication

Use the same SDK key credentials as the Core SDK (portal SDK keys):

If OPENQUANTUM_SDK_KEY is set but the file is missing, startup/auth fails with a clear path error (no silent fallback).

Optional configuration:

Run

export OPENQUANTUM_CLIENT_ID=...
export OPENQUANTUM_CLIENT_SECRET=...
python -m openquantum_mcp
# or
openquantum-mcp

MCP client configuration

Point your client at a Python environment where openquantum-mcp is installed, and pass credentials in the server env. Exact config file locations differ by host; the process definition is the same:

{
  "mcpServers": {
    "openquantum": {
      "command": "python",
      "args": ["-m", "openquantum_mcp"],
      "env": {
        "OPENQUANTUM_CLIENT_ID": "...",
        "OPENQUANTUM_CLIENT_SECRET": "..."
      }
    }
  }
}

Prefer an absolute path to python if the client does not inherit your shell PATH (for example, /path/to/venv/bin/python).

Tools

prepare_job / submit_job accept execution_plan (auto / public / private / UUID) and queue_priority (auto / standard / priority / instant / UUID). Auto plan selection prefers Public so Spark can apply. Quotes include quote_summary with per-priority pricing.

Security: file_path is read by the MCP process and uploaded; prefer qasm strings when possible and least-privilege process accounts.

Spend policy

1. Estimated cost greater than 10 credits (configurable) → rejected.
2. Cost 0 → allowed.
3. Public plan and Spark ≥ cost → auto-approved.
4. Spend that would use Full credits → requires confirm_spend=true.

Default job subcategory: oth:oth. Jobs are tagged submitted_with=mcp.

Example agent flow

1. list_backends / get_credits
2. prepare_job with OpenQASM → review quote
3. submit_job (with confirm_spend=true when required)
4. wait_for_job (re-call if still queued; QPU queues can be long)
5. get_job_results
6. get_job_calibration only if needed

License

Apache-2.0