qubic-mcp

MCP server for the Qubic cryptocurrency — enabling AI assistants to interact with the Qubic network.

Overview

qubic-mcp is an open-source Model Context Protocol (MCP) server that gives AI assistants — Claude, ChatGPT, Copilot, Cursor, and others — native access to the Qubic blockchain.

Query balances, inspect transactions, monitor the network, trade on QX, switch between networks, and interact with smart contracts — all through natural language.

What's New in v0.4

• Smart Contract Profiles — Register custom SC interface definitions, then query them by name with automatic binary encoding/decoding
• Network Management — Save and switch between mainnet, testnet, or your own local/lite node at runtime
• Epoch Computors — Query the 676 computor identities for any epoch
• MCP Prompts — Predefined workflows for portfolio analysis, market overview, and research
• MCP Resources — Qubic reference documentation (network, tokenomics, smart contracts, address format)
• HTTP Transport — Run as a standalone HTTP server for remote deployment

Features

Blockchain Query Tools

• Balance & Transfers — Query any Qubic address balance and transfer history
• Transactions — Look up transaction details by ID
• Network Status — Current tick, epoch, supply, burned QUs, active addresses, market cap
• Mining Phase — Current MINING/IDLE phase, cycle progress, and XMR marathon status
• Epoch Computors — List all 676 computor identities for a given epoch
• Rich List — Top holders ranked by balance

Market & Analytics

• Token Price — Real-time QUBIC price compared across 3 sources (CoinGecko, Qubic API, CryptoCompare)
• QU/USD Converter — Convert between QU and USD at live rates
• Token Registry — List all registered Qubic tokens with issuer and website
• QX DEX Orderbook — Live ask/bid orders for any token on the QX decentralized exchange

Smart Contract Tools

• Register Contract — Save a custom SC interface definition (function names, input/output field schemas)
• Query Contract — Query a registered SC function by name with automatic binary encoding/decoding
• Raw SC Query — Low-level smart contract query with base64 input/output for advanced use
• List/Remove Contracts — Manage your registered contract definitions

Local Management

• Wallet Management — Save wallet addresses locally for quick access
• Network Switching — Save and switch between mainnet, testnet, or custom RPC endpoints at runtime
• Address Validation — Check format and on-chain activity
• Explorer Links — Direct links to the official Qubic block explorer

AI Context

• MCP Resources — Qubic reference docs (network, tokenomics, smart contracts, address format) available as context
• MCP Prompts — Predefined workflows: portfolio analysis, market overview, and Qubic research

Quick Start

Works with any MCP-compatible AI client — Claude, ChatGPT, Copilot, Cursor, Windsurf, Gemini, JetBrains, and more.

Add this to your client's MCP config:

{
  "mcpServers": {
    "qubic": {
      "command": "npx",
      "args": ["mcp-server-qubic"]
    }
  }
}