io.github.fyllepo/qubic-mcp
MCP server for Qubic — balances, prices, transfers, wallets, and more.
Versions
0.2.0scoredTrust breakdown
Tools 23
get_version Get the current qubic-mcp server version
save_wallet Save a Qubic wallet address with a friendly name for quick access. Only saves the public address — never stores seeds or private keys. Stored locally in ~/.qubic-mcp/wallets.json.
list_wallets List all saved Qubic wallet addresses. These are public addresses only — no private keys are ever stored.
remove_wallet Remove a saved wallet by name. This only removes the local reference — it does not affect the actual blockchain address in any way.
convert_qu_usd Convert between QU (Qubic Units) and USD using the current live price. Specify either a QU amount to get USD value, or a USD amount to get the equivalent in QU.
get_transfer_history Get the transfer history for a Qubic address or saved wallet within a tick range. Returns incoming and outgoing transfers with details. Use get_tick_info first to find the current tick number.
get_balance Get the current balance of a Qubic address or saved wallet. Accepts a 60-character Qubic address OR a saved wallet name (e.g.,
add_network Save a custom Qubic network (e.g., a local lite node). Stored in ~/.qubic-mcp/networks.json. Use switch_network to activate it.
switch_network Switch the active Qubic network. All subsequent tool calls will use the new endpoint. Built-in networks:
list_networks List all available Qubic networks (built-in and custom) and show which is currently active.
remove_network Remove a saved custom network. Cannot remove built-in networks (mainnet, testnet). If the removed network was active, switches back to mainnet.
get_tick_info Get the current Qubic network tick information. Returns the current tick number, epoch, and tick duration. Qubic processes transactions in ticks (~5 seconds each) organized into epochs (~1 week each).
get_network_status Get comprehensive Qubic network status including current tick, epoch progress, circulating supply, burned QUs, active addresses, price, and market cap.
get_token_list Get a list of all registered Qubic tokens with their name, issuer address, and website. Useful for finding token issuers needed for QX orderbook queries.
get_rich_list Get the Qubic rich list — top addresses ranked by balance for the current epoch. Supports pagination.
get_token_price Get the current QUBIC token price compared across multiple sources (CoinGecko, Qubic Official API, CryptoCompare). Shows price, 24h change, market cap, and volume with source-by-source comparison.
get_epoch_computors List the computor identities for a given epoch. Computors are the 676 nodes that validate transactions on the Qubic network. Defaults to the current epoch if none is specified.
get_explorer_links Get links to Qubic block explorers for an address or transaction ID. Accepts saved wallet names.
validate_address Validate a Qubic address format and check if it exists on-chain with balance or transfer activity.
get_transaction Look up a Qubic transaction by its transaction ID. Returns source, destination, amount, tick, and execution status. Transaction IDs are 60 lowercase letters.
list_contracts List all registered custom smart contract definitions with their functions and field schemas.
remove_contract Remove a registered smart contract definition by name.
get_mining_phase Get the current Qubic mining phase (MINING or IDLE) and whether it
Permissions 2
network Server uses network capabilities via: fetch() env_vars Server uses env_vars capabilities via: process.env