Qtcl MCP Server

What qtcl-mcp-server does

The qtcl-mcp-server MCP server connects MCP-compatible agents to the QTCL blockchain. Its 11 tools cover wallet creation, balance checks, transfers, transaction lookup, block and chain inspection, recent transaction history, quantum metrics, oracle status, peer data, and price information.

Wallet and payment operations use QTCL, with a flat fee of 1 qsat per operation. Transfers can include a memo of up to 256 characters, which supports invoice identifiers, service references, or structured coordination data.

How it works

The hosted service exposes MCP over Server-Sent Events at https://qtcl-blockchain.koyeb.app/mcp/sse. No authentication is required. An MCP client connects to that endpoint and discovers the available tools. The service also provides a health endpoint at /mcp/health.

The blockchain interface includes direct operations rather than an SDK-based workflow. Agents can submit a transaction and receive its hash, then use the transaction or chain tools to inspect its status. Chain information includes block height, mempool depth, and oracle consensus status. Block responses include quantum coherence metrics.

The qtcl-mcp-server MCP server also exposes data from QTCL’s quantum infrastructure. Its tools report W-state fidelity, an entanglement witness, lattice coherence, oracle stake and uptime, oracle heartbeats, and active peer topology. The price tool returns a live QTCL/USD value from the Pyth Network oracle feed.

Setup and configuration

Add the SSE endpoint to an MCP-compatible client. For Claude Desktop, configure a server entry with the URL transport and restart the application. Cursor and VS Code can use an mcp.json entry with type set to sse and the same URL. Other MCP-compatible agents can use the endpoint as a URL-based server.

No environment variables, API keys, wallet extensions, or local SDK installation are specified in the README. The MCP service is hosted remotely, and its documented protocol version is MCP 2024-11-05.

The repository also documents a direct JSON-RPC endpoint at https://qtcl-blockchain.koyeb.app/rpc. This endpoint can be called with an HTTP POST and JSON content, including methods such as qtcl_getBlockHeight, without using MCP.

Tools and capabilities

The qtcl-mcp-server MCP server provides these tool groups:

• Wallet operations: create a post-quantum wallet, read confirmed and pending balances, and send QTCL.
• Transaction and chain inspection: retrieve a transaction by hash, fetch a block by height or hash, read chain information, and list up to 50 recent transactions with optional address filtering.
• Quantum and oracle data: inspect live quantum metrics and the five-oracle registry, including stake, uptime, and heartbeat data.
• Network and market data: list active P2P peers and topology information, or retrieve the QTCL/USD price.

The documented wallet format uses a 64-character hexadecimal address. The README identifies SHA3-256 hashing, Schnorr-Γ signatures over PSL(2,R), and a flat 1-qsat transaction fee.

Limitations and notes

The service is read and write capable: wallet generation and transfers can change payment state, while the remaining tools primarily query blockchain, network, oracle, quantum, or price data.

The listed price depends on the Pyth Network oracle feed. Recent transaction results are limited to the last 50 transactions, and the oracle registry represents five Byzantine-consensus oracles. The repository documents a 998,380 QTCL total supply, a 100-qsat-per-QTCL base-unit relationship, and a 70% fee burn rate.