Qiskit MCP Server

A Model Context Protocol (MCP) server that provides quantum circuit transpilation capabilities using Qiskit's pass managers. This server enables AI assistants to optimize quantum circuits for various hardware targets. Its 7 documented tools cover tool, circuit, qasm, qpy.

People who work with tool, circuit and qasm and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

One of 5 MCP servers published from qiskit/mcp-servers. Stars and repository activity are shared across all of them. See all 5 →

VERIFIED ACTIVE

LAST COMMIT 2026-07-13 · VERIFIED 2026-09-18

Apache-2.0 · Python servers · how we verify → /methodology

01 · Install Qiskit MCP Server

before you install - you'll need

Set QISKIT_MCP_MAX_QUBITS, QISKIT_MCP_MAX_GATES before connecting.

Claude Code

claude mcp add qiskit-mcp-servers-qiskit-mcp-server -- uvx qiskit-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "qiskit-mcp-servers-qiskit-mcp-server": {
      "command": "uvx",
      "args": [
        "qiskit-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

pypi package qiskit-mcp-server - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.Qiskit is GitHub-verified and matches the repo owner

03 · What Qiskit MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can analyze circuit structure without transpiling, compare all optimization levels (0-3), load a circuit from OpenQASM 2.0 or 3.0 string, returning QPY and metadata, and export a QPY circuit to OpenQASM 2.0 or 3.0 format.

Capability map

Tools grouped from the project's README - what Qiskit MCP Server lets an agent do.

Convert

2 tools - e.g. Convert a base64-encoded QPY circuit to QASM3; Convert a QASM3 (or QASM2) circuit to base64-encoded QPY

convert_qpy_to_qasm3_tool · convert_qasm3_to_qpy_tool

Transpile

1 tool - e.g. Transpile a circuit with configurable optimization

transpile_circuit_tool

Analyze

1 tool - e.g. Analyze circuit structure without transpiling

analyze_circuit_tool

Compare

1 tool - e.g. Compare all optimization levels (0-3)

compare_optimization_levels_tool

Load

1 tool - e.g. Load a circuit from OpenQASM 2.0 or 3.0 string, returning QPY and metadata

load_circuit_from_qasm_tool

Export

1 tool - e.g. Export a QPY circuit to OpenQASM 2.0 or 3.0 format

export_circuit_to_qasm_tool

Latest releases

meta-v0.12.0 · 2026-07-13

Add top_k and snippets options for search_docs_tool · upgrade fastmcp to >=3.2.0 to resolve CVE-2026-32871 (CVSS 10.0) · Add backward compatibility for search_docs_tool tool · New Contributors · @eltonjohnfanboy made…

docs-v0.3.0 · 2026-07-13

Add top_k and snippets options for search_docs_tool · upgrade fastmcp to >=3.2.0 to resolve CVE-2026-32871 (CVSS 10.0) · Add backward compatibility for search_docs_tool tool · New Contributors · @eltonjohnfanboy made…

gym-v0.4.1 · 2026-07-13

upgrade fastmcp to >=3.2.0 to resolve CVE-2026-32871 (CVSS 10.0)

04 · Who maintains Qiskit MCP Server

Qiskit MCP Server is maintained by qiskit. We track 6 MCP servers from qiskit - 6 actively maintained, 39 combined GitHub stars, oldest repo from Sep 2025. Full record: all servers from qiskit.

  1. Qiskit IBM Runtime MCP Server MCP server for IBM Quantum computing services through Qiskit IBM Runtime ★ 39
  2. Qiskit Documentation MCP Server MCP server for querying and retrieving Qiskit documentation, guides, and API references ★ 39
  3. Qiskit Gym MCP Server MCP server for qiskit-gym reinforcement learning quantum circuit synthesis ★ 39
  4. Qiskit IBM Transpiler MCP Server MCP server for AI Transpiler IBM Quantum services ★ 39

05 · Facts

repository
github.com/qiskit/mcp-servers
website
https://github.com/Qiskit/mcp-servers/tree/main/qiskit-mcp-server
category
other - actively maintained as of 2026-09-18.
registry
io.github.Qiskit/qiskit-mcp-server (active, first published 2026-02-04 · 5 versions)
packages
pypi:qiskit-mcp-server

06 · Qiskit MCP Server FAQ

Is Qiskit MCP Server still maintained?

Yes - as of 2026-09-18, its last commit was 2026-07-13. We re-verify nightly.

What can Qiskit MCP Server do?

With this server connected, an agent can analyze circuit structure without transpiling, compare all optimization levels (0-3), load a circuit from OpenQASM 2.0 or 3.0 string, returning QPY and metadata, and export a QPY circuit to OpenQASM 2.0 or 3.0 format.

How do I install Qiskit MCP Server?

Run `uvx qiskit-mcp-server`. The README documents 2 environment variables (QISKIT_MCP_MAX_QUBITS, QISKIT_MCP_MAX_GATES) to set first. Set QISKIT_MCP_MAX_QUBITS, QISKIT_MCP_MAX_GATES before connecting. You can also paste the ready-made client config above.

Does Qiskit MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Qiskit MCP Server

Alternatives to Qiskit MCP Server

Maintained other servers if Qiskit MCP Server isn't the fit.

  1. Heyputer MCP Server Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more ★ 43,552 · 2026-09-17
  2. Server Commands An MCP server to run arbitrary commands ★ 39,038 · 2026-09-11
  3. basebalance.cloud - x402 RPC & MCP gateway USDC-gated Base JSON-RPC: free 10 req/min, $0.50 per 10k. Failover, cache, /mcp, ledger. ★ 6,432 · 2026-08-26
  4. Zotero MCP (54yyyu) Search, read, annotate, and add to your Zotero research library, local or web. ★ 5,069 · 2026-09-15
  5. Firebase MCP Gives AI development tools Firebase-specific capabilities and expertise. ★ 4,470 · 2026-09-18
  6. Microsoft Fabric MCP Server MCP tools for interacting with Microsoft Fabric ★ 3,681 · 2026-09-17

More MCP servers to compare · Interminal · Server Template · Wemo · Quicknode MCP Server · OCDS German Procurement Search

More Python MCP servers · Adif MCP · Qrz MCP · Solar MCP · see all