Generated QCOS Integration Reference
Generated from QCOS OpenAPI,softqcos-sdk, softqcos CLI, softqcos-mcp, and SynapseX gateway/router OpenAPI specs.
This page verifies how QCOS capabilities are documented inside SynapseX docs for LLM API routing, SDK usage, CLI access, and MCP federation.
Coverage summary
| Surface | Source | Count |
|---|---|---|
| QCOS REST API paths | qcos_server/openapi.json | 467 |
| QCOS OpenAPI schemas | qcos_server/openapi.json | 430 |
| QCOS runtime endpoints | /api/v1/runtime/* | 23 |
| QCOS Python SDK surfaces | softqcos-sdk/softqcos_sdk/client.py | 36 |
| QCOS CLI groups | softqcos-cli/softqcos/main.py | 38 |
| QCOS MCP tools | softqcos-mcp/server.py | 71 |
| SynapseX LLM/MCP gateway endpoints | SynapseX OpenAPI specs | 38 |
Canonical SynapseX LLM and MCP path
SynapseX LLM requests use the OpenAI-compatible/v1/chat/completions API. Quantum tool use is routed through the MCP router instead of duplicating QCOS execution endpoints inside the LLM router.
| Service | Method | Path | Summary | Operation ID |
|---|---|---|---|---|
api-gateway | POST | /v1/chat/completions | Proxy Chat Completions | proxy_chat_completions_v1_chat_completions_post |
api-gateway | POST | /v1/mcp/ask | Proxy Mcp Ask | proxy_mcp_ask_v1_mcp_ask_post |
api-gateway | POST | /v1/mcp/execute | Proxy Mcp Execute | proxy_mcp_execute_v1_mcp_execute_post |
api-gateway | POST | /v1/mcp/plan | Proxy Mcp Plan | proxy_mcp_plan_v1_mcp_plan_post |
api-gateway | GET | /v1/mcp/plans | Proxy Mcp Plans | proxy_mcp_plans_v1_mcp_plans_get |
api-gateway | POST | /v1/mcp/route | Proxy Mcp Route | proxy_mcp_route_v1_mcp_route_post |
api-gateway | GET | /v1/mcp/router/tools | Proxy Mcp Router Tools | proxy_mcp_router_tools_v1_mcp_router_tools_get |
api-gateway | GET | /v1/mcp/servers | Proxy Mcp Servers | proxy_mcp_servers_v1_mcp_servers_get |
api-gateway | POST | /v1/mcp/servers | Proxy Mcp Servers | proxy_mcp_servers_v1_mcp_servers_get |
api-gateway | GET | /v1/mcp/tools | List Mcp Tools | list_mcp_tools_v1_mcp_tools_get |
api-gateway | POST | /v1/mcp/tools/execute | Execute Mcp Tool | execute_mcp_tool_v1_mcp_tools_execute_post |
api-gateway | GET | /v1/mcp/tools/{name} | Get Mcp Tool | get_mcp_tool_v1_mcp_tools__name__get |
api-gateway | GET | /v1/model-registry/models | Proxy Model Registry Root | proxy_model_registry_root_v1_model_registry_models_get |
api-gateway | POST | /v1/model-registry/models | Proxy Model Registry Root | proxy_model_registry_root_v1_model_registry_models_get |
api-gateway | DELETE | /v1/model-registry/models/{model_path} | Proxy Model Registry | proxy_model_registry_v1_model_registry_models__model_path__patch |
api-gateway | GET | /v1/model-registry/models/{model_path} | Proxy Model Registry | proxy_model_registry_v1_model_registry_models__model_path__patch |
api-gateway | PATCH | /v1/model-registry/models/{model_path} | Proxy Model Registry | proxy_model_registry_v1_model_registry_models__model_path__patch |
api-gateway | POST | /v1/model-registry/models/{model_path} | Proxy Model Registry | proxy_model_registry_v1_model_registry_models__model_path__patch |
api-gateway | GET | /v1/models | Proxy Models | proxy_models_v1_models_get |
llm-router-service | POST | /v1/chat/completions | Openai Chat Completions | openai_chat_completions_v1_chat_completions_post |
llm-router-service | GET | /v1/models | List Models | list_models_v1_models_get |
mcp-router-service | POST | /mcp/ask | Ask | ask_mcp_ask_post |
mcp-router-service | POST | /mcp/execute | Execute | execute_mcp_execute_post |
mcp-router-service | POST | /mcp/plan | Plan | plan_mcp_plan_post |
mcp-router-service | GET | /mcp/plans | List Plans | list_plans_mcp_plans_get |
mcp-router-service | POST | /mcp/route | Route | route_mcp_route_post |
mcp-router-service | GET | /mcp/router/tools | List Routable Tools | list_routable_tools_mcp_router_tools_get |
mcp-router-service | GET | /mcp/servers | List Servers | list_servers_mcp_servers_get |
mcp-router-service | POST | /mcp/servers | Upsert Server | upsert_server_mcp_servers_post |
mcp-router-service | GET | /mcp/tools | List Routable Tools | list_routable_tools_mcp_tools_get |
mcp-router-service | POST | /v1/mcp/ask | Ask | ask_v1_mcp_ask_post |
mcp-router-service | POST | /v1/mcp/execute | Execute | execute_v1_mcp_execute_post |
mcp-router-service | POST | /v1/mcp/plan | Plan | plan_v1_mcp_plan_post |
mcp-router-service | GET | /v1/mcp/plans | List Plans | list_plans_v1_mcp_plans_get |
mcp-router-service | POST | /v1/mcp/route | Route | route_v1_mcp_route_post |
mcp-router-service | GET | /v1/mcp/router/tools | List Routable Tools | list_routable_tools_v1_mcp_router_tools_get |
mcp-router-service | GET | /v1/mcp/servers | List Servers | list_servers_v1_mcp_servers_get |
mcp-router-service | POST | /v1/mcp/servers | Upsert Server | upsert_server_v1_mcp_servers_post |
QCOS runtime API contract
The canonical QCOS execution contract for SynapseX agents is/api/v1/runtime/*.
| Method | Path | Tags | Summary | Operation ID |
|---|---|---|---|---|
GET | /api/v1/runtime/backends | QCOS Runtime | List Backends | list_backends_api_v1_runtime_backends_get |
GET | /api/v1/runtime/capabilities | QCOS Runtime | Capabilities | capabilities_api_v1_runtime_capabilities_get |
POST | /api/v1/runtime/estimate | QCOS Runtime | Estimate | estimate_api_v1_runtime_estimate_post |
GET | /api/v1/runtime/jobs | QCOS Runtime | List Jobs | list_jobs_api_v1_runtime_jobs_get |
POST | /api/v1/runtime/jobs | QCOS Runtime | Submit Job | submit_job_api_v1_runtime_jobs_post |
POST | /api/v1/runtime/jobs/async | QCOS Runtime | Submit Job Async | submit_job_async_api_v1_runtime_jobs_async_post |
DELETE | /api/v1/runtime/jobs/{job_id} | QCOS Runtime | Cancel Job | cancel_job_api_v1_runtime_jobs__job_id__delete |
GET | /api/v1/runtime/jobs/{job_id} | QCOS Runtime | Get Job | get_job_api_v1_runtime_jobs__job_id__get |
POST | /api/v1/runtime/jobs/{job_id}/approve | QCOS Runtime | Approve Job | approve_job_api_v1_runtime_jobs__job_id__approve_post |
GET | /api/v1/runtime/jobs/{job_id}/artifacts | QCOS Runtime | Job Artifacts | job_artifacts_api_v1_runtime_jobs__job_id__artifacts_get |
GET | /api/v1/runtime/jobs/{job_id}/artifacts/{artifact_id} | QCOS Runtime | Get Artifact | get_artifact_api_v1_runtime_jobs__job_id__artifacts__artifact_id__get |
GET | /api/v1/runtime/jobs/{job_id}/artifacts/{filename} | QCOS Runtime | Download Artifact | download_artifact_api_v1_runtime_jobs__job_id__artifacts__filename__get |
GET | /api/v1/runtime/jobs/{job_id}/artifacts/{filename}/raw | QCOS Runtime | Download Artifact | download_artifact_api_v1_runtime_jobs__job_id__artifacts__filename__raw_get |
GET | /api/v1/runtime/jobs/{job_id}/events | QCOS Runtime | Job Events | job_events_api_v1_runtime_jobs__job_id__events_get |
GET | /api/v1/runtime/provider-connections | QCOS Runtime | List Provider Connections | list_provider_connections_api_v1_runtime_provider_connections_get |
POST | /api/v1/runtime/provider-connections | QCOS Runtime | Create Provider Connection | create_provider_connection_api_v1_runtime_provider_connections_post |
POST | /api/v1/runtime/provider-connections/{connection_id}/test | QCOS Runtime | Test Provider Connection | test_provider_connection_api_v1_runtime_provider_connections__connection_id__test_post |
GET | /api/v1/runtime/resources/{resource_type}/{resource_id} | QCOS Runtime | Read Resource | read_resource_api_v1_runtime_resources__resource_type___resource_id__get |
GET | /api/v1/runtime/search/artifacts | QCOS Runtime | Search Artifacts | search_artifacts_api_v1_runtime_search_artifacts_get |
GET | /api/v1/runtime/search/backends | QCOS Runtime | Search Backends | search_backends_api_v1_runtime_search_backends_get |
GET | /api/v1/runtime/search/calibrations | QCOS Runtime | Search Calibrations | search_calibrations_api_v1_runtime_search_calibrations_get |
GET | /api/v1/runtime/search/jobs | QCOS Runtime | Search Jobs | search_jobs_api_v1_runtime_search_jobs_get |
GET | /api/v1/runtime/search/qec-runs | QCOS Runtime | Search Qec Runs | search_qec_runs_api_v1_runtime_search_qec_runs_get |
QCOS SDK surfaces
Use the QCOS product SDK for direct quantum workflows. SynapseX SDK and CLI route agentic requests through MCP Router when natural-language planning, approvals, or LLM context are required.| SDK property | API class |
|---|---|
client.algorithms | AlgorithmsAPI |
client.jobs | JobsAPI |
client.circuits | CircuitsAPI |
client.bench | BenchAPI |
client.calibration | CalibrationAPI |
client.billing | BillingAPI |
client.network | NetworkAPI |
client.qec | QECAPI |
client.isolation | IsolationAPI |
client.dri | DRIAPI |
client.ledger | LedgerAPI |
client.navcore | NavCoreAPI |
client.acos | ACOSAPI |
client.macro | MacroAPI |
client.admin | AdminAPI |
client.evidence | EvidenceAPI |
client.autopilot | AutopilotAPI |
client.gpu_qpu | GPUQPULinkAPI |
client.qec_service | QECServiceAPI |
client.marketplace | MarketplaceAPI |
client.energy | EnergyAPI |
client.qlink | QLinkAPI |
client.backends | BackendsAPI |
client.qap | QAPAPI |
client.use_cases | UseCasesAPI |
client.glassbox | GlassBoxAPI |
client.provider_hub | ProviderHubAPI |
client.qubo | QUBOAPI |
client.zne | ZNEAPI |
client.batch | BatchAPI |
client.workflow | WorkflowAPI |
client.session | SessionAPI |
client.visualize | VisualizeAPI |
client.sandbox | SandboxAPI |
client.coherence | CoherenceAPI |
client.chemistry | ChemistryAPI |
QCOS CLI groups
| Command group | Description |
|---|---|
softqcos backends | Manage user backend credentials (BYOB) |
softqcos algorithms | QCOS Algorithms™ — Quantum algorithm execution (Shor, Grover, QFT, QPE, QAOA…) |
softqcos jobs | QCOS Jobs™ — Submit, monitor & retrieve quantum jobs |
softqcos circuits | QCOS Circuits™ — Circuit management, optimization & simulation |
softqcos bench | QCOS Bench™ — Reproducible benchmarking & evidence |
softqcos calibration | QCOS GlassBox™ — Calibration, devices & evidence |
softqcos billing | QCOS ROI Engine™ — Billing, pricing & ROI analysis |
softqcos network | QCOS QuantumNet™ — Multi-QPU networking & teleportation |
softqcos qec | QCOS QEC™ — Quantum error correction & surface codes |
softqcos isolation | QCOS ZoneGuard™ — Crosstalk isolation & zone management |
softqcos dri | QCOS DRI™ — Device Reliability Index & proof-of-quantum |
softqcos ledger | QCOS QuantumLedger™ — Usage accounting & chargeback |
softqcos navcore | QCOS NavCore™ — Quantum-enhanced GNSS/PNT & RAIM |
softqcos acos | ACOS-ISA™ — Quantum infrastructure certification |
softqcos macro | Quantum Macro™ — Macro-economic quantum analysis |
softqcos admin | SoftQuantus QCOS™ Admin — Platform administration |
softqcos evidence | QCOS Evidence™ Portal — Verifiable evidence & artifacts |
softqcos api | QCOS API™ — Stable JSON-first commands for agents and automation |
softqcos autopilot | Autopilot Hybrid Orchestrator — AI QPU×GPU×CPU partitioning |
softqcos gpu-qpu | QCOS GPU-QPU Link — proprietary accelerated simulation |
softqcos qec-service | QEC-as-a-Service — FT middleware with Evidence Bundle 2.0 |
softqcos marketplace | Quantum Marketplace + Sovereign Multi-Cloud routing |
softqcos energy | Energy-Aware Scheduler — LUMI off-peak + carbon tracking |
softqcos qlink | QCOS QLink — GPU↔QPU zero-copy channel emulator |
softqcos qap | QAP™ — Quantum Audit Platform: consultant registration, audits & royalties |
softqcos use-cases | Use Cases™ — Quantum use case discovery & feasibility analysis |
softqcos glassbox | GlassBox™ — Device calibration, compilation transparency & evidence |
softqcos provider-hub | ProviderHub™ — Pluggable backend registry (register/remove adapters) |
softqcos qubo | QUBO™ Solver — Portfolio, MaxCut & energy dispatch optimization |
softqcos zne | ZNE™ — Zero-Noise Extrapolation error mitigation |
softqcos batch | Batch Operations™ — Parallel quantum circuit execution |
softqcos workflow | Workflow Orchestration™ — YAML multi-step workflows |
softqcos session | Session Management™ — Context tracking & audit |
softqcos visualize | Visualization™ — Histogram, Bloch sphere, statevector |
softqcos stream | Stream™ — Live SSE job execution stage stream |
softqcos compare | Compare™ — Side-by-side QCOS vs vanilla result comparison |
softqcos coherence | Coherence Monitor — Backend T1/T2 drift detection & pre-flight checks |
softqcos chemistry | Molecular Ruler — VQE, correlation functions & chemical property predictions |
QCOS MCP tools
ACOS certification
| Tool | Description |
|---|---|
qcos_acos_certify | Submit a quantum circuit for ACOS-ISA™ certification. Runs a standardized test suite and returns a certification with score, tier, and evidence. |
qcos_acos_certified_backends | List all ACOS-ISA v1.0 certified quantum backends in the SoftQuantus registry. |
qcos_acos_verify_backend_cert | Verify an ACOS-ISA backend certificate by certificate_id. Returns tamper-evident verification token (SHA-256). Use this to independently confirm that a backend is SoftQuantus-certified. |
Algorithms
| Tool | Description |
|---|---|
qcos_list_algorithms | List all available quantum algorithms in the QCOS registry (Shor, Grover, QFT, QPE, QAOA, Bernstein-Vazirani, Deutsch-Jozsa, etc.). |
qcos_run_shor | Run Shor’s factoring algorithm to factor an integer N. Returns the prime factors using quantum period-finding. |
qcos_run_grover | Run Grover’s quantum search algorithm. Finds a target value in an unstructured search space of size 2^n. |
qcos_run_qaoa | Run QAOA (Quantum Approximate Optimization Algorithm) for MaxCut. Returns approximate solution for graph partitioning problems. |
qcos_run_algorithm | Run any available quantum algorithm by name with custom parameters. Use qcos_list_algorithms to discover available algorithms and their schemas. |
qcos_run_hybrid_workflow | Execute a QCOS HybridWorkflow: a sequence of classical (HPC/CPU) and quantum (QPU) steps sharing a common data context. This is the QCOS solution to the #1 billion-dollar HPC+QPU integration problem — classical preprocessing + quantum circuit + classical postprocessing in a single governed, auditable job. Available presets: ‘vqe_molecular’ — Molecular simulation: build Hamiltonian → QAOA/VQE → extract energy. Required context: molecule_geometry={atoms:[…], basis:‘sto-3g’} ‘portfolio’ — Portfolio optimization: build QUBO → QAOA → extract selected assets. Required context: returns:[…], covariance:[[…]], n_select:int Returns per-step telemetry, total execution time, evidence_id for audit, and the final output of the last step. |
qcos_run_vqe | Run a VQE (Variational Quantum Eigensolver) molecular simulation to find the ground state energy of a molecule. Uses a parameterized quantum circuit ansatz with a classical optimizer loop (COBYLA/SPSA). Returns energy, convergence history, and simulation parameters. |
qcos_run_and_compare | Execute quantum code natively in the QCOS sandbox and return both QCOS-optimized and vanilla (unmitigated) results side-by-side with superiority analytics. Returns a Markdown report with Hellinger distance, fidelity gain %, entropy delta, and ASCII histograms. Frameworks: qiskit, cirq, pennylane, braket |
DRI/evidence
| Tool | Description |
|---|---|
qcos_dri_run | Run the QCOS DRI™ (Device Rating Index) assessment on a quantum backend. Measures gate fidelity, T1/T2 times, crosstalk, and produces a composite rating score. |
qcos_dri_proof_run | Run a proof-of-performance test for a quantum backend. Generates a verifiable certificate of quantum computational advantage. |
GlassBox calibration
| Tool | Description |
|---|---|
qcos_glassbox_list_devices | List all GlassBox-enabled quantum devices with real-time state observability. |
qcos_glassbox_compile | Compile a quantum circuit with full GlassBox visibility: returns the compiled circuit, resource estimates, and gate-level evidence. |
NavCore/PQC
| Tool | Description |
|---|---|
qcos_qrng_bytes | Generate quantum-random bytes using QRNG (Quantum Random Number Generator). Returns hex-encoded random bytes with entropy attestation. |
qcos_pqc_generate_keypair | Generate a Post-Quantum Cryptography (PQC) keypair. |
qcos_spoofing_detect | Detect GNSS/GPS spoofing attacks using quantum machine learning. Analyzes signal metadata and returns threat assessment with confidence score. |
qcos_kalman_navigate | Run quantum-enhanced Kalman filtering for inertial navigation. Fuses IMU + GPS data for position estimation during GNSS denial. |
Other QCOS tools
| Tool | Description |
|---|---|
qcos_health | Check the health and status of the QCOS API gateway. Returns version, uptime, backend availability, and service status. |
qcos_navcore_status | Get NavCore™ system status: available quantum backends, QRNG entropy pool, PQC algorithm availability, and spoofing detection status. |
qcos_isolation_allocate_zone | Allocate an isolated qubit zone on a quantum device to prevent crosstalk. Returns a zone_id for exclusive qubit access. |
qcos_ledger_get_pricing | Get the current QCOS pricing table: shot costs per backend, QPU rates, algorithm execution fees, and tier discounts. |
qcos_ledger_estimate_cost | Estimate the cost of a quantum job before submission. Returns estimated credits/USD based on backend, shots, and circuit complexity. |
qcos_batch_simulate | Submit a batch of circuits for parallel simulation. Returns a batch_id for tracking. More efficient than submitting circuits individually. |
qcos_bench_run | Run an operational benchmark on a quantum backend. Measures throughput, latency, gate fidelity, and quantum volume. |
qcos_roi_calculate | Calculate the ROI (Return on Investment) of quantum vs classical computing for a given workload. Returns speedup factor, cost savings, and break-even analysis. |
qcos_roi_industry_analysis | Get a quantum ROI analysis for a specific industry vertical (finance, pharma, logistics, energy, cybersecurity). |
qcos_rerank | Rerank a list of documents/passages against a query using quantum-enhanced scoring. Returns documents sorted by relevance with quantum confidence scores. |
qcos_macro_energy_optimize | Run quantum optimization for energy subsidy allocation. Finds optimal subsidy distribution across sectors to maximize economic efficiency. |
qcos_macro_risk_analysis | Quantum-enhanced portfolio or systemic risk analysis. Uses quantum Monte Carlo for faster convergence on high-dimensional risk models. |
qcos_macro_market_sizing | Get quantum computing market sizing analysis: TAM/SAM/SOM by industry, adoption curves, and revenue projections. |
qcos_solve_portfolio | Quantum-enhanced Markowitz portfolio optimization. Selects optimal n_select assets maximizing risk-adjusted return. Returns selected assets, portfolio metrics, and a DRR reliability score 0-100 with GREEN/YELLOW/RED semaphore. Unique: no competitor combines QUBO + DRR. |
qcos_solve_maxcut | Solve MaxCut graph partitioning via QUBO on the QCOS platform. Returns partition, cut value, and DRR reliability rating. Used in: network design, circuit layout, social network clustering. |
qcos_solve_energy_dispatch | Quantum unit commitment for energy dispatch optimization. Finds optimal on/off schedule for power plants meeting demand at minimum cost. Returns dispatch schedule, total cost, and DRR reliability score. |
qcos_mitigate_zne | Apply Zero-Noise Extrapolation (ZNE) to mitigate quantum hardware noise. Runs circuit at multiple noise scale factors and extrapolates to zero-noise limit. Vendor-agnostic — works with IBM, IonQ, Quantinuum, and QCOS GPU backends. Returns raw and mitigated expectation values with cryptographic evidence hash. |
qcos_discover_use_cases | Discover quantum use cases relevant to a business problem. Given a sector, challenge description, and business goal, returns a structured |
qcos_feasibility_report | Generate a quantum feasibility report for a specific use case. |
qcos_autopilot_plan | Generate an AI-driven hybrid execution plan that partitions a quantum workload across QPU, GPU, and CPU resources automatically. Returns a shard-by-shard placement plan with recommended device per shard, estimated latency, cost, and fidelity for each device. Supports workload types: vqe | qaoa | quantum_ml | shor | grover | generic. Strategies: auto | qpu_first | gpu_first | cost_opt | latency_opt. |
qcos_autopilot_execute | Execute a quantum circuit using the Autopilot Hybrid Orchestrator. The orchestrator automatically selects QPU, GPU, or CPU for each circuit shard, monitors noise drift in real-time, and reroutes to a better device if quality drops. Returns merged counts, total latency, device assignments, and cost breakdown. |
qcos_gpu_simulate_large | Simulate a large quantum circuit (100q–50000q) using GPU acceleration. Automatically selects the best simulation mode: |
qcos_gpu_qpu_transfer | Perform a zero-copy GPU↔QPU data transfer and return timing/bandwidth metrics. |
qcos_marketplace_vendors | List all quantum hardware vendors in the QCOS marketplace with real-time pricing. Pricing model: useful_shot — price is normalized by gate fidelity so you only pay for shots that are actually useful. Returns: 11 vendors including IBM Eagle/Heron, IonQ Aria/Forte, Quantinuum H2, Rigetti Ankaa-2, QuEra Aquila, PASQAL Fresnel, Xanadu Borealis, LUMI GPU. |
qcos_marketplace_submit | Submit a quantum circuit job to the QCOS marketplace. Auto-selects the best vendor based on qubit count, fidelity, cost, and queue depth unless a specific vendor_id is provided. Sovereign routing modes: none | eu_only | national | on_prem | full_lock. |
qcos_energy_schedule | Schedule a quantum job with energy awareness on LUMI HPC. |
qcos_carbon_report | Get a detailed carbon footprint report for a project. |
qcos_provider_list | List all providers registered in the QCOS ProviderHub. Returns provider_id, display_name, capabilities (max_qubits, technologies, |
qcos_provider_health | Health-check one or all providers in the ProviderHub. If provider_id is given, checks only that provider and returns healthy, latency_ms, queue_depth, uptime_pct, message. If provider_id is omitted, concurrently checks ALL providers and returns a summary dict with per-provider health status, plus healthy_count and total_count. |
qcos_provider_register | Dynamically register a community BackendAdapter into the ProviderHub. The adapter class must extend BackendAdapter, set a unique provider_id, and be importable from the QCOS server’s Python environment. Use this to add custom QPU/simulator backends without restarting QCOS. |
qcos_provider_remove | Remove a provider from the ProviderHub. Built-in providers can be removed and re-registered. Returns status: removed and provider_id on success, or an error if the provider was not found. |
qcos_list_molecules | List all molecules available for VQE molecular simulation with their properties: qubit count, electron count, Hartree-Fock energy, and geometry. |
qcos_list_simulations | List past VQE molecular simulation results from the history store. Returns simulation ID, molecule, energy, qubits, iterations, and optimizer used. |
qcos_get_simulation | Get a detailed VQE molecular simulation result by simulation ID. Returns full convergence history, final parameters, molecule info, and energy. |
qcos_compare_counts | Compare two quantum result distributions (QCOS-optimized vs vanilla) and return a Markdown analysis report with Hellinger distance, fidelity gain %, entropy delta, noise suppression %, and ASCII bar charts. |
qcos_visualize_histogram_markdown | Render quantum measurement counts as a Markdown histogram optimized for LLM readability. Shows states ranked by probability with Unicode bar chart, count, and probability columns. |
QEC
| Tool | Description |
|---|---|
qcos_qec_list_codes | List all available Quantum Error Correction codes in the catalog (Surface, Steane, Shor, Bacon-Shor, etc.) with their properties. |
qcos_qec_extract_syndrome | Extract error syndromes from a noisy quantum state. Returns stabilizer measurement outcomes for error identification. |
qcos_qec_decode | Run QEC decoder on syndrome measurements to identify and correct errors. Supports minimum-weight perfect matching (MWPM) and union-find decoders. |
qcos_qec_pipeline | Run the full QEC pipeline: encode → simulate noise → extract syndrome → decode → verify. End-to-end logical qubit protection workflow. |
qcos_qec_recommend | Recommend the optimal Quantum Error Correction code for the given requirements. Considers: target logical error rate, available physical qubits, and logical qubit count. |
qcos_qec_run | Run a full QEC-as-a-Service cycle on a quantum circuit: encode → execute → decode (BP+OSD) → certify fault-tolerance. Returns logical counts, logical error rate, FT status |
Quantum networking
| Tool | Description |
|---|---|
qcos_network_teleport | Execute quantum state teleportation between two nodes in the network. Transfers an arbitrary qubit state using entanglement. |
Runtime/jobs/backends
| Tool | Description |
|---|---|
qcos_submit_job_async | Submit a quantum job for asynchronous background execution on a QCOS backend. Returns a job_id immediately so execution status and logs can be tracked. |
qcos_submit_circuit | Submit a quantum circuit for execution on a QCOS backend. Accepts OpenQASM 2/3 or Qiskit JSON format. Returns a job_id to track execution. |
qcos_get_job_results | Retrieve the measurement results of a completed quantum job. |
qcos_get_job_evidence | Retrieve the cryptographic evidence bundle for a job (audit trail, circuit hash, backend attestation, timestamps). |
qcos_list_backends | List all available quantum backends (simulators and QPUs) with their properties: qubits, connectivity, noise model, availability. |
qcos_optimize_circuit | Optimize a quantum circuit using QCOS™ proprietary optimization (5-10x fewer gates). Returns optimized QASM and resource reduction metrics. |
qcos_analyze_circuit | Analyze a quantum circuit: gate count, depth, qubit requirements, expected fidelity on target hardware, and T-gate overhead. |
qcos_transpile_circuit | Transpile a quantum circuit to a target backend’s native gate set and qubit connectivity, with optional optimization. |
qcos_explain_circuit | Analyze a quantum circuit and return QCOS optimization recommendations. Evaluates circuit depth, gate count, qubit count to suggest ZNE level, Phase0B transpiler settings, and Autopilot backend routing. Returns a Markdown report with estimated fidelity gain. |