Qiskit Gym MCP Server
MCP server for qiskit-gym reinforcement learning quantum circuit synthesis
40 stars
Reviews
Write oneNobody has reviewed Qiskit Gym MCP Server yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Qiskit Gym MCP Server tools (38, 7 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
batch_train_environments_toolTrain multiple environments in sequence.
convert_qasm3_to_qpy_toolConvert a QASM3 (or QASM2) circuit to base64-encoded QPY format.
convert_qpy_to_qasm3_toolConvert a QPY circuit to human-readable QASM3 format.
create_clifford_env_toolwrite actionCreate a CliffordGym environment for learning Clifford circuit synthesis.
create_coupling_map_toolwrite actionCreate a custom coupling map.
create_linear_function_env_toolwrite actionCreate a LinearFunctionGym environment for learning CNOT synthesis.
create_permutation_env_toolwrite actionCreate a PermutationGym environment for learning qubit routing with SWAP gates.
delete_environment_toolwrite actionDelete an environment.
delete_model_toolwrite actionDelete a model.
extract_subtopologies_toolExtract connected subtopologies of N qubits from a hardware preset.
generate_random_clifford_toolGenerate a random Clifford element for testing.
generate_random_linear_function_toolGenerate a random invertible linear function for testing.
generate_random_permutation_toolGenerate a random permutation for testing synthesis.
get_environment_info_toolGet detailed information about a specific environment.
get_fake_backend_coupling_map_toolGet the exact coupling map from a fake IBM backend (no credentials needed).
get_model_info_toolGet detailed information about a model.
get_tensorboard_metrics_toolGet training metrics from TensorBoard logs for historical runs.
get_tensorboard_status_toolCheck the status of the TensorBoard process.
get_training_metrics_toolGet detailed training metrics from TensorBoard logs.
get_training_status_toolGet the status and metrics of a training session.
list_available_fake_backends_toolList all available fake backends for offline topology access.
list_environments_toolList all active RL environments.
list_loaded_models_toolList all models currently loaded in memory.
list_saved_models_toolList all models saved to disk.
list_subtopology_shapes_toolList available subtopology shapes for a given hardware and qubit count.
list_tensorboard_experiments_toolList available TensorBoard experiments from past training runs.
list_training_sessions_toolList all training sessions.
load_model_toolLoad a saved model from disk.
mainwrite actionRun the server.
save_model_toolSave a trained model to disk.
start_tensorboard_toolStart TensorBoard to visualize training metrics.
start_training_toolStart training an RL agent on a created environment.
stop_tensorboard_toolStop the running TensorBoard process.
stop_training_toolStop a training session.
synthesize_clifford_toolSynthesize an optimal quantum circuit for a Clifford operation.
synthesize_linear_function_toolSynthesize an optimal quantum circuit for a linear Boolean function.
synthesize_permutation_toolSynthesize an optimal quantum circuit for a qubit permutation.
wait_for_training_toolWait for a background training session to complete.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan16 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
What the publisher says
From the Qiskit Gym MCP Server repository's README, as published. We do not edit it. Read it on GitHub
Qiskit MCP Servers
A collection of Model Context Protocol (MCP) servers that give AI assistants, LLMs, and agents seamless access to IBM Quantum services and Qiskit libraries. Generate quantum code, connect to real hardware, analyze backends, execute circuits, and search Qiskit documentation — all through a standardized protocol that works with any MCP-compatible client.
Quick Start
Prerequisites
- Python 3.10+ (3.11+ recommended)
- IBM Quantum account and API token (only required for IBM cloud servers: Runtime, Transpiler)
Install from PyPI
# Install all servers (core + community)
pip install "qiskit-mcp-servers[all]"
# Install core servers only (default, excludes community)
pip install qiskit-mcp-serversInstall individual servers
pip install "qiskit-mcp-servers[qiskit]" # Qiskit server only
pip install "qiskit-mcp-servers[runtime]" # IBM Runtime server only
pip install "qiskit-mcp-servers[transpiler]" # IBM Transpiler server only
pip install "qiskit-mcp-servers[docs]" # Documentation server only
pip install "qiskit-mcp-servers[gym]" # Qiskit Gym server only (community)Install from Source
Each server runs independently — the directory name and command are the same:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add qiskit-gym-mcp-server -- uvx qiskit-gym-mcp-server
Qiskit Gym MCP Server: common questions
- Is Qiskit Gym MCP Server safe?
- Yes, by our scan: it is graded A (94/100). Read the Qiskit Gym MCP Server safety report
- How do I install Qiskit Gym MCP Server?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Qiskit Gym MCP Server need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Qiskit Gym MCP Server maintained?
- The last commit was 2 days ago (2026-09-25). The latest release is v0.4.1.