Qiskit Documentation MCP Server

MCP server for querying and retrieving Qiskit documentation, guides, and API references.

People connecting documentation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

One of 5 MCP servers published from qiskit/mcp-servers. Stars and repository activity are shared across all of them. See all 5 →

VERIFIED ACTIVE

LAST COMMIT 2026-07-13 · VERIFIED 2026-08-25

Apache-2.0 · Python servers · how we verify → /methodology

01 · Install Qiskit Documentation MCP Server

before you install - you'll need

Set QISKIT_DOCS_BASE, QISKIT_HTTP_TIMEOUT, QISKIT_DOCS_CACHE_TTL, QISKIT_SEARCH_CACHE_TTL before connecting.

Claude Code

claude mcp add qiskit-mcp-servers-qiskit-docs-mcp-serve -- uvx qiskit-docs-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "qiskit-mcp-servers-qiskit-docs-mcp-serve": {
      "command": "uvx",
      "args": [
        "qiskit-docs-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

pypi package qiskit-docs-mcp-server - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.Qiskit is GitHub-verified and matches the repo owner

03 · What Qiskit Documentation MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

meta-v0.12.0 · 2026-07-13

Add top_k and snippets options for search_docs_tool · upgrade fastmcp to >=3.2.0 to resolve CVE-2026-32871 (CVSS 10.0) · Add backward compatibility for search_docs_tool tool · New Contributors · @eltonjohnfanboy made…

docs-v0.3.0 · 2026-07-13

Add top_k and snippets options for search_docs_tool · upgrade fastmcp to >=3.2.0 to resolve CVE-2026-32871 (CVSS 10.0) · Add backward compatibility for search_docs_tool tool · New Contributors · @eltonjohnfanboy made…

gym-v0.4.1 · 2026-07-13

upgrade fastmcp to >=3.2.0 to resolve CVE-2026-32871 (CVSS 10.0)

04 · Who maintains Qiskit Documentation MCP Server

Qiskit Documentation MCP Server is maintained by qiskit. We track 6 MCP servers from qiskit - 6 actively maintained, 39 combined GitHub stars, oldest repo from Sep 2025. Full record: all servers from qiskit.

  1. Qiskit MCP Server MCP server for Qiskit quantum computing with circuit serialization utilities ★ 39
  2. Qiskit IBM Runtime MCP Server MCP server for IBM Quantum computing services through Qiskit IBM Runtime ★ 39
  3. Qiskit Gym MCP Server MCP server for qiskit-gym reinforcement learning quantum circuit synthesis ★ 39
  4. Qiskit IBM Transpiler MCP Server MCP server for AI Transpiler IBM Quantum services ★ 39

05 · Facts

category
documentation - actively maintained as of 2026-08-25.
registry
io.github.Qiskit/qiskit-docs-mcp-server (active, first published 2026-03-11 · 4 versions)
packages
pypi:qiskit-docs-mcp-server

06 · Qiskit Documentation MCP Server FAQ

What is Qiskit Documentation MCP Server?

MCP server for querying and retrieving Qiskit documentation, guides, and API references.

Is Qiskit Documentation MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-13. We re-verify nightly.

How do I install Qiskit Documentation MCP Server?

Run `uvx qiskit-docs-mcp-server`. The README documents 4 environment variables (QISKIT_DOCS_BASE, QISKIT_HTTP_TIMEOUT, QISKIT_DOCS_CACHE_TTL…) to set first. Set QISKIT_DOCS_BASE, QISKIT_HTTP_TIMEOUT, QISKIT_DOCS_CACHE_TTL, QISKIT_SEARCH_CACHE_TTL before connecting. You can also paste the ready-made client config above.

Does Qiskit Documentation MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Qiskit Documentation MCP Server