A collection of Model Context Protocol (MCP) servers that provide AI assistants, LLMs, and agents with seamless access to IBM Quantum services and Qiskit libraries for quantum computing development and research.

This repository contains production-ready MCP servers that enable AI systems to interact with quantum computing resources through Qiskit. Instead of manually configuring quantum backends, writing boilerplate code, or managing IBM Quantum accounts, AI assistants can now:

• 🤖 Generate intelligent quantum code with context-aware suggestions
• 🔌 Connect to real quantum hardware automatically
• 📊 Analyze quantum backends and find optimal resources
• 🚀 Execute quantum circuits and monitor job status
• 💡 Provide quantum computing assistance with expert knowledge

Core Qiskit quantum computing capabilities

Provides quantum circuit creation, manipulation, transpilation, and serialization utilities (QASM3, QPY) for local quantum development using Qiskit

📁 Directory: ./qiskit-mcp-server/

Intelligent quantum code completion and assistance

Provides access to IBM's Qiskit Code Assistant for AI-assisted quantum programming

📁 Directory: ./qiskit-code-assistant-mcp-server/

Complete access to IBM Quantum cloud services

Comprehensive interface to IBM Quantum hardware via Qiskit IBM Runtime

📁 Directory: ./qiskit-ibm-runtime-mcp-server/

AI-powered circuit transpilation

Access to the qiskit-ibm-transpiler library for AI-optimized circuit routing and optimization.

📁 Directory: ./qiskit-ibm-transpiler-mcp-server/

• Python 3.10+ (3.11+ recommended)
• uv package manager (fastest Python package manager)
• IBM Quantum account and API token
• Qiskit Code Assistant access (for code assistant server)

# Install all MCP servers at once
pip install qiskit-mcp-servers

# Or install individual servers
pip install qiskit-mcp-server
pip install qiskit-code-assistant-mcp-server
pip install qiskit-ibm-runtime-mcp-server
pip install qiskit-ibm-transpiler-mcp-server

Each server is designed to run independently. Choose the server you need:

cd qiskit-mcp-server
uv run qiskit-mcp-server

cd qiskit-code-assistant-mcp-server
uv run qiskit-code-assistant-mcp-server

cd qiskit-ibm-runtime-mcp-server
uv run qiskit-ibm-runtime-mcp-server

cd qiskit-ibm-transpiler-mcp-server
uv run qiskit-ibm-transpiler-mcp-server

# For IBM Runtime Server
export QISKIT_IBM_TOKEN="your_ibm_quantum_token_here"

# For Code Assistant Server  
export QISKIT_IBM_TOKEN="your_ibm_quantum_token_here"
export QCA_TOOL_API_BASE="https://qiskit-code-assistant.quantum.ibm.com"

Both servers are compatible with any MCP client. Test interactively with MCP Inspector:

# Test Code Assistant Server
npx @modelcontextprotocol/inspector uv run qiskit-code-assistant-mcp-server

# Test IBM Runtime Server
npx @modelcontextprotocol/inspector uv run qiskit-ibm-runtime-mcp-server

Both servers follow a consistent, production-ready architecture:

• 🔄 Async-first: Built with FastMCP for high-performance async operations
• 🧪 Test-driven: Comprehensive test suites with 65%+ coverage
• 🛡️ Type-safe: Full mypy type checking and validation
• 📦 Modern packaging: Standard pyproject.toml with hatchling build system
• 🔧 Developer-friendly: Automated formatting (ruff), linting, and CI/CD

Both servers implement the full Model Context Protocol specification:

• 🛠️ Tools: Execute quantum operations (code completion, job submission, backend queries)
• 📚 Resources: Access quantum data (service status, backend information, model details)
• ⚡ Real-time: Async operations for responsive AI interactions
• 🔒 Secure: Proper authentication and error handling

# Run tests for Code Assistant server
cd qiskit-code-assistant-mcp-server
./run_tests.sh

# Run tests for IBM Runtime server  
cd qiskit-ibm-runtime-mcp-server
./run_tests.sh

Both servers maintain high code quality standards:

• ✅ Linting: ruff check and ruff format
• 🛡️ Type checking: mypy src/
• 🧪 Testing: pytest with async support and coverage reporting
• 🚀 CI/CD: GitHub Actions for automated testing

• Model Context Protocol - Understanding MCP
• Qiskit IBM Runtime - Quantum cloud services
• Qiskit Code Assistant - AI code assistance
• MCP Inspector - Interactive testing tool
• FastMCP - High-performance MCP framework

This repository includes AI-generated code and offers comprehensive guidance for AI coding assistants (like IBM Bob, Claude Code, GitHub Copilot, Cursor AI, and others) in AGENTS.md. This helps AI assistants provide more accurate, context-aware suggestions when working with this codebase.

This project is licensed under the Apache License 2.0.