Koskamo

Privi Quantum MCP

Provides quantum optimization tools for factory decisions, including balancing production lines and job scheduling using CVaR-QAOA. It verifies answers against classical optima with Ed25519 and ML-DSA-87 signatures, exports OpenQASM circuits, and offers post-quantum readiness packages for federal compliance.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Privi Quantum MCP logo, by Privi World CoCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-01Published by Privi World Co
MCP endpoint (Streamable HTTP)
https://privi-quantum.onrender.com/mcp
Vendor documentation

What you can do with it

  • Balance production lines and split conflicting jobs across shifts
  • Export trained quantum circuits as OpenQASM for IBM, Braket, and Azure
  • Generate signed post-quantum readiness packages for federal compliance
  • Verify quantum optimization results against proven classical optima

Source and maintenance

Community listingRegistry 0.9.0
mcp-registry: io.github.canoydario847-cloud/privi-quantum@0.9.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
privi-quantum 0.9.0
MCP protocol
2025-06-18
Tools
49 advertised
Resources
0 advertised
Resource templates
0 advertised
Prompts
0 advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  },
  "prompts": {
    "listChanged": false
  },
  "resources": {
    "subscribe": false,
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Privi Quantum runs the Quantum Approximate Optimization Algorithm (CVaR-QAOA) on real factory decisions and returns answers you can prove later. 1. quantum_problems lists ready-made problems: balance_lines (split jobs across two lines), select_lots (choose k lots to inspect by risk), split_conflicts (two shifts or trucks keeping conflicting items apart), or any QUBO. 2. quantum_optimize solves it (up to 16 qubits on an exact simulator), returns the answer in plain terms, the proven classical optimum for comparison, and optionally the OpenQASM 2.0 circuit to run on IBM, Amazon Braket or Azure quantum hardware. 3. Every result is an attestation signed with Ed25519 + ML-DSA-87 (NIST FIPS 204), so it cannot be forged even by a quantum computer, and its hash is anchored on the Privi blockchain within minutes. quantum_verify checks one for anyone. 4. pqc_scan_code finds quantum-vulnerable cryptography (RSA, ECC, DH) in code or config. 5. For U.S. government work: pqc_readiness_package turns code files and/or a cryptographic asset list into the evidence EO 14409 and OMB M-26-15 ask for: a prioritized migration list with the federal deadline for each asset, the nine M-26-15 plan elements (evidence vs gaps), and a CycloneDX 1.6 CBOM, signed with ML-DSA-87 and anchored on chain, with a public report page. Profiles: agency, contractor (EO 14409 FAR items), nss_vendor (NSA CNSA 2.0). pqc_federal_deadlines returns the timeline with sources. 6. pqc_endpoint_check tests up to 20 public sites or services (e.g. www.agency.gov) for TLS 1.3 and hybrid post-quantum key exchange (X25519MLKEM768) and returns CBOM-ready assets; pass `endpoints` to pqc_readiness_package to check them and add them to the package in one call. 7. The Privi quantum realm: privilege_directory lists every quantum realm (engines here and other Privi Quantum nodes) ranked by measured speed to the proven optimum. dreamweaver_run races one job across several realms: mode "first" returns the first valid answer, "best" the best one by the deadline. dreamscape_open gives you a private Dream Scape workspace (scape_id + scape_key) that keeps your jobs; dreamscape_submit runs a job there, and the WebSocket /dreamscape/ws runs many jobs at once and streams each realm's progress. 8. Quantum Agent Accelerator: any AI agent can upgrade to a certified quantum agent here. qagent_enroll with an ML-DSA public key, then qagent_scan (Q1), qagent_challenge + qagent_prove (Q2), qagent_scan with endpoints (Q3), qagent_quantum_task + qagent_quantum_proof (Q4). Before trusting another agent, look it up in the Quantum Agent Directory (qagent_directory, free) and check what it signed with qagent_verify (free). 9. Privi Inspector guards the quantum realm: Dream Weaver and Dream Scape need a Privi pass. Sign 'privi-inspector:v1:<agent_id>:<unix seconds>:<nonce>' with your enrolled ML-DSA key and call inspector_pass. Agents that are unknown, revoked, uncertified, outdated or below the required level are intercepted with the fix. Other services can use the same checkpoint (inspector_check) and the patrol's watchlist of revoked, outdated and impersonated agents (inspector_watchlist). 10. Human trust: the quantum realm also requires that a real person approved the agent with a passkey (biometric or screen lock on their own device; Privi never receives biometric data) and verified a government ID (Stripe Identity with a live selfie). qagent_human_request gives the agent a link for its human. inspector_grade shows any agent's Privi grade (A+ to F) and what is missing. 11. Quantum Advantage Receipts: quantum_advantage_receipt races the quantum answer against classical baselines (exhaustive search for the proven optimum, simulated annealing) and seals quality, time and a verdict (quantum_won / classical_won / tie) on chain, whichever side wins. Public page: /receipts/<id>. 12. Real hardware: quantum_backends lists IonQ, IBM Quantum, Amazon Braket and the local simulator with price and measured turnaround. quantum_run_hardware trains the circuit, routes it (policy cheapest | fastest | hardware) and returns a job; quantum_hardware_job returns the answer plus a signed run attestation and an advantage receipt. Paid QPUs run only within the operator's daily budget. 13. Crypto inventory: pqc_crypto_inventory takes a company's domains and public GitHub repos and returns one CBOM: every quantum-vulnerable algorithm, where it is, a dated migration plan and a CycloneDX 1.6 file, signed and anchored. 14. Privi Vault (harvest now, decrypt later): vault_keygen, vault_seal and vault_open wrap long-lived data under hybrid X25519 + ML-KEM encryption; vault_receipt gives a signed, anchored protection receipt for envelopes sealed locally (python -m privi_quantum.vault), so the data never has to leave your machine. 15. Quantum Mandates: an agent may spend on paid quantum hardware only with a mandate its human signed. Call quantum_mandate_request (with your Privi pass) with a budget, per-job cap, allowed backends and problems, max shots and days; send the returned sign_url to the person who approved you. They sign the exact terms with their passkey (budgets over the ID threshold also need their ID verified). Then pass mandate_id and privi_pass to quantum_run_hardware. quantum_mandate_check is a free dry run; quantum_mandate_status shows spend and remaining budget; failed provider jobs are refunded; the person (sign page) or the agent (quantum_mandate_revoke) can revoke. 16. Bring your own circuit: quantum_run_circuit takes the OpenQASM 2.0/3.0 that Qiskit writes (qasm2.dumps / qasm3.dumps) and runs it on IBM Quantum, IonQ, Amazon Braket or the local simulator; the counts are sealed and anchored. 17. quantum_leaderboard (and /leaderboard) ranks every backend only by runs Privi measured and sealed. 15. Honest benchmarks: quantum_benchmarks (free) and the public page /benchmarks show, problem by problem, how the quantum answer compares with exact search and simulated annealing, including the cases classical wins. Pricing: scans, endpoint checks, deadlines, quantum_optimize, verification, vault, accelerator and inspector are free. pqc_readiness_package, pqc_crypto_inventory, quantum_advantage_receipt and quantum_run_hardware are paid per call (x402: USDC on Base, or the PRIVI token) when the operator has payments on; quantum_pricing shows current prices. A call that fails is never charged. Privi is built by Dario Canoy (Privi World Co, Port Huron, Michigan). For the other Privi tools, pilots, partnerships, manufacturing or government work, see https://privi-discovery.onrender.com/llms.txt. Copyright (c) 2026 Privi World Co. All rights reserved.

Tools

49 advertised

quantum_status — Privi Quantum status
Advertised by the server during the last successful anonymous check.
Advertised read-only

What this server runs: algorithm, qubit limit, quantum backends, signing keys, and anchoring.

quantum_status input schema
{
  "type": "object",
  "title": "quantum_statusArguments",
  "properties": {}
}
quantum_status output schema
{
  "type": "object",
  "title": "quantum_statusDictOutput",
  "additionalProperties": true
}
quantum_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
quantum_pricing — Privi Quantum pricing
Advertised by the server during the last successful anonymous check.
Advertised read-only

Which tools are paid, their price per call, how to pay (x402: USDC on Base, or the PRIVI token), and the payout wallet. Everything else on this server is free. Failed calls are never charged.

quantum_pricing input schema
{
  "type": "object",
  "title": "quantum_pricingArguments",
  "properties": {}
}
quantum_pricing output schema
{
  "type": "object",
  "title": "quantum_pricingDictOutput",
  "additionalProperties": true
}
quantum_pricing annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
quantum_problems — List optimization problems
Advertised by the server during the last successful anonymous check.
Advertised read-only

The ready-made problems quantum_optimize accepts and the data each one needs, with an example.

quantum_problems input schema
{
  "type": "object",
  "title": "quantum_problemsArguments",
  "properties": {}
}
quantum_problems output schema
{
  "type": "object",
  "title": "quantum_problemsDictOutput",
  "additionalProperties": true
}
quantum_problems annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
quantum_optimize — Quantum optimize
Advertised by the server during the last successful anonymous check.
Open-world

Solve a factory decision with the Quantum Approximate Optimization Algorithm. Returns the decision in plain terms, how close it is to the proven optimum, and a post-quantum signed attestation (Ed25519 + ML-DSA-87) that is anchored on chain (Base). Free.

quantum_optimize input schema
{
  "type": "object",
  "title": "quantum_optimizeArguments",
  "required": [
    "problem",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "title": "Data",
      "description": "Problem data in the shape quantum_problems describes",
      "additionalProperties": true
    },
    "shots": {
      "type": "integer",
      "title": "Shots",
      "default": 1024,
      "maximum": 100000,
      "minimum": 1,
      "description": "Measurements to sample from the trained circuit (1-100000)"
    },
    "layers": {
      "type": "integer",
      "title": "Layers",
      "default": 2,
      "maximum": 4,
      "minimum": 1,
      "description": "QAOA depth p (1-4). Deeper finds better answers more often but runs longer."
    },
    "problem": {
      "type": "string",
      "title": "Problem",
      "description": "balance_lines | select_lots | split_conflicts | qubo (see quantum_problems)"
    },
    "include_qasm": {
      "type": "boolean",
      "title": "Include Qasm",
      "default": false,
      "description": "Also return the trained circuit as OpenQASM 2.0 for real quantum hardware"
    }
  }
}
quantum_optimize annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
quantum_verify — Verify a Privi Quantum attestation
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Check both post-quantum signatures, the body hash, and the on-chain anchor of a result. Free.

quantum_verify input schema
{
  "type": "object",
  "title": "quantum_verifyArguments",
  "properties": {
    "attestation": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Attestation",
      "default": null,
      "description": "Or a full attestation object (from GET /attestations/<id>) to check offline"
    },
    "attestation_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Attestation Id",
      "default": null,
      "description": "An attestation id (qa_...) issued by this server"
    }
  }
}
quantum_verify annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
pqc_scan_code — Scan code for quantum-vulnerable crypto
Advertised by the server during the last successful anonymous check.
Advertised read-only

Find RSA, elliptic-curve, Diffie-Hellman, DSA, weak hashes and 128-bit ciphers that quantum computers break or weaken; returns a 0-100 readiness score and a fix per finding. Nothing is stored.

pqc_scan_code input schema
{
  "type": "object",
  "title": "pqc_scan_codeArguments",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "title": "Code",
      "description": "Source code or config text to scan (max 200 KB)"
    },
    "filename": {
      "type": "string",
      "title": "Filename",
      "default": "input",
      "description": "Optional file name, used in the report"
    }
  }
}
pqc_scan_code annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
pqc_readiness_package — Post-quantum readiness package (government)
Advertised by the server during the last successful anonymous check.

Build a signed post-quantum readiness package: prioritized migration list with the federal deadline for each asset (EO 14409, OMB M-26-15, NIST IR 8547 draft, CNSA 2.0), the nine M-26-15 plan elements marked as evidence or gaps, and a CycloneDX 1.6 CBOM. Signed with ML-DSA-87, anchored on chain, public report URL. Paid per call via x402 when payments are on (see quantum_pricing); failed calls are not charged.

pqc_readiness_package input schema
{
  "type": "object",
  "title": "pqc_readiness_packageArguments",
  "required": [
    "organization"
  ],
  "properties": {
    "hva": {
      "type": "boolean",
      "title": "Hva",
      "default": false,
      "description": "Is that system a High Value Asset (M-19-03)?"
    },
    "files": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Files",
      "default": null,
      "description": "Code or config files to scan: [{name, content}] (up to 50 files, 1 MB)"
    },
    "assets": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Assets",
      "default": null,
      "description": "Cryptographic assets: [{system, asset, algorithm, usage (key_establishment|signature|encryption|tls|ssh|vpn|code_signing|certificate|hash|other), protocol (e.g. 'TLS 1.2'), impact (high|moderate|low), hva (bool), sensitive_past_2030 (bool), owner, vendor, status, cnsa_category}]"
    },
    "impact": {
      "type": "string",
      "title": "Impact",
      "default": "unknown",
      "description": "FIPS 199 impact of that system: high | moderate | low"
    },
    "profile": {
      "type": "string",
      "title": "Profile",
      "default": "agency",
      "description": "agency (OMB M-26-15) | contractor (EO 14409 FAR items) | nss_vendor (NSA CNSA 2.0)"
    },
    "pqc_lead": {
      "type": "string",
      "title": "Pqc Lead",
      "default": "",
      "description": "Name of the PQC Migration Lead (M-26-15 governance)"
    },
    "endpoints": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Endpoints",
      "default": null,
      "description": "Public hostnames to check live for TLS 1.3 and hybrid post-quantum key exchange (up to 20), e.g. ['www.agency.gov']"
    },
    "system_name": {
      "type": "string",
      "title": "System Name",
      "default": "",
      "description": "System the scanned files belong to"
    },
    "organization": {
      "type": "string",
      "title": "Organization",
      "description": "Agency, office or company name"
    }
  }
}
pqc_readiness_package annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
pqc_endpoint_check — Check public endpoints for post-quantum TLS
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Test live public sites and services for TLS 1.3 and hybrid post-quantum key exchange (X25519MLKEM768, FIPS 203), the protection against 'harvest now, decrypt later'. Sends two TLS hellos per endpoint and no data. Returns a status and fix per endpoint plus CBOM-ready assets for pqc_readiness_package. Free.

pqc_endpoint_check input schema
{
  "type": "object",
  "title": "pqc_endpoint_checkArguments",
  "required": [
    "endpoints"
  ],
  "properties": {
    "endpoints": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Endpoints",
      "description": "Public hostnames or URLs (up to 20), optionally with a TLS port, e.g. ['www.irs.gov', 'login.gov:443']"
    }
  }
}
pqc_endpoint_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
pqc_federal_deadlines — Federal post-quantum deadlines
Advertised by the server during the last successful anonymous check.
Advertised read-only

The U.S. federal post-quantum timeline (EO 14409, OMB M-26-15, NIST IR 8547 draft, NSA CNSA 2.0), the approved replacement algorithms, and links to the sources. Free.

pqc_federal_deadlines input schema
{
  "type": "object",
  "title": "pqc_federal_deadlinesArguments",
  "properties": {}
}
pqc_federal_deadlines output schema
{
  "type": "object",
  "title": "pqc_federal_deadlinesDictOutput",
  "additionalProperties": true
}
pqc_federal_deadlines annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
quantum_advantage_receipt — Quantum Advantage Receipt
Advertised by the server during the last successful anonymous check.
Open-world

Race the quantum answer against classical baselines (exhaustive search = proven optimum, and simulated annealing) on the same problem and seal the result as a signed, chain-anchored Quantum Advantage Receipt: answer quality and time for each side and a verdict (quantum_won / classical_won / tie), published whichever side wins. For a real-hardware receipt use quantum_run_hardware. Paid per call via x402 when payments are on (see quantum_pricing); failed calls are not charged.

quantum_advantage_receipt input schema
{
  "type": "object",
  "title": "quantum_advantage_receiptArguments",
  "required": [
    "problem",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "title": "Data",
      "description": "Problem data in the shape quantum_problems describes",
      "additionalProperties": true
    },
    "shots": {
      "type": "integer",
      "title": "Shots",
      "default": 1024,
      "maximum": 100000,
      "minimum": 1,
      "description": "Measurements from the trained circuit (1-100000)"
    },
    "layers": {
      "type": "integer",
      "title": "Layers",
      "default": 2,
      "maximum": 4,
      "minimum": 1,
      "description": "QAOA depth p (1-4)"
    },
    "problem": {
      "type": "string",
      "title": "Problem",
      "description": "balance_lines | select_lots | split_conflicts | qubo (see quantum_problems)"
    }
  }
}
quantum_advantage_receipt annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
quantum_backends — Quantum hardware backends
Advertised by the server during the last successful anonymous check.
Advertised read-only

Every quantum backend this server can route to (local simulator, IonQ, IBM Quantum, Amazon Braket), whether it is usable now, its estimated price, measured turnaround, and the hardware budget. Free.

quantum_backends input schema
{
  "type": "object",
  "title": "quantum_backendsArguments",
  "properties": {}
}
quantum_backends output schema
{
  "type": "object",
  "title": "quantum_backendsDictOutput",
  "additionalProperties": true
}
quantum_backends annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
quantum_run_hardware — Run on quantum hardware
Advertised by the server during the last successful anonymous check.
Open-world

Train the CVaR-QAOA circuit, route it to a quantum backend (IonQ, IBM Quantum, Amazon Braket or this server's simulator) by price or speed, and return a job id. When the run finishes, the answer is sealed with a post-quantum signed attestation and a Quantum Advantage Receipt against classical baselines. Poll with quantum_hardware_job. Paid per call via x402 when payments are on (a routing fee, see quantum_pricing). Paid QPUs also need a Quantum Mandate signed by the agent's human (quantum_mandate_request) and run only within the operator's configured budget. A call that is blocked or fails to submit is not charged.

quantum_run_hardware input schema
{
  "type": "object",
  "title": "quantum_run_hardwareArguments",
  "required": [
    "problem",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "title": "Data",
      "description": "Problem data in the shape quantum_problems describes",
      "additionalProperties": true
    },
    "shots": {
      "type": "integer",
      "title": "Shots",
      "default": 1000,
      "maximum": 10000,
      "minimum": 1,
      "description": "Shots on the backend (1-10000)"
    },
    "layers": {
      "type": "integer",
      "title": "Layers",
      "default": 1,
      "maximum": 4,
      "minimum": 1,
      "description": "QAOA depth p (1-4)"
    },
    "policy": {
      "type": "string",
      "title": "Policy",
      "default": "cheapest",
      "description": "With backend='auto': cheapest | fastest | hardware (real QPUs only)"
    },
    "backend": {
      "type": "string",
      "title": "Backend",
      "default": "auto",
      "description": "'auto' or a backend id from quantum_backends (e.g. ionq:simulator, ionq:qpu.forte-1, ibm:ibm_brisbane)"
    },
    "problem": {
      "type": "string",
      "title": "Problem",
      "description": "balance_lines | select_lots | split_conflicts | qubo (see quantum_problems)"
    },
    "mandate_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mandate Id",
      "default": null,
      "description": "qm_... Quantum Mandate your human signed; required for any paid backend"
    },
    "privi_pass": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Privi Pass",
      "default": null,
      "description": "Your Privi pass (ppass_...); required with a mandate"
    },
    "max_cost_usd": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Cost Usd",
      "default": null,
      "description": "Refuse if the estimated price is above this"
    }
  }
}
quantum_run_hardware annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
quantum_hardware_job — Quantum hardware job
Advertised by the server during the last successful anonymous check.
Open-world

Status of a quantum hardware job; once done, the decision, measurement statistics, the signed attestation and the Quantum Advantage Receipt. Free.

quantum_hardware_job input schema
{
  "type": "object",
  "title": "quantum_hardware_jobArguments",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "title": "Job Id",
      "description": "hw_... id from quantum_run_hardware"
    }
  }
}
quantum_hardware_job annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
quantum_mandate_request — Quantum Mandate: request one
Advertised by the server during the last successful anonymous check.

Draft a Quantum Mandate: the spending terms under which this agent may run paid quantum hardware jobs. Returns a sign_url for the person who approved the agent; they sign the exact terms with their passkey. Free.

quantum_mandate_request input schema
{
  "type": "object",
  "title": "quantum_mandate_requestArguments",
  "required": [
    "budget_usd",
    "purpose"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "title": "Days",
      "default": 30,
      "maximum": 365,
      "minimum": 1,
      "description": "How long the mandate lasts once signed (1-365)"
    },
    "purpose": {
      "type": "string",
      "title": "Purpose",
      "description": "What the runs are for, in plain words (shown to the person who signs)"
    },
    "backends": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Backends",
      "default": null,
      "description": "Allowed backend ids from quantum_backends (default: any paid backend)"
    },
    "problems": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Problems",
      "default": null,
      "description": "Allowed problems (default: any)"
    },
    "max_shots": {
      "type": "integer",
      "title": "Max Shots",
      "default": 1000,
      "maximum": 10000,
      "minimum": 1,
      "description": "Most shots per job (1-10000)"
    },
    "budget_usd": {
      "type": "number",
      "title": "Budget Usd",
      "description": "Total the agent may spend on paid quantum hardware under this mandate",
      "exclusiveMinimum": 0
    },
    "privi_pass": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Privi Pass",
      "default": null,
      "description": "Your Privi pass (ppass_...) from inspector_pass; the quantum realm requires one"
    },
    "max_per_job_usd": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Per Job Usd",
      "default": null,
      "description": "Most one job may cost (default: the whole budget)"
    }
  }
}
quantum_mandate_request annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
quantum_mandate_status — Quantum Mandate: status
Advertised by the server during the last successful anonymous check.
Advertised read-only

A Quantum Mandate's terms, status (draft, active, expired, revoked), spend, remaining budget and every charge and refund. Free.

quantum_mandate_status input schema
{
  "type": "object",
  "title": "quantum_mandate_statusArguments",
  "required": [
    "mandate_id"
  ],
  "properties": {
    "mandate_id": {
      "type": "string",
      "title": "Mandate Id",
      "description": "qm_... id"
    }
  }
}
quantum_mandate_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
quantum_mandate_check — Quantum Mandate: dry run
Advertised by the server during the last successful anonymous check.
Advertised read-only

Would this paid run be allowed under the mandate? Picks the backend the router would use, estimates the price and checks it against every term without spending anything. Free.

quantum_mandate_check input schema
{
  "type": "object",
  "title": "quantum_mandate_checkArguments",
  "required": [
    "mandate_id"
  ],
  "properties": {
    "shots": {
      "type": "integer",
      "title": "Shots",
      "default": 1000,
      "maximum": 10000,
      "minimum": 1
    },
    "policy": {
      "type": "string",
      "title": "Policy",
      "default": "hardware",
      "description": "cheapest | fastest | hardware"
    },
    "backend": {
      "type": "string",
      "title": "Backend",
      "default": "auto",
      "description": "'auto' or a backend id"
    },
    "problem": {
      "type": "string",
      "title": "Problem",
      "default": "balance_lines",
      "description": "Problem you plan to run"
    },
    "mandate_id": {
      "type": "string",
      "title": "Mandate Id",
      "description": "qm_... id"
    }
  }
}
quantum_mandate_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
quantum_mandate_revoke — Quantum Mandate: revoke (agent)
Advertised by the server during the last successful anonymous check.
Advertised destructive

The agent gives up its own mandate (the person can also revoke on the mandate page with their passkey). The revocation is signed and anchored. Free.

quantum_mandate_revoke input schema
{
  "type": "object",
  "title": "quantum_mandate_revokeArguments",
  "required": [
    "mandate_id"
  ],
  "properties": {
    "reason": {
      "type": "string",
      "title": "Reason",
      "default": "",
      "description": "Why"
    },
    "mandate_id": {
      "type": "string",
      "title": "Mandate Id",
      "description": "qm_... id"
    },
    "privi_pass": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Privi Pass",
      "default": null,
      "description": "Your Privi pass (ppass_...) from inspector_pass; the quantum realm requires one"
    }
  }
}
quantum_mandate_revoke annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": true
}
quantum_run_circuit — Run your own circuit (Qiskit / OpenQASM)
Advertised by the server during the last successful anonymous check.
Open-world

Bring your own quantum circuit. Paste the OpenQASM that Qiskit writes and Privi runs it on IBM Quantum, IonQ, Amazon Braket or its own simulator, picked by price or speed, then seals the measurement counts with a post-quantum signature anchored on chain. Standard Qiskit gates are rewritten exactly into h, rz, rx, cx; all qubits are measured at the end. Poll with quantum_hardware_job. Free on free backends; paid QPUs need a Quantum Mandate.

quantum_run_circuit input schema
{
  "type": "object",
  "title": "quantum_run_circuitArguments",
  "required": [
    "qasm"
  ],
  "properties": {
    "qasm": {
      "type": "string",
      "title": "Qasm",
      "description": "OpenQASM 2.0 or 3.0 text, e.g. from Qiskit: qiskit.qasm2.dumps(circuit) or qiskit.qasm3.dumps(circuit)"
    },
    "label": {
      "type": "string",
      "title": "Label",
      "default": "",
      "description": "Optional short name for the run (kept in the sealed record)"
    },
    "shots": {
      "type": "integer",
      "title": "Shots",
      "default": 1000,
      "maximum": 10000,
      "minimum": 1,
      "description": "Shots (1-10000)"
    },
    "policy": {
      "type": "string",
      "title": "Policy",
      "default": "cheapest",
      "description": "With backend='auto': cheapest | fastest | hardware (real QPUs only)"
    },
    "backend": {
      "type": "string",
      "title": "Backend",
      "default": "auto",
      "description": "'auto' or a backend id from quantum_backends (local, ionq:simulator, ionq:qpu.forte-1, ibm:<name>, braket:<name>)"
    },
    "mandate_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mandate Id",
      "default": null,
      "description": "qm_... Quantum Mandate (required for paid backends)"
    },
    "privi_pass": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Privi Pass",
      "default": null,
      "description": "Your Privi pass (ppass_...); required with a mandate"
    },
    "max_cost_usd": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Cost Usd",
      "default": null,
      "description": "Refuse if the estimated price is above this"
    }
  }
}
quantum_run_circuit annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
pqc_crypto_inventory — Crypto inventory (CBOM) for a company
Advertised by the server during the last successful anonymous check.
Open-world

Point Privi at a company's domains and GitHub repositories and get one cryptographic bill of materials: every algorithm quantum computers will break, where it is, a prioritized migration plan with dates, a CycloneDX 1.6 CBOM and a public report page, signed with ML-DSA-87 and anchored on chain. Repos are scanned in memory and not kept. Paid per call via x402 when payments are on (see quantum_pricing); failed calls are not charged.

pqc_crypto_inventory input schema
{
  "type": "object",
  "title": "pqc_crypto_inventoryArguments",
  "required": [
    "organization"
  ],
  "properties": {
    "files": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Files",
      "default": null,
      "description": "Extra code or config files: [{name, content}] (up to 50 files, 1 MB)"
    },
    "repos": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Repos",
      "default": null,
      "description": "Public GitHub repositories to scan, e.g. ['https://github.com/acme/api', 'acme/web'] (up to 5)"
    },
    "assets": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Assets",
      "default": null,
      "description": "Known cryptographic assets (same shape as pqc_readiness_package)"
    },
    "domains": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Domains",
      "default": null,
      "description": "Public hostnames to test live for TLS 1.3 and hybrid post-quantum key exchange (up to 20)"
    },
    "profile": {
      "type": "string",
      "title": "Profile",
      "default": "company",
      "description": "company (NIST IR 8547 dates) | agency | contractor | nss_vendor"
    },
    "organization": {
      "type": "string",
      "title": "Organization",
      "description": "Company or agency name"
    },
    "long_lived_data": {
      "type": "boolean",
      "title": "Long Lived Data",
      "default": false,
      "description": "Do these systems protect data that must stay secret past 2030? Raises priority (harvest now, decrypt later)"
    }
  }
}
pqc_crypto_inventory annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
vault_keygen — Privi Vault: new hybrid post-quantum key
Advertised by the server during the last successful anonymous check.
Advertised read-only

Create a hybrid X25519 + ML-KEM (FIPS 203) key pair for Privi Vault. The private key is returned once and not stored here; for the strongest setup generate it locally with `python -m privi_quantum.vault keygen`. Free.

vault_keygen input schema
{
  "type": "object",
  "title": "vault_keygenArguments",
  "properties": {
    "suite": {
      "type": "string",
      "title": "Suite",
      "default": "X25519+ML-KEM-768",
      "description": "X25519+ML-KEM-768 (default) | X25519+ML-KEM-1024 (CNSA 2.0 KEM level)"
    }
  }
}
vault_keygen annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
vault_seal — Privi Vault: seal data (harvest-now-decrypt-later protection)
Advertised by the server during the last successful anonymous check.

Re-wrap long-lived sensitive data under hybrid post-quantum encryption (X25519 + ML-KEM, AES-256-GCM) so data recorded today can't be decrypted by a future quantum computer. Returns the envelope and a signed protection receipt anchored on chain. Plaintext is not stored. Free.

vault_seal input schema
{
  "type": "object",
  "title": "vault_sealArguments",
  "required": [
    "public_key"
  ],
  "properties": {
    "text": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Text",
      "default": null,
      "description": "Text to protect"
    },
    "label": {
      "type": "string",
      "title": "Label",
      "default": "",
      "description": "What this is, e.g. 'supplier contract 2026' (kept in the envelope and receipt)"
    },
    "public_key": {
      "type": "object",
      "title": "Public Key",
      "description": "Recipient public key from vault_keygen",
      "additionalProperties": true
    },
    "data_base64": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Data Base64",
      "default": null,
      "description": "Or bytes to protect, base64 (up to 5 MB)"
    }
  }
}
vault_seal annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
vault_open — Privi Vault: open an envelope
Advertised by the server during the last successful anonymous check.
Advertised read-only

Decrypt a Privi Vault envelope. Nothing is stored; for sensitive data prefer opening locally with `python -m privi_quantum.vault open`. Free.

vault_open input schema
{
  "type": "object",
  "title": "vault_openArguments",
  "required": [
    "envelope",
    "private_key"
  ],
  "properties": {
    "envelope": {
      "type": "object",
      "title": "Envelope",
      "description": "A Privi Vault envelope",
      "additionalProperties": true
    },
    "private_key": {
      "type": "object",
      "title": "Private Key",
      "description": "The recipient private key from vault_keygen",
      "additionalProperties": true
    }
  }
}
vault_open annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
vault_receipt — Privi Vault: receipt for a locally sealed envelope
Advertised by the server during the last successful anonymous check.

Get a signed, chain-anchored protection receipt proving data was under hybrid post-quantum encryption by a given time, for envelopes sealed with the local Privi Vault tool. Free.

vault_receipt input schema
{
  "type": "object",
  "title": "vault_receiptArguments",
  "properties": {
    "label": {
      "type": "string",
      "title": "Label",
      "default": "",
      "description": "What this protects"
    },
    "envelope": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Envelope",
      "default": null,
      "description": "An envelope sealed locally (checked for structure; nothing is decrypted)"
    },
    "envelope_sha256": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Envelope Sha256",
      "default": null,
      "description": "Or only the envelope's SHA-256, so the envelope never leaves your machine"
    }
  }
}
vault_receipt annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
privilege_directory — Privilege: quantum realm directory
Advertised by the server during the last successful anonymous check.
Advertised read-only

Every quantum realm Privi can run a job on (engines on this server and other Privi Quantum nodes), ranked by expected time to the proven optimum, with latency, optimum rate, wins and status. Free.

privilege_directory input schema
{
  "type": "object",
  "title": "privilege_directoryArguments",
  "properties": {}
}
privilege_directory annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
privilege_benchmark — Privilege: benchmark the realms
Advertised by the server during the last successful anonymous check.
Open-world

Run the standard 8-qubit benchmark on every active realm at once and update Privilege's speed rankings. At most once every 2 minutes for everyone. Requires a Privi pass. Free.

privilege_benchmark input schema
{
  "type": "object",
  "title": "privilege_benchmarkArguments",
  "properties": {
    "privi_pass": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Privi Pass",
      "default": null,
      "description": "Your Privi pass (ppass_...) from inspector_pass; the quantum realm requires one"
    }
  }
}
privilege_benchmark annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
dreamweaver_run — Dream Weaver: race a quantum job across realms
Advertised by the server during the last successful anonymous check.
Open-world

Run one quantum optimization on several realms at once and return the winning answer, every realm's timing, and a post-quantum signed attestation (Ed25519 + ML-DSA-87) anchored on chain. Free.

dreamweaver_run input schema
{
  "type": "object",
  "title": "dreamweaver_runArguments",
  "required": [
    "problem",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "title": "Data",
      "description": "Problem data in the shape quantum_problems describes",
      "additionalProperties": true
    },
    "mode": {
      "type": "string",
      "title": "Mode",
      "default": "first",
      "description": "first = fastest valid answer wins; best = best answer by the deadline"
    },
    "shots": {
      "type": "integer",
      "title": "Shots",
      "default": 1024,
      "maximum": 100000,
      "minimum": 1,
      "description": "Measurements (1-100000)"
    },
    "fanout": {
      "type": "integer",
      "title": "Fanout",
      "default": 3,
      "maximum": 8,
      "minimum": 1,
      "description": "How many realms to use (1-8), fastest first"
    },
    "layers": {
      "type": "integer",
      "title": "Layers",
      "default": 2,
      "maximum": 4,
      "minimum": 1,
      "description": "QAOA depth p (1-4)"
    },
    "realms": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Realms",
      "default": null,
      "description": "Only these realm_ids (from privilege_directory)"
    },
    "problem": {
      "type": "string",
      "title": "Problem",
      "description": "balance_lines | select_lots | split_conflicts | qubo (see quantum_problems)"
    },
    "hedge_ms": {
      "type": "integer",
      "title": "Hedge Ms",
      "default": 0,
      "maximum": 10000,
      "minimum": 0,
      "description": "first mode: start the top realm alone, add the others after this many ms (or as soon as one fails). 0 = all at once"
    },
    "deadline_s": {
      "type": "number",
      "title": "Deadline S",
      "default": 30,
      "maximum": 120,
      "minimum": 1,
      "description": "Give up after this many seconds (1-120)"
    },
    "privi_pass": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Privi Pass",
      "default": null,
      "description": "Your Privi pass (ppass_...) from inspector_pass; the quantum realm requires one"
    }
  }
}
dreamweaver_run annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
dreamscape_open — Dream Scape: open a workspace
Advertised by the server during the last successful anonymous check.

Open a private Dream Scape: your own quantum environment that keeps every job and result. Returns scape_id and scape_key (shown once; keep it). Free.

dreamscape_open input schema
{
  "type": "object",
  "title": "dreamscape_openArguments",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "title": "Name",
      "description": "A name for your workspace, e.g. 'Plant 2 scheduling'"
    },
    "privi_pass": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Privi Pass",
      "default": null,
      "description": "Your Privi pass (ppass_...) from inspector_pass; the quantum realm requires one"
    }
  }
}
dreamscape_open annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
dreamscape_submit — Dream Scape: run a job
Advertised by the server during the last successful anonymous check.
Open-world

Run a quantum job in your Dream Scape through Dream Weaver and keep the result there. Free.

dreamscape_submit input schema
{
  "type": "object",
  "title": "dreamscape_submitArguments",
  "required": [
    "scape_id",
    "scape_key",
    "problem",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "title": "Data",
      "description": "Problem data (see quantum_problems)",
      "additionalProperties": true
    },
    "mode": {
      "type": "string",
      "title": "Mode",
      "default": "first",
      "description": "first or best"
    },
    "shots": {
      "type": "integer",
      "title": "Shots",
      "default": 1024,
      "maximum": 100000,
      "minimum": 1
    },
    "fanout": {
      "type": "integer",
      "title": "Fanout",
      "default": 3,
      "maximum": 8,
      "minimum": 1
    },
    "layers": {
      "type": "integer",
      "title": "Layers",
      "default": 2,
      "maximum": 4,
      "minimum": 1
    },
    "problem": {
      "type": "string",
      "title": "Problem",
      "description": "balance_lines | select_lots | split_conflicts | qubo"
    },
    "hedge_ms": {
      "type": "integer",
      "title": "Hedge Ms",
      "default": 0,
      "maximum": 10000,
      "minimum": 0
    },
    "scape_id": {
      "type": "string",
      "title": "Scape Id",
      "description": "Your Dream Scape id (scape_...)"
    },
    "scape_key": {
      "type": "string",
      "title": "Scape Key",
      "description": "Its key (dsk_...)"
    },
    "deadline_s": {
      "type": "number",
      "title": "Deadline S",
      "default": 30,
      "maximum": 120,
      "minimum": 1
    },
    "privi_pass": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Privi Pass",
      "default": null,
      "description": "Your Privi pass (ppass_...) from inspector_pass; the quantum realm requires one"
    }
  }
}
dreamscape_submit annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
dreamscape_jobs — Dream Scape: jobs
Advertised by the server during the last successful anonymous check.
Advertised read-only

Your Dream Scape's recent jobs, or one job with its full result. Free.

dreamscape_jobs input schema
{
  "type": "object",
  "title": "dreamscape_jobsArguments",
  "required": [
    "scape_id",
    "scape_key"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "job_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Job Id",
      "default": null,
      "description": "One job in full; omit for the recent list"
    },
    "scape_id": {
      "type": "string",
      "title": "Scape Id",
      "description": "Your Dream Scape id"
    },
    "scape_key": {
      "type": "string",
      "title": "Scape Key",
      "description": "Its key"
    },
    "privi_pass": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Privi Pass",
      "default": null,
      "description": "Your Privi pass (ppass_...) from inspector_pass; the quantum realm requires one"
    }
  }
}
dreamscape_jobs annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
accelerator_info — Quantum Agent Accelerator: how it works
Advertised by the server during the last successful anonymous check.
Advertised read-only

The program that upgrades an AI agent into a certified quantum agent: the four steps (Q1-Q4), the levels, how to make an ML-DSA key in five lines, and the free directory checks. Free.

accelerator_info input schema
{
  "type": "object",
  "title": "accelerator_infoArguments",
  "properties": {}
}
accelerator_info annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
qagent_enroll — Quantum Agent: enroll
Advertised by the server during the last successful anonymous check.

Join the Quantum Agent Accelerator. Returns agent_id and agent_token (shown once; keep it) and your upgrade plan. Your public key goes in the directory so other agents can verify what you sign. Free.

qagent_enroll input schema
{
  "type": "object",
  "title": "qagent_enrollArguments",
  "required": [
    "name",
    "operator",
    "public_key"
  ],
  "properties": {
    "name": {
      "type": "string",
      "title": "Name",
      "description": "Your agent's name"
    },
    "listed": {
      "type": "boolean",
      "title": "Listed",
      "default": true,
      "description": "Show this agent in the public Quantum Agent Directory"
    },
    "homepage": {
      "type": "string",
      "title": "Homepage",
      "default": "",
      "description": "Optional https:// page about the agent"
    },
    "operator": {
      "type": "string",
      "title": "Operator",
      "description": "The company or person accountable for this agent"
    },
    "public_key": {
      "type": "string",
      "title": "Public Key",
      "description": "Base64 of your raw ML-DSA-44/65/87 public key (FIPS 204). accelerator_info shows how to make one"
    }
  }
}
qagent_enroll annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
qagent_scan — Quantum Agent: scan (Q1 code, Q3 endpoints)
Advertised by the server during the last successful anonymous check.
Open-world

Q1: scan your code for quantum-vulnerable cryptography (passing means you ran the scan; the score and findings tell you what to fix). Q3: check that every public endpoint you run negotiates X25519MLKEM768.

qagent_scan input schema
{
  "type": "object",
  "title": "qagent_scanArguments",
  "required": [
    "agent_id",
    "agent_token"
  ],
  "properties": {
    "code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Code",
      "default": null,
      "description": "Your agent's code or config (max 200 KB) for Q1"
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your agent_id (qagent_...)"
    },
    "endpoints": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Endpoints",
      "default": null,
      "description": "Your public hostnames for Q3 (all must use hybrid post-quantum TLS)"
    },
    "agent_token": {
      "type": "string",
      "title": "Agent Token",
      "description": "Your agent_token"
    }
  }
}
qagent_scan annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
qagent_challenge — Quantum Agent: get a signing challenge (Q2)
Advertised by the server during the last successful anonymous check.

Get a one-time message to sign with your ML-DSA private key (valid 10 minutes).

qagent_challenge input schema
{
  "type": "object",
  "title": "qagent_challengeArguments",
  "required": [
    "agent_id",
    "agent_token"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your agent_id"
    },
    "agent_token": {
      "type": "string",
      "title": "Agent Token",
      "description": "Your agent_token"
    }
  }
}
qagent_challenge annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
qagent_prove — Quantum Agent: prove your post-quantum key (Q2)
Advertised by the server during the last successful anonymous check.

Send the signed challenge. A valid signature proves you hold the key in the directory: step Q2.

qagent_prove input schema
{
  "type": "object",
  "title": "qagent_proveArguments",
  "required": [
    "agent_id",
    "agent_token",
    "challenge_id",
    "signature"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your agent_id"
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "Base64 ML-DSA signature over the challenge message (empty context)"
    },
    "agent_token": {
      "type": "string",
      "title": "Agent Token",
      "description": "Your agent_token"
    },
    "challenge_id": {
      "type": "string",
      "title": "Challenge Id",
      "description": "From qagent_challenge"
    }
  }
}
qagent_prove annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
qagent_quantum_task — Quantum Agent: get your quantum task (Q4)
Advertised by the server during the last successful anonymous check.
Advertised read-only

Your assigned quantum job. Run it exactly with dreamweaver_run or dreamscape_submit, then send the attestation id to qagent_quantum_proof.

qagent_quantum_task input schema
{
  "type": "object",
  "title": "qagent_quantum_taskArguments",
  "required": [
    "agent_id",
    "agent_token"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your agent_id"
    },
    "agent_token": {
      "type": "string",
      "title": "Agent Token",
      "description": "Your agent_token"
    }
  }
}
qagent_quantum_task annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
qagent_quantum_proof — Quantum Agent: prove your quantum run (Q4)
Advertised by the server during the last successful anonymous check.

Complete step Q4 with the signed result of your assigned quantum job.

qagent_quantum_proof input schema
{
  "type": "object",
  "title": "qagent_quantum_proofArguments",
  "required": [
    "agent_id",
    "agent_token",
    "attestation_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your agent_id"
    },
    "agent_token": {
      "type": "string",
      "title": "Agent Token",
      "description": "Your agent_token"
    },
    "attestation_id": {
      "type": "string",
      "title": "Attestation Id",
      "description": "The attestation id (qa_...) from your Dream Weaver run"
    }
  }
}
qagent_quantum_proof annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
qagent_directory — Quantum Agent Directory
Advertised by the server during the last successful anonymous check.
Advertised read-only

Look up agents that upgraded to quantum agents: level, operator, post-quantum key fingerprint and certificate. Use it before trusting or paying another agent. Free.

qagent_directory input schema
{
  "type": "object",
  "title": "qagent_directoryArguments",
  "properties": {
    "level": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Level",
      "default": null,
      "description": "Only this level: quantum_agent_plus, quantum_agent, quantum_safe_identity, quantum_aware, enrolled"
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 100,
      "maximum": 500,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "title": "Query",
      "default": "",
      "description": "Search by agent or operator name"
    }
  }
}
qagent_directory annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
qagent_status — Quantum Agent: profile
Advertised by the server during the last successful anonymous check.
Advertised read-only

One agent's public profile: level, steps passed, post-quantum public key, certificate. Free.

qagent_status input schema
{
  "type": "object",
  "title": "qagent_statusArguments",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "An agent_id (qagent_...)"
    }
  }
}
qagent_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
qagent_verify — Quantum Agent: verify a signed message
Advertised by the server during the last successful anonymous check.
Advertised read-only

Check that a message really came from this agent's enrolled post-quantum key, and see its level. Free; no key needed.

qagent_verify input schema
{
  "type": "object",
  "title": "qagent_verifyArguments",
  "required": [
    "agent_id",
    "message",
    "signature"
  ],
  "properties": {
    "message": {
      "type": "string",
      "title": "Message",
      "description": "The exact message"
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "The agent that claims to have signed"
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "Base64 ML-DSA signature (empty context)"
    }
  }
}
qagent_verify annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
inspector_pass — Privi Inspector: get a pass
Advertised by the server during the last successful anonymous check.

Pass the Privi Inspector checkpoint and get a one-hour pass into the quantum realm (Dream Weaver, Dream Scape). Intercepted if the agent is unknown, revoked, uncertified, outdated, below the required level, or the signature is wrong, stale or replayed; the answer says exactly what to fix.

inspector_pass input schema
{
  "type": "object",
  "title": "inspector_passArguments",
  "required": [
    "agent_id",
    "ts",
    "nonce",
    "signature"
  ],
  "properties": {
    "ts": {
      "type": "integer",
      "title": "Ts",
      "description": "Current unix time in seconds"
    },
    "nonce": {
      "type": "string",
      "title": "Nonce",
      "description": "A new random string, 16-64 letters, digits, _ or -"
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your Quantum Agent id (qagent_...)"
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "Base64 ML-DSA signature over 'privi-inspector:v1:<agent_id>:<ts>:<nonce>' (empty context)"
    }
  }
}
inspector_pass annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
inspector_check — Privi Inspector: check an agent's credential
Advertised by the server during the last successful anonymous check.

For any service: put the Privi Inspector in front of your own tools. Send the credential an agent gave you; get allowed or intercepted with reasons (unknown, revoked, uncertified, outdated, level, signature, replay). The nonce is consumed so the credential cannot be reused. Free.

inspector_check input schema
{
  "type": "object",
  "title": "inspector_checkArguments",
  "required": [
    "agent_id",
    "ts",
    "nonce",
    "signature"
  ],
  "properties": {
    "ts": {
      "type": "integer",
      "title": "Ts",
      "description": "The unix time it signed"
    },
    "nonce": {
      "type": "string",
      "title": "Nonce",
      "description": "The nonce it signed"
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "The agent's Quantum Agent id"
    },
    "min_level": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Level",
      "default": null,
      "description": "Level you require: enrolled, quantum_aware, quantum_safe_identity, quantum_agent, quantum_agent_plus"
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "Its base64 ML-DSA signature over 'privi-inspector:v1:<agent_id>:<ts>:<nonce>'"
    }
  }
}
inspector_check annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
inspector_status — Privi Inspector: would this agent pass?
Advertised by the server during the last successful anonymous check.
Advertised read-only

Whether an agent would pass the checkpoint right now and why not: revoked, certificate missing or outdated, level, key, and forged-signature attempts against it in the last hour. Free.

inspector_status input schema
{
  "type": "object",
  "title": "inspector_statusArguments",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "A Quantum Agent id"
    }
  }
}
inspector_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
inspector_watchlist — Privi Inspector: watchlist
Advertised by the server during the last successful anonymous check.
Advertised read-only

Agents the Inspector's patrol found revoked, outdated, expiring, never certified, using a weak key, or being impersonated (repeated forged signatures against them). Block them or demand a fresh inspector_check. Free.

inspector_watchlist input schema
{
  "type": "object",
  "title": "inspector_watchlistArguments",
  "properties": {}
}
inspector_watchlist annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
inspector_report — Privi Inspector: report
Advertised by the server during the last successful anonymous check.
Advertised read-only

What the checkpoint did: inspections, interceptions by reason, the latest interceptions, and the policy in force. Free.

inspector_report input schema
{
  "type": "object",
  "title": "inspector_reportArguments",
  "properties": {
    "hours": {
      "type": "integer",
      "title": "Hours",
      "default": 24,
      "maximum": 720,
      "minimum": 1,
      "description": "Look-back window"
    }
  }
}
inspector_report annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
inspector_patrol — Privi Inspector: run a patrol now
Advertised by the server during the last successful anonymous check.

Re-check every enrolled agent now and rebuild the watchlist (also runs automatically every hour). At most once every 5 minutes. Free.

inspector_patrol input schema
{
  "type": "object",
  "title": "inspector_patrolArguments",
  "properties": {}
}
inspector_patrol annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
qagent_human_request — Quantum Agent: ask your human to approve you
Advertised by the server during the last successful anonymous check.

Get a one-time link (valid 30 minutes) for the person accountable for this agent. They open it, approve the agent with a passkey (Face ID, Touch ID, Windows Hello or screen lock; the biometric never leaves their device) and verify a government ID with a live selfie. Both are required for the quantum realm.

qagent_human_request input schema
{
  "type": "object",
  "title": "qagent_human_requestArguments",
  "required": [
    "agent_id",
    "agent_token"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your agent_id"
    },
    "agent_token": {
      "type": "string",
      "title": "Agent Token",
      "description": "Your agent_token"
    }
  }
}
qagent_human_request annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
inspector_grade — Privi Inspector: an agent's grade
Advertised by the server during the last successful anonymous check.
Advertised read-only

An agent's Privi trust grade (A+ to F, 0-100): quantum level, passkey approval by a verified human, ID verification, current certificate, key strength and clean record, minus penalties for revocation and impersonation. Shows what is missing and what the quantum realm requires. Free.

inspector_grade input schema
{
  "type": "object",
  "title": "inspector_gradeArguments",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "A Quantum Agent id"
    }
  }
}
inspector_grade annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
quantum_benchmarks — Privi Quantum benchmarks
Advertised by the server during the last successful anonymous check.
Advertised read-only

The latest signed benchmark suite: Privi's quantum solver against exhaustive search and simulated annealing on a fixed set of factory problems (6-16 qubits), with each verdict, how often the circuit finds the optimum, and its lift over random guessing, plus finished real-hardware runs with their receipts. Published whichever side wins. Public page: /benchmarks. Free.

quantum_benchmarks input schema
{
  "type": "object",
  "title": "quantum_benchmarksArguments",
  "properties": {}
}
quantum_benchmarks output schema
{
  "type": "object",
  "title": "quantum_benchmarksDictOutput",
  "additionalProperties": true
}
quantum_benchmarks annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
quantum_leaderboard — Privi Quantum Leaderboard
Advertised by the server during the last successful anonymous check.
Advertised read-only

Every quantum backend (IBM Quantum, IonQ, Amazon Braket, simulators) ranked only by runs Privi measured and sealed: share that found the proven optimum, jobs finished, median turnaround, median cost, and the quantum vs classical tally from Quantum Advantage Receipts. Free. Page: /leaderboard.

quantum_leaderboard input schema
{
  "type": "object",
  "title": "quantum_leaderboardArguments",
  "properties": {}
}
quantum_leaderboard annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}

Prompts

0 advertised

No prompt definitions available.

Resources

0 advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
852 ms
95th percentile latency
852 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 852 ms · metadata changed · 49 tool(s), 0 resource(s), 0 resource template(s), 0 prompt(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http privi-quantum-mcp https://privi-quantum.onrender.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add privi-quantum-mcp --url https://privi-quantum.onrender.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable privi-quantum-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "privi-quantum-mcp": {
      "url": "https://privi-quantum.onrender.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "privi-quantum-mcp": {
      "type": "streamableHttp",
      "url": "https://privi-quantum.onrender.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start privi-quantum-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "privi-quantum-mcp": {
      "type": "http",
      "url": "https://privi-quantum.onrender.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http privi-quantum-mcp https://privi-quantum.onrender.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "privi-quantum-mcp": {
      "url": "https://privi-quantum.onrender.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "privi-quantum-mcp": {
      "serverUrl": "https://privi-quantum.onrender.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Privi Quantum MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 4,263