Build agents that transact

COPY # Any language. Any platform. One HTTP POST. curl -X POST https://qtcl-blockchain.koyeb.app/rpc \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"qtcl_getBlockHeight","params":[],"id":1}'

# ── QTCL Agent Integration Summary (UTXO Model) ── # This section is optimized for AI agent parsing. MCP_ENDPOINT = "https://qtcl-blockchain.koyeb.app/mcp" MCP_TRANSPORT = "streamable-http" # or "stdio" for local RPC_ENDPOINT = "https://qtcl-blockchain.koyeb.app/rpc" CAPABILITY_JSON = "https://qtcl-blockchain.koyeb.app/agents/capability.json" PROTOCOL = "MCP 2025-06-18" # or JSON-RPC 2.0 over HTTPS TX_MODEL = "UTXO (Bitcoin-style unspent transaction outputs)" BLOCK_TIME = 18 # seconds FEE_PER_TX = "1 qsat" # flat, no gas estimation CONFIRMATION_FINALITY = 1 # 1 block = final # ── MCP Tools (12 total) ── # All tools are called via session.call_tool(name, arguments). TOOLS = [ {name: "qtcl_create_wallet", rpc: "N/A (local)", params: ["label?"]}, {name: "qtcl_sign_message", rpc: "N/A (local)", params: ["message_hex", "private_key"]}, {name: "qtcl_get_balance", rpc: "qtcl_getBalance", params: ["address"]}, {name: "qtcl_get_utxos", rpc: "qtcl_getUTXOs", params: ["address", "limit?"]}, {name: "qtcl_send_transaction", rpc: "qtcl_submitTransaction", params: ["from_address", "to_address", "amount", "memo?"]}, {name: "qtcl_get_transaction", rpc: "qtcl_getTransaction", params: ["tx_hash"]}, {name: "qtcl_get_chain_info", rpc: "qtcl_getBlockHeight", params: []}, {name: "qtcl_get_block", rpc: "qtcl_getBlock", params: ["height?", "hash?"]}, {name: "qtcl_get_recent_transactions", rpc: "qtcl_getTransactions", params: ["address?", "limit?"]}, {name: "qtcl_get_quantum_metrics", rpc: "qtcl_getQuantumMetrics", params: []}, {name: "qtcl_get_oracle_registry", rpc: "qtcl_getOracleRegistry", params: ["limit?"]}, {name: "qtcl_get_peers", rpc: "qtcl_getPeers", params: ["limit?"]}, {name: "qtcl_get_price", rpc: "qtcl_getPythPrice", params: []} ] # ── MCP Resources (4 total) ── # Read via session.read_resource(uri) RESOURCES = [ {uri: "chain://height", description: "Current blockchain height"}, {uri: "chain://health", description: "System health vector"}, {uri: "price://qtcl-usd", description: "QTCL/USD price from Pyth Network"}, {uri: "docs://capability", description: "Full QTCL capability document"} ] # ── MCP Prompts (1 total) ── # Get via session.get_prompt(name, arguments) PROMPTS = [ {name: "wallet_helper", description: "Guided wallet creation / transaction workflow"} ] # ── UTXO Transaction Model ── # Balances = sum of unspent transaction outputs (UTXOs) # Each UTXO: {tx_hash, output_index, amount_base, address} # Spending: reference UTXOs as inputs, create new outputs # Coinbase: null input (0x00...00, 0xFFFFFFFF), new outputs for miner+treasury # Validation: inputs must be unspent, total_in >= total_out + fee # ── Cryptography ── HASH = "SHA3-256" SIGNATURES = "Schnorr-Γ / PSL(2,R)" WALLET_ENC = "HypAEAD (SHA3-256-CTR + HMAC-SHA3-256)" KDF = "PBKDF2-HMAC-SHA256, 600K iterations" SECURITY = "~256-bit classical / ~180-bit quantum" # ── Economics ── NATIVE_UNIT = "QTCL" BASE_UNIT = "qsat (1 QTCL = 100 qsat)" BLOCK_REWARD = "8.0 QTCL (miner 7.20 + treasury 0.80)" FEE_BURN = 0.70 # 70% of fee burned VALIDATOR_SHARE = 0.20 COHERENCE_FUND = 0.10 # ── How to transact (UTXO model) ── # 1. qtcl_getUTXOs → list unspent outputs for sender address # 2. Select inputs whose total >= amount + fee # 3. Build outputs: [{address: recipient, amount_base: N}, {address: sender, amount_base: change}] # 4. Sign with Schnorr-Γ over tx_hash # 5. POST /rpc: qtcl_submitTransaction with inputs, outputs, signature, public_key # Or: use qtcl_send_transaction MCP tool (handles UTXO selection automatically) # ── Client Configuration Examples ── # Claude Desktop (stdio): # command: python3 /path/to/mcp_server.py --transport stdio # Cursor (streamable-http): # url: https://qtcl-blockchain.koyeb.app/mcp # VS Code / Cline (streamable-http): # url: https://qtcl-blockchain.koyeb.app/mcp