open-standards/wai/wai-quantum-cli/skills/wai-quantum/reference/tools.md
Transaction Science 5307518b27 wai-quantum-qpu and wai-quantum-cli: a job on a provider outlives what sent it
A run on a person's provider waited in its process, and a job that had not
finished in two hours was cancelled at the provider, losing its place in the
queue. If the process stopped first, the job went on and its id was gone, so its
counts could not be read. A device's queue can take days.

A job is now written down before it is sent, with everything sealing it will
need, and the provider's id as soon as the provider gives one. Nothing that
cannot be recorded is sent. Any process can come back to the record, and its
counts are read against the program that was sent, whatever the device's
calibration has become. Running out of patience leaves the job where it is. A
request that did not complete may have reached the provider, so it is never sent
again: that could be a second bill.

The command line gains run --no-wait and providers jobs, collect and cancel. The
local MCP server's run_on_provider answers within a call, and gains
get_provider_job, cancel_provider_job and list_provider_jobs.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-02 22:18:51 -05:00

5.9 KiB

The tools, resources and prompts

Generated by wai-quantum docs skill from the servers' own lists; wai-quantum docs llms-full gives each tool's parameters.

The local MCP server: wai-quantum mcp, over stdio

  • run_quantum_circuit: Run a quantum program here
  • plan_quantum_circuit: Plan a quantum program
  • lint_qasm: Check an OpenQASM program
  • repair_qasm: Repair a program on its flagged lines
  • critique_qasm: Critique an OpenQASM program
  • check_equivalent: Check two programs are the same circuit
  • convert_program: Convert a program between formats
  • improve_qasm: Improve an OpenQASM program
  • classical_shortcuts: Find a program's classical shortcuts
  • compile_qasm: Compile a program, every pass checked
  • estimate_resources: Estimate a program's fault-tolerant resources
  • draw_circuit: Draw a circuit
  • debug_step: Step through a program and look into its state
  • debug_branches: Every branch of a program's measurements
  • verify_quantum_result: Check a result's receipt
  • discover_evaluate: Judge a generator against a workbench specification
  • discover_submit: Propose a generator to a workbench archive
  • discover_archive: Read a workbench archive
  • novelty_qasm: What is new in a program
  • discover_novelty: What is new in a workbench entry
  • rewrite_qasm: Rewrite a program, each step checked
  • converge_cohort: How diverse a set of programs is
  • converge_history: Whether the person's designs converge on a model's
  • study_measure: A study participant's measures
  • study_cohort: A study's report
  • taste_rank: Rank programs by the person's taste
  • taste_next: The pair to show the person next
  • history_commit: Record your edit in a program's history
  • history_changes: The changes a program would make
  • history_blame: Whose hand each line and gate is in
  • history_log: A program's history
  • list_methods: List the methods
  • list_fabric: List the fabric's members
  • list_components: List the engine's components
  • qasm_diagnostics: The reader's diagnostic codes
  • list_targets: List the device targets
  • show_target: Show a device target
  • run_on_target: Run a program as it would run on a device
  • qec_code: Show an error-correcting code and certify its distance
  • qec_decode: Decode a syndrome or a circuit's detectors
  • qec_threshold: Measure logical failure rates over distances
  • pulse_schedule: Read a pulse program into its schedule
  • pulse_check: Check a pulse run by running it again
  • gradient_qasm: The exact gradient of a Hamiltonian's expectation by a program's parameters
  • optimize_qasm: Minimise a Hamiltonian's expectation over a program's parameters
  • vqe_ground_state: Find a Hamiltonian's ground energy by the variational eigensolver
  • qaoa_maxcut: Solve Max-Cut on a graph by QAOA
  • build_algorithm: Write the program for a standard algorithm, checked against its reference
  • providers_list: List the person's quantum providers
  • provider_estimate: Plan a run on a provider, and its cost
  • run_on_provider: Run on a provider (can spend the person's money)
  • get_provider_job: Ask after a job on a provider
  • cancel_provider_job: Cancel a job on a provider
  • list_provider_jobs: List the jobs on the person's providers

The job service's MCP server: https://wai.transaction.science/quantum-jobs/mcp

  • run_quantum_circuit: Run a quantum circuit
  • run_quantum_set: Run a set of quantum programs, or one over a grid
  • dry_run_quantum_job: Plan a quantum job or set without running it
  • get_quantum_job: Read a quantum job
  • verify_quantum_receipt: Verify a result's receipt
  • critique_qasm: Critique a quantum program
  • check_equivalent: Check two quantum programs are the same circuit
  • convert_program: Convert a program between formats
  • improve_qasm: Improve a quantum program
  • classical_shortcuts: Find a quantum program's classical shortcuts
  • compile_qasm: Compile a quantum program, every pass checked
  • estimate_resources: Estimate a quantum program's fault-tolerant resources
  • repair_qasm: Repair a quantum program on its flagged lines
  • quantum_service_info: What the quantum service can do
  • qasm_diagnostics: The reader's diagnostic codes
  • list_components: List the engine's components
  • list_targets: List the device targets
  • show_target: Show a device target
  • run_on_target: Run a program as a device would
  • quantum_circuit_examples: Ready-to-run quantum examples
  • qec_code: Show an error-correcting code and certify its distance
  • qec_decode: Decode a syndrome or a circuit's detectors
  • qec_threshold: Measure logical failure rates over distances
  • pulse_schedule: Read a pulse program into its schedule
  • pulse_check: Check a pulse run by running it again
  • gradient_qasm: The exact gradient of a Hamiltonian's expectation by a program's parameters
  • optimize_qasm: Minimise a Hamiltonian's expectation over a program's parameters
  • vqe_ground_state: Find a Hamiltonian's ground energy by the variational eigensolver
  • qaoa_maxcut: Solve Max-Cut on a graph by QAOA
  • build_algorithm: Write the program for a standard algorithm, checked against its reference

Resources, on both servers

  • wai-quantum://docs/language: The OpenQASM the engine reads
  • wai-quantum://docs/diagnostics: The reader's diagnostics
  • wai-quantum://docs/methods: The methods and their accuracy classes
  • wai-quantum://docs/verdicts: The verdict: how far the engine checked
  • wai-quantum://examples: Worked examples, each with what it must do
  • wai-quantum://examples/bell.qasm: A Bell pair
  • wai-quantum://examples/ghz.qasm: A GHZ state in fewer layers
  • wai-quantum://examples/grover.qasm: Grover's search over four items
  • wai-quantum://examples/noisy-bell.qasm: A Bell pair under noise

Prompts, on both servers

  • write_verified_circuit: Write and verify a circuit for an intent
  • explain_result: Explain a result and its receipt
  • repair_from_diagnostics: Repair a program from its diagnostics