io.github.shemshallah/qtcl-mcp-server
io.github.shemshallah/qtcl-mcp-server · v8.2.0 · MCP 2025-06-18
Agent-native post-quantum blockchain. 11 tools: send, balance, quantum oracle metrics. Flat fee.
Reachability
reachable
checked 2026-07-14 03:46 UTC
Registry status active
Tools pinned 22
fb4004f51968
Tools last changed
unchanged since first capture 2026-07-14
Provenance
Registry namespace io.github.shemshallah
(GitHub-account verified by the official registry)
Repository
github.com/shemshallah/qtcl-mcp-server
Remote endpoints
https://qtcl-blockchain.koyeb.app/mcp/sse (sse)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-07-14 03:46 | first capture | 22 tools pinned |
Pinned tool definitions (22)
| Tool | Description |
|---|---|
| qtcl_create_wallet | Create a new QTCL post-quantum wallet backed by a real HypΓ keypair (Schnorr-Γ over SL(3,p), 512-step random walk, SHA3-256² address). Returns private_key, public_key, address, and created_at. Store private_key securely — the server... |
| qtcl_sign_message | Sign a 32-byte message hash with a HypΓ private key using Schnorr-Γ. To sign a transaction, compute: SHA3-256(JSON.dumps({"sender": from_addr, "recipient": to_addr, "amount": amount_float, "nonce": nonce_int}, sort_keys=True)) → pass... |
| qtcl_get_balance | Check QTCL balance for any address. Returns balance in base units (qsat), UTXO count, and UTXO list. 1 QTCL = 100 qsat. |
| qtcl_get_utxos | List unspent transaction outputs (UTXOs) for an address. Returns tx_hash, output_index, amount_base per coin. |
| qtcl_send_transaction | Submit a signed UTXO transaction to the QTCL network. Flat fee: 1 qsat. Finality: ~18 seconds. WORKFLOW: (1) pick nonce = int(time.time()*1000) [ms epoch]. (2) build payload = JSON.dumps({sender,recipient,amount,nonce}, sort_keys=True).... |
| qtcl_get_transaction | Look up a QTCL transaction by its SHA3-256 hash. Returns full tx details, status, and block height. |
| qtcl_get_chain_info | Current blockchain state: height, latest block hash, mempool depth, oracle status, and system health vector. |
| qtcl_get_block | Retrieve a block by height (integer) or hash (hex string). Omit both for the latest block. |
| qtcl_get_recent_transactions | List recent transactions, optionally filtered by address. Returns newest first. Max 50 per call. |
| qtcl_get_quantum_metrics | Live quantum coherence metrics: W-state fidelity (≥0.75 healthy), entanglement witness (NPT criterion), oracle consensus round, Mermin inequality test, and kappa=0.11 non-Markovian coherence score. |
| qtcl_get_oracle_registry | List registered quantum oracle nodes participating in 5-oracle Byzantine consensus (3-of-5 majority). |
| qtcl_get_peers | List active P2P peers in the QTCL Kademlia DHT network. |
| qtcl_get_price | QTCL network quantum coherence metrics and valuation signals. Note: QTCL has no public USD exchange. Returns W-state fidelity, entanglement witness, and oracle coherence as network health proxy. |
| qtcl_retro_settle | Retroactively settle all blocks whose UTXOs are missing from address_utxos. Safe to call repeatedly — idempotent. Returns counts of settled/skipped/error blocks. Use this when miner balance is lower than expected after mining blocks. |
| qtcl_repair_utxos | Nuclear UTXO repair: bypasses settlement machinery and directly inserts missing UTXOs from the transactions table. Use when qtcl_retro_settle reports success but UTXOs are still missing. Commits per-UTXO for maximum isolation. Returns... |
| qtcl_submit_block | Submit a fully PoW-solved and HypΓ-signed block to the chain. This is the unified miner submission path. The miner client performs PoW locally, signs the block header, then calls this with the complete payload. Required: height,... |
| qtcl_quantum_encrypt | Quantum-bound encryption via IBM QLDPC hardware (ibm_marrakesh/ibm_kingston). Two modes: quantum_bound (async=false, default): XOR-masks the encapsulated key with a hardware-derived quantum key. Runs synchronously with 8192 shots for... |
| qtcl_quantum_decrypt | Decrypt quantum-bound or quantum-assisted ciphertext. Auto-detects mode from the ciphertext dict: quantum_bound → runs QLDPC pipeline on masked key, XOR-unmasks, decrypts attestation → tries classical first, falls back to... |
| qtcl_quantum_pipeline | Run the full QLDPC pipeline directly on IBM quantum hardware. Encodes ciphertext bytes into a hyperbolic QLDPC code, runs on real IBM hardware (8192 shots), decodes syndromes via BP+OSD, and returns the recovered key fragment. Returns:... |
| qtcl_create_hybrid_wallet | Create a new QTCL wallet with HYBRID post-quantum keys: Falcon-512 (NIST FIPS 206, 128-bit PQ security) + SL(3,p) (~70-bit classical). Returns full keypair dict with both Falcon and SL(3,p) components. Server does NOT retain secret... |
| qtcl_sign_message_hybrid | Sign a 32-byte message hash with HYBRID PQC (Falcon-512 + SL(3,p)). Both Falcon and SL(3,p) signatures are computed independently — verification requires BOTH to be valid. message_hex must be 64 hex chars (SHA3-256 of signing payload).... |
| qtcl_get_pqc_status | Return PQC module status — shows whether Falcon-512 is available, key/signature sizes, security level, and hybrid signature overhead. Use to check if the server supports full hybrid PQ signatures. |
Status badge
[](https://toolpin.dev/servers/io.github.shemshallah/qtcl-mcp-server)
Maintain this server? Add the badge to your README — it links your users to this live status page.