Qiskit Code Assistant MCP Server — Claude Code MCP Server
An MCP server that brings Qiskit Code Assistant completions to your AI workflow. It helps you write and complete quantum circuits directly in Claude Code and other MCP clients.
claude mcp add --env QISKIT_IBM_TOKEN=<QISKIT_IBM_TOKEN> --env QCA_TOOL_API_BASE=<QCA_TOOL_API_BASE> --env QCA_TOOL_MODEL_NAME=<QCA_TOOL_MODEL_NAME> --transport stdio qiskit-code-assistant-mcp-server -- uvx qiskit-code-assistant-mcp-serverWhat Qiskit Code Assistant MCP Server does
This server connects coding agents to IBM's Qiskit Code Assistant service. The tool supplies contextual code completions for quantum computing programs, making it easier to assemble circuits and call Qiskit libraries without leaving the terminal.
Execution relies on Python 3.10 or newer and runs via uvx. It operates through standard I/O. Without setting QISKIT_IBM_TOKEN in the environment, requests to the assistant backend will fail. You can also specify a custom API base and model name if your setup requires them.
What it helps with
- complete quantum circuit code using Qiskit Code Assistant
- generate boilerplate for quantum computing algorithms in Python
- connect AI coding agents to IBM Quantum completion endpoints
- fix Qiskit library syntax directly inside your editor or terminal
Example prompts for the agent
- Complete this quantum circuit using Qiskit Code Assistant.
- Generate a Bell state preparation script with Qiskit.
- Suggest the correct gates to finish this algorithm file.
How to install Qiskit Code Assistant MCP Server
Platform CLI
claude mcp add --env QISKIT_IBM_TOKEN=<QISKIT_IBM_TOKEN> --env QCA_TOOL_API_BASE=<QCA_TOOL_API_BASE> --env QCA_TOOL_MODEL_NAME=<QCA_TOOL_MODEL_NAME> --transport stdio qiskit-code-assistant-mcp-server -- uvx qiskit-code-assistant-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from qiskit-code-assistant-mcp-server <command>
Platform CLI
codex mcp add qiskit-code-assistant-mcp-server --env QISKIT_IBM_TOKEN=<QISKIT_IBM_TOKEN> --env QCA_TOOL_API_BASE=<QCA_TOOL_API_BASE> --env QCA_TOOL_MODEL_NAME=<QCA_TOOL_MODEL_NAME> -- uvx qiskit-code-assistant-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from qiskit-code-assistant-mcp-server <command>
Config file
{
"mcpServers": {
"qiskit-code-assistant-mcp-server": {
"command": "uvx",
"args": [
"qiskit-code-assistant-mcp-server"
],
"env": {
"QISKIT_IBM_TOKEN": "<QISKIT_IBM_TOKEN>",
"QCA_TOOL_API_BASE": "<QCA_TOOL_API_BASE>",
"QCA_TOOL_MODEL_NAME": "<QCA_TOOL_MODEL_NAME>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from qiskit-code-assistant-mcp-server <command>
Config file
{
"servers": {
"qiskit-code-assistant-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"qiskit-code-assistant-mcp-server"
],
"env": {
"QISKIT_IBM_TOKEN": "<QISKIT_IBM_TOKEN>",
"QCA_TOOL_API_BASE": "<QCA_TOOL_API_BASE>",
"QCA_TOOL_MODEL_NAME": "<QCA_TOOL_MODEL_NAME>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from qiskit-code-assistant-mcp-server <command>
Platform CLI
gemini mcp add -e QISKIT_IBM_TOKEN=<QISKIT_IBM_TOKEN> -e QCA_TOOL_API_BASE=<QCA_TOOL_API_BASE> -e QCA_TOOL_MODEL_NAME=<QCA_TOOL_MODEL_NAME> qiskit-code-assistant-mcp-server uvx qiskit-code-assistant-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from qiskit-code-assistant-mcp-server <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Qiskit Code Assistant MCP Server
How do I install Qiskit Code Assistant MCP Server in Claude Code?
Run claude mcp add qiskit-code-assistant-mcp-server -e QISKIT_IBM_TOKEN=<QISKIT_IBM_TOKEN> -- uvx qiskit-code-assistant-mcp-server in your terminal. Replace <QISKIT_IBM_TOKEN> with your IBM Quantum API token.
What does Qiskit Code Assistant MCP Server do?
It provides intelligent code completions for quantum developers by routing prompts to the Qiskit Code Assistant model.
What environment variables are required?
You need QISKIT_IBM_TOKEN to access the service. Optional variables include QCA_TOOL_API_BASE for a custom base URL and QCA_TOOL_MODEL_NAME to select a specific model.
