# Quantum OpenQASM MCP **Category:** ๐Ÿ’ป Developer Tools **Repository:** https://github.com/markusvankempen/quantum-openqasm-assistant **Views:** 1 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/quantum-openqasm-mcp ## Description IBM Quantum OpenQASM 2.0 MCP โ€” list backends, submit QASM, poll jobs, get histograms. ## Claude Desktop Quick Installation Heuristic fallback โ€” verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low): ```json "mcpServers": { "quantum-openqasm-mcp": { "command": "npx", "args": ["-y","quantum-openqasm-mcp"] } } ``` ## Documentation & README # Quantum OpenQASM Assistant [![VS Code Extension](https://img.shields.io/badge/VS%20Code-Extension-007ACC?logo=visualstudiocode&logoColor=white)](https://marketplace.visualstudio.com/items?itemName=markusvankempen.quantum-openqasm-assistant) [![npm MCP](https://img.shields.io/npm/v/@markusvankempen/quantum-openqasm-mcp.svg?label=npm%20MCP)](https://www.npmjs.com/package/@markusvankempen/quantum-openqasm-mcp) [![GitHub release](https://img.shields.io/github/v/release/markusvankempen/quantum-openqasm-assistant?label=release)](https://github.com/markusvankempen/quantum-openqasm-assistant/releases) [![Qiskit Ecosystem](https://qisk.it/e-bd91d04b)](https://qisk.it/e) [![OpenQASM](https://img.shields.io/badge/OpenQASM-2.0-512BD4)](https://openqasm.com/) [![MCP](https://img.shields.io/badge/MCP-Model%20Context%20Protocol-00A67E)](https://modelcontextprotocol.io/) [![IBM Quantum](https://img.shields.io/badge/IBM-Quantum-0f62fe)](https://quantum.ibm.com/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)

Quantum OpenQASM Assistant โ€” atomic icon with cyan nucleus and purple orbits

> **Quantum OpenQASM Assistant** is a **VS Code extension** and **Model Context Protocol (MCP) server** for **IBM Quantum** โ€” submit **OpenQASM 2.0** circuits to real **quantum hardware** and simulators from **Cursor**, **VS Code**, **IBM Bob**, and **Google Antigravity**. Includes **Quantum Lab** (interactive circuit editor), live **job polling**, measurement **histograms**, **Bell state** / **GHZ** examples, **SamplerV2** REST integration, and one-click **MCP setup** for AI coding assistants. **Search terms:** `quantum computing` ยท `openqasm` ยท `qasm` ยท `ibm quantum` ยท `qiskit` ยท `quantum circuit` ยท `quantum hardware` ยท `mcp server` ยท `model context protocol` ยท `cursor mcp` ยท `vscode quantum` ยท `ai quantum assistant` ยท `quantum programming` ยท `qubit` ยท `bell state` **Author:** Markus van Kempen **Email:** [markus.van.kempen@gmail.com](mailto:markus.van.kempen@gmail.com) ยท [mvk@ca.ibm.com](mailto:mvk@ca.ibm.com) **Website:** [markusvankempen.github.io](https://markusvankempen.github.io/) *No bug too small, no syntax too weird.* --- ## Overview Quantum OpenQASM Assistant connects AI agents and developers to **IBM Quantum** through a pure TypeScript MCP server and VS Code extension. Submit OpenQASM 2.0 ISA circuits, poll job status, and view measurement histograms โ€” locally via stdio or remotely via SSE on IBM Code Engine. | Product | Identifier | Version | |---------|------------|---------| | **VS Code Extension** | [`markusvankempen.quantum-openqasm-assistant`](https://marketplace.visualstudio.com/items?itemName=markusvankempen.quantum-openqasm-assistant) | **1.9.2** | | **NPM MCP Server** | [`@markusvankempen/quantum-openqasm-mcp`](https://www.npmjs.com/package/@markusvankempen/quantum-openqasm-mcp) | **1.9.2** | | **MCP Registry** | [`io.github.markusvankempen/quantum-openqasm-mcp`](https://registry.modelcontextprotocol.io/servers/io.github.markusvankempen/quantum-openqasm-mcp) | **1.9.2** | | **Public repo** | [quantum-openqasm-assistant](https://github.com/markusvankempen/quantum-openqasm-assistant) | tag `v1.9.2` โ€” docs & deployment guides only | > **Source code** is maintained in the private dev repo [`quantum-openqasm-assistant-dev`](https://github.com/markusvankempen/quantum-openqasm-assistant-dev). Install the product via [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=markusvankempen.quantum-openqasm-assistant) or [npm MCP](https://www.npmjs.com/package/@markusvankempen/quantum-openqasm-mcp) โ€” not by cloning this repo for extension source. ```mermaid graph TB subgraph clients [MCP Clients] Cursor[Cursor / VS Code] Bob[IBM Bob] AG[Antigravity] Lab[Quantum Lab Extension] end subgraph mcp [MCP Server] Local["server.ts stdio"] Remote["server-sse.ts SSE"] end IBM["IBM Quantum REST API
SamplerV2 ยท OpenQASM 2.0"] Cursor -->|stdio| Local Bob -->|stdio| Local AG -->|stdio| Local Lab -->|stdio or SSE| Local Lab -->|SSE| Remote Local --> IBM Remote --> IBM ``` ```mermaid sequenceDiagram participant User participant Ext as VS Code Extension participant MCP as MCP Server participant IBM as IBM Quantum API User->>Ext: Submit .qasm circuit Ext->>MCP: submit_qasm_job MCP->>IBM: POST /jobs (SamplerV2) IBM-->>MCP: job id MCP-->>Ext: job id loop Poll every 15s Ext->>MCP: get_job_status MCP->>IBM: GET /jobs/{id} IBM-->>Ext: Queued โ†’ Running โ†’ Completed end Ext->>MCP: get_job_results MCP->>IBM: GET /jobs/{id}/results IBM-->>Ext: measurement histogram ``` ๐Ÿ“– **[Documentation hub โ†’ docs/README.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/README.md)** ยท **[Project structure โ†’ docs/PROJECT-STRUCTURE.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/PROJECT-STRUCTURE.md)** ยท **[OpenQASM Primer โ†’ docs/OPENQASM-PRIMER.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/OPENQASM-PRIMER.md)** ยท **[Tips & Tricks โ†’ docs/TIPS-AND-TRICKS.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/TIPS-AND-TRICKS.md)** ยท **[Architecture โ†’ docs/ARCHITECTURE.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/ARCHITECTURE.md)** ยท **[Local MCP setup โ†’ docs/ide/LOCAL-MCP-SETUP.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/ide/LOCAL-MCP-SETUP.md)** ยท **[Qiskit Developer Pack โ†’ docs/ide/QISKIT-DEVELOPER-PACK.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/ide/QISKIT-DEVELOPER-PACK.md)** ยท **[Deployment โ†’ docs/deployments/DEPLOYMENT-SCENARIOS.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/deployments/DEPLOYMENT-SCENARIOS.md)** ยท **[Extension โ†’ extension/README.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/extension/README.md)** ยท **[Contributing โ†’ CONTRIBUTING.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/CONTRIBUTING.md)** > **Repository policy:** This public GitHub repo publishes overview and setup documentation. Extension **source code**, scripts, and examples live in the **private dev repo** (use `.gitignore.private` when setting it up). --- ## Features | Feature | Description | |---------|-------------| | **Quantum Lab** | Interactive OpenQASM panel with example circuits and histogram results | | **Qiskit Lab** | Dedicated Qiskit Python panel โ€” 12 templates, Aer sim, export to OpenQASM | | **AI Transpilation** | `qiskit-ibm-transpiler` integration for hardware-native circuit optimization | | **OpenQASM 2.0** | IBM hardware ISA format (`rz`, `sx`, `cz` native gates) | | **MCP tools** | `list_backends`, `submit_qasm_job`, `get_job_status`, `get_job_results`, and more | | **Multi-IDE MCP** | One-click setup for Cursor, VS Code, Bob, Antigravity & Claude Desktop | | **Qiskit Developer Pack** | Bundle Qiskit MCP servers + quantum-openqasm-mcp from Diagnostics | | **Local / remote** | stdio MCP locally or SSE via IBM Code Engine | | **Diagnostics** | Test IAM auth, list backends, save credentials from the UI | --- ## MCP tools | Tool | Description | |------|-------------| | `list_backends` | Available IBM Quantum backends, status, queue | | `get_backend` | Details for a specific backend | | `submit_qasm_job` | Submit OpenQASM 2.0 circuit | | `get_job_status` | Poll job state | | `get_job_results` | Measurement counts / histogram data | | `cancel_job` | Cancel a running job | --- ## Quick start ### Prerequisites - Node.js 18+ ([mise](https://mise.jdx.dev/) recommended โ€” see `mise.toml`) - IBM Cloud API key + Quantum Service CRN โ€” [cloud.ibm.com/iam/apikeys](https://cloud.ibm.com/iam/apikeys) ### Build (private dev repo) ```bash mise run install mise run build ``` ### Configure ```bash cp .env.example .env # IBM_API_KEY, IBM_SERVICE_CRN, IBM_QUANTUM_ENDPOINT, IBM_QUANTUM_BACKEND ``` Or use **Quantum โ†’ Settings & Diagnostics** in the extension. ### Test ```bash mise run test-e2e # or: Press F5 in VS Code โ†’ Quantum Lab โ†’ Run on Hardware ``` ### Install extension ```bash mise run package code --install-extension extension/quantum-openqasm-assistant-*.vsix ``` --- ## Architecture at a glance ``` quantum-openqasm-assistant/ โ”œโ”€โ”€ extension/ # VS Code extension + bundled MCP server โ”‚ โ”œโ”€โ”€ src/extension.ts # Extension entry, MCP client โ”‚ โ”œโ”€โ”€ src/server.ts # Local stdio MCP server โ”‚ โ”œโ”€โ”€ src/server-sse.ts # Remote SSE MCP server โ”‚ โ””โ”€โ”€ out/ # esbuild output โ”œโ”€โ”€ packages/ โ”‚ โ””โ”€โ”€ quantum-openqasm-mcp/ # Standalone npm MCP package โ”œโ”€โ”€ scripts/ # MCP launcher, e2e tests, examples โ”œโ”€โ”€ docs/ # Published documentation โ”‚ โ””โ”€โ”€ QISKIT-INTEGRATION.md # Qiskit โ†’ OpenQASM โ†’ IBM Quantum โ”œโ”€โ”€ examples/ # Qiskit export script (public) โ”œโ”€โ”€ deployments/ # Client modes + infrastructure โ”‚ โ”œโ”€โ”€ README.md # Hub: 5 client modes + 6 infra scenarios โ”‚ โ”œโ”€โ”€ extension-only/ # Mode 1 โ”‚ โ”œโ”€โ”€ extension-mcp-local/# Mode 2 โ”‚ โ”œโ”€โ”€ mcp-npm/ # Mode 3 โ”‚ โ”œโ”€โ”€ extension-remote-mcp/# Mode 4 โ”‚ โ”œโ”€โ”€ mcp-remote-sse/ # Mode 5 โ”‚ โ”œโ”€โ”€ code-engine/ # IBM Code Engine โ”‚ โ”œโ”€โ”€ local-bridge/ # Dev gateway โ”‚ โ”œโ”€โ”€ docker-sse/ # Self-hosted โ”‚ โ”œโ”€โ”€ secured-remote/ # Auth tiers โ”‚ โ”œโ”€โ”€ wxo-orchestrate/ # Orchestrate agents โ”‚ โ””โ”€โ”€ ci-cd/ # Pipeline smoke tests โ””โ”€โ”€ Internal/ # Branding, publishing, status (gitignored) ``` See **[docs/PROJECT-STRUCTURE.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/PROJECT-STRUCTURE.md)** for the complete file map. --- ## Documentation | Guide | Description | |-------|-------------| | [Documentation hub](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/README.md) | Index of all published guides | | [Architecture](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/ARCHITECTURE.md) | System design, MCP, IBM API flow | | [OpenQASM Primer](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/OPENQASM-PRIMER.md) | Learn OpenQASM 2.0 in plain English | | [Qiskit integration](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/QISKIT-INTEGRATION.md) | Qiskit โ†’ export QASM โ†’ IBM hardware via MCP / Lab | | [Tips & Tricks](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/TIPS-AND-TRICKS.md) | Backend selection, MCP workflows | | [Project structure](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/PROJECT-STRUCTURE.md) | Complete repo layout | | [Extension README](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/extension/README.md) | VS Code extension features, commands | | [Local MCP setup](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/ide/LOCAL-MCP-SETUP.md) | Cursor, VS Code, Bob, Antigravity | | [Deployment hub](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/deployments/README.md) | 5 client modes + infra (CE, Docker, WxO, CI) | | [Deployment scenarios](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/deployments/DEPLOYMENT-SCENARIOS.md) | Local, Code Engine, Docker, hybrid | --- ## Qiskit Integration Design circuits in **Qiskit** (or the built-in **Qiskit Lab** panel), export to **OpenQASM 2.0**, transpile with **AI-powered `qiskit-ibm-transpiler`**, and run on IBM Quantum hardware: ```python from qiskit import QuantumCircuit, qasm2 qc = QuantumCircuit(2, 2) qc.h(0) qc.cx(0, 1) qc.measure([0, 1], [0, 1]) print(qasm2.dumps(qc)) # โ†’ submit via MCP or paste into Quantum Lab ``` ```text OPENQASM 2.0; include "qelib1.inc"; qreg q[2]; creg c[2]; h q[0]; cx q[0],q[1]; measure q[0] -> c[0]; measure q[1] -> c[1]; ``` **No Qiskit dependency at runtime** โ€” the MCP server speaks OpenQASM + IBM Quantum REST directly. **v1.9.2 Qiskit features:** - **Qiskit Lab** โ€” 12 templates (Bell, GHZ, Grover, teleportation, VQE ansatz, QAOA, โ€ฆ), local Aer sim, one-click export - **AI transpilation** โ€” `qiskit-ibm-transpiler` MCP integration for hardware-native optimization - **`quantum-assistant` MCP** โ€” streamlined MCP key for AI IDE setup - Full guide: [docs/QISKIT-INTEGRATION.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/QISKIT-INTEGRATION.md) - **Qiskit Developer Pack** (Qiskit MCP + AI transpiler + OpenQASM): [docs/ide/QISKIT-DEVELOPER-PACK.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/docs/ide/QISKIT-DEVELOPER-PACK.md) - Example script: [examples/qiskit-bell-export.py](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/examples/qiskit-bell-export.py) --- ## Security - API keys live in VS Code settings or `~/.quantum-openqasm-mcp/.env` โ€” never in git - `.env`, `Internal/`, and IDE `mcp.json` files are gitignored - Report issues via [GitHub Issues](https://github.com/markusvankempen/quantum-openqasm-assistant/issues) --- ## Contributing Contributions welcome! See **[CONTRIBUTING.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/CONTRIBUTING.md)** for the two-repo model, mise tasks, and PR process. Please read our **[CODE_OF_CONDUCT.md](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/CODE_OF_CONDUCT.md)**. --- ## License [Apache License 2.0](https://github.com/markusvankempen/quantum-openqasm-assistant/blob/HEAD/LICENSE) --- ## Topics & keywords `quantum-computing` ยท `quantum-computer` ยท `openqasm` ยท `openqasm-2` ยท `qasm` ยท `ibm-quantum` ยท `ibm-cloud` ยท `qiskit` ยท `quantum-circuit` ยท `quantum-hardware` ยท `quantum-lab` ยท `quantum-programming` ยท `quantum-physics` ยท `qubit` ยท `bell-state` ยท `quantum-job` ยท `quantum-backend` ยท `mcp` ยท `model-context-protocol` ยท `mcp-server` ยท `vscode-extension` ยท `cursor` ยท `ibm-bob` ยท `antigravity` ยท `copilot` ยท `ai-assistant` ยท `typescript` ยท `nodejs` ยท `histogram` ยท `sampler-v2` ยท `code-engine` ยท `cloud-quantum` --- **Author:** Markus van Kempen **Email:** [markus.van.kempen@gmail.com](mailto:markus.van.kempen@gmail.com) ยท [mvk@ca.ibm.com](mailto:mvk@ca.ibm.com) **Website:** [markusvankempen.github.io](https://markusvankempen.github.io/) *No bug too small, no syntax too weird.*