# Qiskit Code Assistant 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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 41
- Author: Qiskit
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Qiskit/mcp-servers/tree/HEAD/qiskit-code-assistant-mcp-server
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/mcp/qiskit-code-assistant-mcp-server

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `QISKIT_IBM_TOKEN`, `QCA_TOOL_API_BASE`, `QCA_TOOL_MODEL_NAME` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-server
```
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>

### Codex

**Platform CLI**
```bash
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-server
```
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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
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-server
```
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>

## When to use it
- 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
- 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.

## Similar
- [Zotero MCP](https://affpapa.org/en/nevibecode/mcp/zotero-mcp.md) — MCP server · ★ 5548
- [arxiv-mcp-server](https://affpapa.org/en/nevibecode/mcp/arxiv-mcp-server.md) — MCP server · ★ 3231
- [PaperBanana](https://affpapa.org/en/nevibecode/mcp/paperbanana.md) — MCP server · ★ 2417
- [MATLAB MCP Server](https://affpapa.org/en/nevibecode/mcp/matlab-mcp-server.md) — MCP server · ★ 1716
- [Hex Research](https://affpapa.org/en/nevibecode/mcp/hex-research.md) — MCP server · ★ 583
- [DocsAgent — Zotero, Obsidian & Apple Notes MCP Server](https://affpapa.org/en/nevibecode/mcp/docsagent-zotero-obsidian-apple-notes-mcp-server.md) — MCP server · ★ 578

From the same set: [qiskit/mcp-servers](https://affpapa.org/en/nevibecode/by/qiskit/mcp-servers.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md