Qiskit MCP Server
by qiskitcommunityv0.2.0
28
13
An MCP server that transpiles and analyzes quantum circuits using Qiskit pass managers. It accepts OpenQASM 2/3 or QPY input, supports preset hardware topologies and basis gates, and returns optimized circuits plus comparison metrics.
From the registry: MCP server for Qiskit quantum computing with circuit serialization utilities
Install & configure
Prerequisites
- requiredInstall Python 3.10 or higherPython 3.10+ is required to run the server.
- requiredInstall the package from PyPIInstall the published qiskit-mcp-server package so the qiskit-mcp-server command is available.
$ pip install qiskit-mcp-server
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `qiskit-mcp-server` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Python 3.10 or higher** — Python 3.10+ is required to run the server.
- **Install the package from PyPI** — Install the published qiskit-mcp-server package so the qiskit-mcp-server command is available. Run: `pip install qiskit-mcp-server`
Canonical MCP server config (stdio transport):
- command: `qiskit-mcp-server`
- args: []
- optional environment variables:
- `QISKIT_MCP_MAX_QUBITS`: Optional override for the maximum number of qubits allowed per circuit. (example: `<max-qubits>`)
- `QISKIT_MCP_MAX_GATES`: Optional override for the maximum number of gates allowed per circuit. (example: `<max-gates>`)
Note: Prefer the PyPI install path over running from a checked-out repository. The README also shows a local uv-based source workflow, but the simplest portable MCP config is to run the installed qiskit-mcp-server executable over stdio.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Prefer the PyPI install path over running from a checked-out repository. The README also shows a local uv-based source workflow, but the simplest portable MCP config is to run the installed qiskit-mcp-server executable over stdio.
Tools (7)
transpile_circuit_tool
Transpile a circuit with configurable optimization settings.
analyze_circuit_tool
Analyze circuit structure and complexity without transpiling.
compare_optimization_levels_tool
Compare transpilation results across optimization levels 0-3.
load_circuit_from_qasm_tool
Load an OpenQASM 2.0 or 3.0 string and return QPY plus metadata.
export_circuit_to_qasm_tool
Export a QPY circuit to OpenQASM 2.0 or 3.0 format.
convert_qpy_to_qasm3_tool
Convert a base64-encoded QPY circuit to QASM3.
convert_qasm3_to_qpy_tool
Convert a QASM3 or QASM2 circuit to base64-encoded QPY.
Environment variables
QISKIT_MCP_MAX_QUBITSrequiredOverrides the maximum number of qubits allowed for circuit input.QISKIT_MCP_MAX_GATESrequiredOverrides the maximum number of gates allowed for circuit input.Prerequisites
- • Python 3.10
Packages
qiskit-mcp-server
pypiv0.2.0transport: stdio
Details
- Language
- Python
- License
- Apache-2.0
- Released
- Mar 13, 2026
- Last commit
- Apr 22, 2026
- Registry name
- io.github.Qiskit/qiskit-mcp-server