Qiskit Gym MCP Server
Connects your MCP client to qiskit-gym, a reinforcement learning environment for quantum circuit synthesis. The server exposes RL training workflows where agents learn to construct quantum circuits that match target unitaries or solve specific quantum tasks. Useful if you're experimenting with automated circuit design using RL techniques rather than hand-coding gates or using traditional compilation passes. This is a community contribution in the Qiskit MCP collection, so expect a more experimental scope than the core IBM Quantum servers. You'll interact with gym environments, training loops, and circuit evaluation tools through the standard MCP protocol.
- tools
- 31
- transport
- STDIO
- last updated
- Oct 8, 2026
Tools
31 toolsPublic tool metadata for what this MCP can expose to an agent.
create_permutation_env_toolCreate PermutationGym for SWAP routing
Create PermutationGym for SWAP routing
No parameter schema in public metadata yet.
create_linear_function_env_toolCreate LinearFunctionGym for CNOT synthesis
Create LinearFunctionGym for CNOT synthesis
No parameter schema in public metadata yet.
create_clifford_env_toolCreate CliffordGym with custom gate sets
Create CliffordGym with custom gate sets
No parameter schema in public metadata yet.
list_environments_toolList active environments
List active environments
No parameter schema in public metadata yet.
get_environment_info_toolGet environment details
Get environment details
No parameter schema in public metadata yet.
delete_environment_toolRemove an environment
Remove an environment
No parameter schema in public metadata yet.
start_training_toolStart RL training (PPO or AlphaZero), supports `background=True`
Start RL training (PPO or AlphaZero), supports `background=True`
No parameter schema in public metadata yet.
wait_for_training_toolWait for background training to complete
Wait for background training to complete
No parameter schema in public metadata yet.
batch_train_environments_toolTrain multiple environments
Train multiple environments
No parameter schema in public metadata yet.
get_training_status_toolGet training progress and metrics
Get training progress and metrics
No parameter schema in public metadata yet.
stop_training_toolStop a training session
Stop a training session
No parameter schema in public metadata yet.
list_training_sessions_toolList all training sessions
List all training sessions
No parameter schema in public metadata yet.
synthesize_permutation_toolGenerate optimal SWAP circuit
Generate optimal SWAP circuit
No parameter schema in public metadata yet.
synthesize_linear_function_toolGenerate optimal CNOT circuit
Generate optimal CNOT circuit
No parameter schema in public metadata yet.
synthesize_clifford_toolGenerate optimal Clifford circuit
Generate optimal Clifford circuit
No parameter schema in public metadata yet.
save_model_toolSave trained model to disk
Save trained model to disk
No parameter schema in public metadata yet.
load_model_toolLoad model from disk
Load model from disk
No parameter schema in public metadata yet.
list_saved_models_toolList models on disk
List models on disk
No parameter schema in public metadata yet.
list_loaded_models_toolList models in memory
List models in memory
No parameter schema in public metadata yet.
delete_model_toolDelete a model
Delete a model
No parameter schema in public metadata yet.
get_model_info_toolGet model details
Get model details
No parameter schema in public metadata yet.
create_coupling_map_toolCreate custom coupling map
Create custom coupling map
No parameter schema in public metadata yet.
extract_subtopologies_toolExtract N-qubit subtopologies from hardware
Extract N-qubit subtopologies from hardware
No parameter schema in public metadata yet.
list_subtopology_shapes_toolList subtopology shapes (line, grid, etc.)
List subtopology shapes (line, grid, etc.)
No parameter schema in public metadata yet.
get_fake_backend_coupling_map_toolGet exact topology from fake IBM backend (no credentials needed)
Get exact topology from fake IBM backend (no credentials needed)
No parameter schema in public metadata yet.
list_available_fake_backends_toolList all available fake backends for offline topology access
List all available fake backends for offline topology access
No parameter schema in public metadata yet.
generate_random_permutation_toolGenerate random permutation for testing
Generate random permutation for testing
No parameter schema in public metadata yet.
generate_random_linear_function_toolGenerate random linear function for testing
Generate random linear function for testing
No parameter schema in public metadata yet.
generate_random_clifford_toolGenerate random Clifford element for testing
Generate random Clifford element for testing
No parameter schema in public metadata yet.
convert_qpy_to_qasm3_toolConvert QPY circuit to human-readable QASM3
Convert QPY circuit to human-readable QASM3
No parameter schema in public metadata yet.
convert_qasm3_to_qpy_toolConvert QASM3 circuit to QPY format
Convert QASM3 circuit to QPY format
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
Details
- Repository
- github.com/qiskit/mcp-servers
- Website
- github.com/Qiskit/mcp-servers/tree/main/qiskit-gym-mcp-server
- Package
qiskit-gym-mcp-server- Transport
- STDIO
- Registry
- MCP registry, active