Reported issues for qubic-mcp

Pod holds 13 of 13 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to qubic-mcp.

Most discussed

feat: human-readable SC query tool (encode request, decode response)

Summary

Replace the raw base64 query_smart_contract experience with a high-level tool that uses contract profiles to encode requests and decode responses automatically.

Motivation

Current workflow:

1. Manually construct binary payload
2. Base64-encode it
3. Call query_smart_contract with raw params
4. Get base64 blob back
5. Manually decode

Target workflow:

"Query my-contract get_balance for address BAAAA...RMID"

The MCP looks up the contract profile, encodes the request, calls

Read the thread · 2026-02-19 · closed · 1 comment

feat: SC binary encoder/decoder using contract profiles

Summary

Build a binary encoder/decoder utility that converts between human-readable parameters and the binary payloads required by querySmartContract, using the struct layouts saved in contract profiles.

Motivation

Today, interacting with any SC beyond QX requires manually constructing base64 payloads. With this utility, the AI can encode { address: "BAAAA...RMID", amount: 1000 } into the correct binary request and decode the binary response back into named fields.

Design

E

Read the thread · 2026-02-19 · closed · 1 comment

feat: SC contract profile store (save/list/remove contract interfaces)

Summary

Add a local contract profile store (~/.qubic-mcp/contracts.json) — same pattern as wallets and networks — so users can save their smart contract's interface definition and interact with it by name.

Motivation

The current query_smart_contract tool is unusable in practice because it requires manual base64 encoding/decoding. By saving a contract's struct layouts, the MCP can automatically encode requests and decode responses.

Design

A contract profile stores:

• name —

Read the thread · 2026-02-19 · closed · 1 comment

Epoch summary and computor performance

Summary

Add tools to query epoch-level data — burns, deductions, computor performance scores, and epoch summaries.

Upstream Dependency

Blocked on qubic/integration#102 — API endpoint to get epoch summary (burns & deductions by epoch). Additional context in qubic/integration#101 (reserve events) and qubic/integration#100 (contract reserve snapshots).

Implementation Notes

• get_epoch_summary tool showing burns, deductions, duration, and key stats
• Optionally `get_compu

Read the thread · 2026-02-17 · open · 1 comment

research: SC registration on test/lite networks via RPC

Summary

Research how smart contract deployment works on Qubic test/lite networks and determine whether it can be done via RPC, or if it requires node-level configuration.

Context

On mainnet, contract registration goes through a proposal and computor voting process. On a local lite/test network the process may be different — possibly direct deployment via RPC or node config.

Questions to answer

1. Is there an RPC endpoint for deploying/registering a new contract? (e.g., `/v1/registe

Read the thread · 2026-02-19 · open · 0 comments

feat: transaction builder and broadcaster for SC invocation

Summary

Add the ability to construct, sign, and broadcast transactions to smart contracts — enabling write operations on test/local networks.

Motivation

Currently the MCP is read-only. For SC development on a local test network, developers need to invoke their contracts (send transactions) to test functionality. Without this, they have to leave the MCP workflow and use external tools.

Design

Tool: send_sc_transaction

Parameters:

• contract — contract name or index
• `functi

Read the thread · 2026-02-19 · open · 0 comments

Self-hosted RPC documentation

Summary

Provide documentation and guides for users who want to run their own Qubic RPC node rather than relying on the public rpc.qubic.org endpoint.

Upstream Dependency

Blocked on qubic/integration#82 — making it easy for partners/developers to set up their own RPC instances. Also qubic/integration#84 (full docker compose) and qubic/integration#83 (small docker compose).

Implementation Notes

• qubic-mcp already supports custom QUBIC_RPC_URL — this is just docs
• Wo

Read the thread · 2026-02-17 · open · 0 comments

Testnet support (multi-network toggle)

Summary

Add the ability to switch between mainnet and testnet, so developers can test integrations without using real QU.

Upstream Dependency

Partially blocked on qubic/integration#95 — Docker Compose for testnet integration services. Also related to qubic/integration#82 (easy self-hosted RPC setup).

Implementation Notes

• Already partially supported: QUBIC_RPC_URL can be pointed at testnet
• Need to verify testnet RPC is stable and has the same endpoints
• Could add a `n

Read the thread · 2026-02-17 · closed · 0 comments

Most recent

Real-time WebSocket notifications

Summary

Add real-time notifications for balance changes, new transfers, and tick events via WebSocket subscription — enabling the AI assistant to proactively alert users.

Upstream Dependency

Blocked on qubic/integration#74 — WebSocket events service. Also related to qubic/integration#52 (real-time update mechanism for tickchain data).

Implementation Notes

• Would use MCP's notification/subscription patterns
• Subscribe to events per-address: incoming transfers, balance chan

Read the thread · 2026-02-17 · open · 0 comments

Token market data (volume, price history)

Summary

Add richer token market data beyond the current QU price — per-token volume, price history, and market stats for SC tokens traded on QX.

Upstream Dependency

Blocked on qubic/integration#61 — Token Information and Market Data Services. This epic covers building centralized token info and market data endpoints.

Implementation Notes

• Could extend get_token_price or add get_token_market_data
• Per-token: 24h volume, price change, high/low, number of trades
• Depends on

Read the thread · 2026-02-17 · open · 0 comments

Token transfer history (SC token transfers)

Summary

Add a tool to query transfer history for SC tokens (CFB, QXMR, etc.) — not just native QU transfers.

Upstream Dependency

Blocked on qubic/integration#55 — enable export of full token transfers for a given identity. Currently get_transfer_history only shows native QU transfers.

Implementation Notes

• Could be a parameter on the existing get_transfer_history or a separate get_token_transfers tool
• Should show token name, amount, sender, receiver, tick
• Needs the i

Read the thread · 2026-02-17 · open · 0 comments

Token balances per address (asset holdings)

Summary

Add a tool to show token/asset balances for a Qubic address — e.g., "you hold 500 CFB and 1,200 QXMR" alongside the native QU balance.

Upstream Dependency

Blocked on qubic/qubic-http#26 — API endpoint to get the balance of QU and assets for one or more addresses. Currently the RPC only returns native QU balance.

Implementation Notes

• Could extend get_balance or be a separate get_token_balances tool
• Needs the multi-asset balance endpoint to return per-token hold

Read the thread · 2026-02-17 · open · 0 comments

QX trade history

Summary

Add a tool to query historical trades on the QX decentralized exchange — what was bought/sold, at what price, and when.

Upstream Dependency

Blocked on qubic/qx-service#11 — the QX service currently reads from the live network. Once it reads from the archiver, historical trade data will be queryable via API.

Implementation Notes

• Will likely use the qx-service REST API once available, rather than raw SC queries
• Should support filtering by token, time range, and enti

Read the thread · 2026-02-17 · open · 0 comments

The remaining reports are on the project's issue tracker.