Qiskit Gym MCP Server
A Model Context Protocol (MCP) server that provides reinforcement learning-based quantum circuit synthesis capabilities using qiskit-gym. Its 31 documented tools cover tool, training, model, permutation.
People connecting this server 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 Gym MCP Server
before you install - you'll need
Set QISKIT_GYM_MODEL_DIR, QISKIT_GYM_TENSORBOARD_DIR, QISKIT_GYM_MAX_QUBITS, QISKIT_GYM_MAX_SEARCHES before connecting.
Claude Code
claude mcp add qiskit-mcp-servers-qiskit-gym-mcp-server -- uvx qiskit-gym-mcp-serverClaude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"qiskit-mcp-servers-qiskit-gym-mcp-server": {
"command": "uvx",
"args": [
"qiskit-gym-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-gym-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 Gym MCP Server can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
What you can build
With this server connected, an agent can list active environments, get environment details, remove an environment, and get training progress and metrics.
Capability map
Tools grouped from the project's README - what Qiskit Gym MCP Server lets an agent do.
read & search
6 tools - e.g. List active environments; List models on disk; List models in memory
list_environments_tool · list_saved_models_tool · list_loaded_models_tool · list_subtopology_shapes_tool · get_fake_backend_coupling_map_tool · list_available_fake_backends_tool
Training
5 tools - e.g. Start RL training (PPO or AlphaZero), supports background=True; Wait for background training to complete; Get training progress and metrics
start_training_tool · wait_for_training_tool · get_training_status_tool · stop_training_tool · list_training_sessions_tool
create & write
4 tools - e.g. Create PermutationGym for SWAP routing; Create LinearFunctionGym for CNOT synthesis; Create CliffordGym with custom gate sets
create_permutation_env_tool · create_linear_function_env_tool · create_clifford_env_tool · create_coupling_map_tool
Model
4 tools - e.g. Save trained model to disk; Load model from disk; Delete a model
save_model_tool · load_model_tool · delete_model_tool · get_model_info_tool
Synthesize
3 tools - e.g. Generate optimal SWAP circuit; Generate optimal CNOT circuit; Generate optimal Clifford circuit
synthesize_permutation_tool · synthesize_linear_function_tool · synthesize_clifford_tool
Generate
3 tools - e.g. Generate random permutation for testing; Generate random linear function for testing; Generate random Clifford element for testing
generate_random_permutation_tool · generate_random_linear_function_tool · generate_random_clifford_tool
Environment
2 tools - e.g. Get environment details; Remove an environment
get_environment_info_tool · delete_environment_tool
Convert
2 tools - e.g. Convert QPY circuit to human-readable QASM3; Convert QASM3 circuit to QPY format
convert_qpy_to_qasm3_tool · convert_qasm3_to_qpy_tool
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 Gym MCP Server
Qiskit Gym 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.
- Qiskit MCP Server MCP server for Qiskit quantum computing with circuit serialization utilities ★ 39
- Qiskit IBM Runtime MCP Server MCP server for IBM Quantum computing services through Qiskit IBM Runtime ★ 39
- Qiskit IBM Transpiler MCP Server MCP server for AI Transpiler IBM Quantum services ★ 39
- Qiskit Documentation MCP Server MCP server for querying and retrieving Qiskit documentation, guides, and API references ★ 39
05 · Facts
- repository
- github.com/qiskit/mcp-servers
- category
- other - actively maintained as of 2026-08-25.
- registry
- io.github.Qiskit/qiskit-gym-mcp-server (active, first published 2026-02-04 · 5 versions)
- packages
- pypi:qiskit-gym-mcp-server
06 · Qiskit Gym MCP Server FAQ
Is Qiskit Gym MCP Server still maintained?
Yes - as of 2026-08-25, its last commit was 2026-07-13. We re-verify nightly.
What can Qiskit Gym MCP Server do?
With this server connected, an agent can list active environments, get environment details, remove an environment, and get training progress and metrics.
How do I install Qiskit Gym MCP Server?
Run `uvx qiskit-gym-mcp-server`. The README documents 4 environment variables (QISKIT_GYM_MODEL_DIR, QISKIT_GYM_TENSORBOARD_DIR, QISKIT_GYM_MAX_QUBITS…) to set first. Set QISKIT_GYM_MODEL_DIR, QISKIT_GYM_TENSORBOARD_DIR, QISKIT_GYM_MAX_QUBITS, QISKIT_GYM_MAX_SEARCHES before connecting. You can also paste the ready-made client config above.
Does Qiskit Gym 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 Gym MCP Server
Alternatives to Qiskit Gym MCP Server
Maintained other servers if Qiskit Gym MCP Server isn't the fit.
- Heyputer MCP Server Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more ★ 43,204 · 2026-08-24
- Server Commands An MCP server to run arbitrary commands ★ 38,704 · 2026-08-05
- Zotero MCP (54yyyu) Search, read, annotate, and add to your Zotero research library, local or web. ★ 4,780 · 2026-08-25
- Firebase MCP Gives AI development tools Firebase-specific capabilities and expertise. ★ 4,460 · 2026-08-25
- Microsoft Fabric MCP Server MCP tools for interacting with Microsoft Fabric ★ 3,598 · 2026-08-21
- Ship Swift 40+ production-ready SwiftUI recipes for building full-stack iOS apps via MCP. ★ 2,968 · 2026-08-09
More MCP servers to compare · Qiskit IBM Runtime MCP Server · Qiskit IBM Transpiler MCP Server · Qiskit MCP Server · Interminal · Server Template