Quantum OpenQASM MCP

IBM Quantum OpenQASM 2.0 MCP — list backends, submit QASM, poll jobs, get histograms.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "quantum-openqasm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "quantum-openqasm-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

Quantum OpenQASM Assistant

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 · mvk@ca.ibm.com
Website: 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`	1.9.2
NPM MCP Server	`@markusvankempen/quantum-openqasm-mcp`	1.9.2
MCP Registry	`io.github.markusvankempen/quantum-openqasm-mcp`	1.9.2
Public repo	quantum-openqasm-assistant	tag `v1.9.2` — docs & deployment guides only

Source code is maintained in the private dev repo quantum-openqasm-assistant-dev. Install the product via VS Code Marketplace or npm 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<br/>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 · Project structure → docs/PROJECT-STRUCTURE.md · OpenQASM Primer → docs/OPENQASM-PRIMER.md · Tips & Tricks → docs/TIPS-AND-TRICKS.md · Architecture → docs/ARCHITECTURE.md · Local MCP setup → docs/ide/LOCAL-MCP-SETUP.md · Qiskit Developer Pack → docs/ide/QISKIT-DEVELOPER-PACK.md · Deployment → docs/deployments/DEPLOYMENT-SCENARIOS.md · Extension → extension/README.md · Contributing → 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 recommended — see mise.toml)
IBM Cloud API key + Quantum Service CRN — 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

server.ts

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 for the complete file map.

Documentation

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Quantum OpenQASM MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "quantum-openqasm-mcp": { "command": "npx", "args": ["-y", "Quantum OpenQASM MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Quantum OpenQASM MCP AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/quantum-openqasm-mcp?style=directory)](https://allmcps.com/mcp/quantum-openqasm-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/quantum-openqasm-mcp"><img src="https://allmcps.com/api/badge/quantum-openqasm-mcp?style=directory" alt="Quantum OpenQASM MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Quantum OpenQASM MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Quantum OpenQASM MCP

IBM Quantum OpenQASM 2.0 MCP — list backends, submit QASM, poll jobs, get histograms.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "quantum-openqasm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "quantum-openqasm-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

Quantum OpenQASM Assistant

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.

Author: Markus van Kempen
Email: markus.van.kempen@gmail.com · mvk@ca.ibm.com
Website: markusvankempen.github.io
No bug too small, no syntax too weird.

Overview

Product	Identifier	Version
VS Code Extension	`markusvankempen.quantum-openqasm-assistant`	1.9.2
NPM MCP Server	`@markusvankempen/quantum-openqasm-mcp`	1.9.2
MCP Registry	`io.github.markusvankempen/quantum-openqasm-mcp`	1.9.2
Public repo	quantum-openqasm-assistant	tag `v1.9.2` — docs & deployment guides only

Source code is maintained in the private dev repo quantum-openqasm-assistant-dev. Install the product via VS Code Marketplace or npm 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<br/>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

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 recommended — see mise.toml)
IBM Cloud API key + Quantum Service CRN — 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

server.ts

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 for the complete file map.

Documentation

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Quantum OpenQASM MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "quantum-openqasm-mcp": { "command": "npx", "args": ["-y", "Quantum OpenQASM MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/quantum-openqasm-mcp?style=directory)](https://allmcps.com/mcp/quantum-openqasm-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/quantum-openqasm-mcp"><img src="https://allmcps.com/api/badge/quantum-openqasm-mcp?style=directory" alt="Quantum OpenQASM MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Quantum OpenQASM MCP →Install in Claude Desktop Install in Cursor Install in VS Code