# 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](/mcp/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](https://github.com/fyllepo/qubic-mcp/issues/19) · 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](https://github.com/fyllepo/qubic-mcp/issues/18) · 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](https://github.com/fyllepo/qubic-mcp/issues/17) · 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](https://github.com/fyllepo/qubic-mcp/issues/9) · 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](https://github.com/fyllepo/qubic-mcp/issues/21) · 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](https://github.com/fyllepo/qubic-mcp/issues/20) · 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](https://github.com/fyllepo/qubic-mcp/issues/14) · 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](https://github.com/fyllepo/qubic-mcp/issues/13) · 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](https://github.com/fyllepo/qubic-mcp/issues/12) · 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](https://github.com/fyllepo/qubic-mcp/issues/11) · 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](https://github.com/fyllepo/qubic-mcp/issues/10) · 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](https://github.com/fyllepo/qubic-mcp/issues/8) · 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](https://github.com/fyllepo/qubic-mcp/issues/7) · 2026-02-17 · open · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/fyllepo/qubic-mcp/issues).