{
"markdown": "# Qiskit MCP Servers\n\n[](https://github.com/Qiskit/mcp-servers/actions/workflows/test.yml)\n[](https://opensource.org/licenses/Apache-2.0)\n[](https://www.python.org/downloads/)\n[](https://github.com/astral-sh/ruff)\n[](http://mypy-lang.org/)\n\n[](https://registry.modelcontextprotocol.io/?q=io.github.Qiskit%2Fqiskit-mcp-server)\n[](https://registry.modelcontextprotocol.io/?q=io.github.Qiskit%2Fqiskit-ibm-runtime-mcp-server)\n[](https://registry.modelcontextprotocol.io/?q=io.github.Qiskit%2Fqiskit-ibm-transpiler-mcp-server)\n[](https://registry.modelcontextprotocol.io/?q=io.github.Qiskit%2Fqiskit-docs-mcp-server)\n[](https://registry.modelcontextprotocol.io/?q=io.github.Qiskit%2Fqiskit-gym-mcp-server)\n\nA collection of [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) servers that give AI assistants, LLMs, and agents seamless access to IBM Quantum services and Qiskit libraries. Generate quantum code, connect to real hardware, analyze backends, execute circuits, and search Qiskit documentation — all through a standardized protocol that works with any MCP-compatible client.\n\n## Quick Start\n\n### Prerequisites\n\n- **Python 3.10+** (3.11+ recommended)\n- **IBM Quantum account** and [API token](https://quantum.ibm.com) (only required for IBM cloud servers: Runtime, Transpiler)\n\n### Install from PyPI\n\n```bash\n# Install all servers (core + community)\npip install \"qiskit-mcp-servers[all]\"\n\n# Install core servers only (default, excludes community)\npip install qiskit-mcp-servers\n```\n\n\nInstall individual servers
\n\n```bash\npip install \"qiskit-mcp-servers[qiskit]\" # Qiskit server only\npip install \"qiskit-mcp-servers[runtime]\" # IBM Runtime server only\npip install \"qiskit-mcp-servers[transpiler]\" # IBM Transpiler server only\npip install \"qiskit-mcp-servers[docs]\" # Documentation server only\npip install \"qiskit-mcp-servers[gym]\" # Qiskit Gym server only (community)\n```\n\n \n\n### Install from Source\n\nEach server runs independently — the directory name and command are the same:\n\n```bash\ncd qiskit-mcp-server # or any server directory\npip install -e .\nqiskit-mcp-server\n```\n\n### Configuration\n\nServers that connect to IBM Quantum cloud services require a `QISKIT_IBM_TOKEN` environment variable. See each server's README for the full list of environment variables and configuration options.\n\n```bash\nexport QISKIT_IBM_TOKEN=\"your_ibm_quantum_token_here\"\n```\n\n### Client Setup\n\nAll servers are compatible with any MCP client. Pick your client below.\n\n#### Claude Code\n\n[](https://github.com/user-attachments/assets/161797b0-59d9-4632-bafa-12d50bfef226)\n\n```bash\n# No auth required\nclaude mcp add qiskit -- uvx qiskit-mcp-server\nclaude mcp add qiskit-docs -- uvx qiskit-docs-mcp-server\nclaude mcp add qiskit-gym -- uvx qiskit-gym-mcp-server\n\n# Require QISKIT_IBM_TOKEN (https://quantum.ibm.com)\nclaude mcp add qiskit-ibm-runtime -e QISKIT_IBM_TOKEN=$QISKIT_IBM_TOKEN -- uvx qiskit-ibm-runtime-mcp-server\nclaude mcp add qiskit-ibm-transpiler -e QISKIT_IBM_TOKEN=$QISKIT_IBM_TOKEN -- uvx qiskit-ibm-transpiler-mcp-server\n```\n\n#### IBM Bob\n\n[](https://github.com/user-attachments/assets/b1e9cfc4-c729-4050-9998-815f6b63bacd)\n\nAdd to your `~/.bob/settings/mcp_settings.json`:\n\n```json\n{\n \"mcpServers\": {\n \"qiskit\": {\n \"command\": \"uvx\",\n \"args\": [\"qiskit-mcp-server\"],\n \"alwaysAllow\": [],\n \"disabled\": false\n },\n \"qiskit-docs\": {\n \"command\": \"uvx\",\n \"args\": [\"qiskit-docs-mcp-server\"],\n \"alwaysAllow\": [],\n \"disabled\": false\n },\n \"qiskit-gym\": {\n \"command\": \"uvx\",\n \"args\": [\"qiskit-gym-mcp-server\"],\n \"alwaysAllow\": [],\n \"disabled\": false\n },\n \"qiskit-ibm-runtime\": {\n \"command\": \"uvx\",\n \"args\": [\"qiskit-ibm-runtime-mcp-server\"],\n \"env\": {\n \"QISKIT_IBM_TOKEN\": \"\",\n \"QISKIT_IBM_RUNTIME_MCP_INSTANCE\": \"\"\n },\n \"alwaysAllow\": [],\n \"disabled\": false\n },\n \"qiskit-ibm-transpiler\": {\n \"command\": \"uvx\",\n \"args\": [\"qiskit-ibm-transpiler-mcp-server\"],\n \"env\": {\n \"QISKIT_IBM_TOKEN\": \"\"\n },\n \"alwaysAllow\": [],\n \"disabled\": false\n }\n }\n}\n```\n\n\nClaude Desktop / Cline
\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"qiskit\": {\n \"command\": \"uvx\",\n \"args\": [\"qiskit-mcp-server\"]\n },\n \"qiskit-docs\": {\n \"command\": \"uvx\",\n \"args\": [\"qiskit-docs-mcp-server\"]\n },\n \"qiskit-gym\": {\n \"command\": \"uvx\",\n \"args\": [\"qiskit-gym-mcp-server\"]\n },\n \"qiskit-ibm-runtime\": {\n \"command\": \"uvx\",\n \"args\": [\"qiskit-ibm-runtime-mcp-server\"],\n \"env\": {\n \"QISKIT_IBM_TOKEN\": \"your_ibm_quantum_token_here\"\n }\n },\n \"qiskit-ibm-transpiler\": {\n \"command\": \"uvx\",\n \"args\": [\"qiskit-ibm-transpiler-mcp-server\"],\n \"env\": {\n \"QISKIT_IBM_TOKEN\": \"your_ibm_quantum_token_here\"\n }\n }\n }\n}\n```\n\n \n\n\nMCP Inspector (interactive testing)
\n\n```bash\nnpx @modelcontextprotocol/inspector uvx qiskit-mcp-server\nnpx @modelcontextprotocol/inspector uvx qiskit-docs-mcp-server\nnpx @modelcontextprotocol/inspector uvx qiskit-ibm-runtime-mcp-server\n# etc.\n```\n\n \n\n## Available Servers\n\n### Core Servers\n\n| Server | Description | Directory |\n|--------|-------------|-----------|\n| **Qiskit MCP Server** | Circuit creation, transpilation, and serialization (QASM3, QPY) using [Qiskit](https://github.com/Qiskit/qiskit) | [`qiskit-mcp-server/`](./qiskit-mcp-server/) |\n| **Qiskit IBM Runtime** | Full access to IBM Quantum hardware via [Qiskit IBM Runtime](https://github.com/Qiskit/qiskit-ibm-runtime/) | [`qiskit-ibm-runtime-mcp-server/`](./qiskit-ibm-runtime-mcp-server/) |\n| **Qiskit IBM Transpiler** | AI-optimized circuit routing and optimization via [qiskit-ibm-transpiler](https://github.com/Qiskit/qiskit-ibm-transpiler) | [`qiskit-ibm-transpiler-mcp-server/`](./qiskit-ibm-transpiler-mcp-server/) |\n| **Qiskit Docs** | Search and retrieve [Qiskit documentation](https://quantum.cloud.ibm.com/docs/), guides, and API references. No auth required. | [`qiskit-docs-mcp-server/`](./qiskit-docs-mcp-server/) |\n\n### Community Servers\n\n| Server | Description | Directory |\n|--------|-------------|-----------|\n| **Qiskit Gym** | RL-based quantum circuit synthesis using [qiskit-gym](https://github.com/rl-institut/qiskit-gym) (permutation routing, linear functions, Clifford circuits) | [`qiskit-gym-mcp-server/`](./qiskit-gym-mcp-server/) |\n\n### Removed Servers\n\n- **Qiskit Code Assistant MCP Server** — previously published as `qiskit-code-assistant-mcp-server`. Removed because the underlying Qiskit Code Assistant service has been discontinued by IBM Quantum. See the [sunset announcement](https://quantum.cloud.ibm.com/announcements/en/product-updates/2026-04-28-qiskit-code-assistant-service-to-sunset). The PyPI package is archived and no longer maintained.\n\n## Examples\n\nEach server includes an `examples/` directory with a **Jupyter notebook** (`langchain_agent.ipynb`) and a **Python script** (`langchain_agent.py`) showing how to build AI agents with LangChain.\n\nThe root [`examples/`](./examples/) directory contains a multi-agent **Quantum Volume Finder** that orchestrates multiple MCP servers to find the highest achievable Quantum Volume on IBM Quantum hardware. See the [examples README](./examples/README.md) for details.\n\n## Architecture\n\nAll servers are built on [FastMCP](https://github.com/jlowin/fastmcp) and share a consistent structure:\n\n- **Async-first** — all tool and resource handlers are async, using FastMCP's native async support\n- **Standalone packages** — each server is an independent PyPI package with its own `pyproject.toml`, tests, and CI\n- **MCP Registry** — every server ships a [`server.json`](https://registry.modelcontextprotocol.io/) manifest for automatic discovery\n- **Unified meta-package** — `qiskit-mcp-servers` installs any combination via pip extras\n- **Full MCP protocol** — tools (quantum operations), resources (backend info, service status), and stdio transport\n\n## Development\n\n### Running Tests\n```bash\ncd qiskit-mcp-server # or any server directory\n./run_tests.sh\n```\n\n### Code Quality\n- **Linting**: `ruff check` and `ruff format`\n- **Type checking**: `mypy src/`\n- **Testing**: `pytest` with async support and coverage reporting\n- **CI/CD**: GitHub Actions for automated testing\n\n## Resources\n\n- [Model Context Protocol](https://modelcontextprotocol.io/introduction) — understanding MCP\n- [Qiskit IBM Runtime docs](https://quantum.cloud.ibm.com/docs/en/api/qiskit-ibm-runtime) — quantum cloud services\n- [MCP Inspector](https://github.com/modelcontextprotocol/inspector) — interactive testing tool\n- [FastMCP](https://github.com/jlowin/fastmcp) — high-performance MCP framework\n- [AGENTS.md](AGENTS.md) — guidance for AI coding assistants (IBM Bob, Claude Code, Copilot, Cursor, and others)\n\n## Contributing\n\nContributions are welcome! Please see the [CONTRIBUTING.md](CONTRIBUTING.md) guide for details.\n\n## License\n\nThis project is licensed under the **Apache License 2.0**.\n",
"bytes": 11494,
"sha": "4d892e0e52067337997974964902faba63c0b50b80c270ee4e223e43735db8ee",
"repo_slug": "qiskit/mcp-servers",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_qiskit_qiskit_ibm_transpiler_m_586e3168/readme"
}