BLACKCOIN / PROTOCOL V4AGENTS

PUBLIC READ-ONLY MCP ADAPTER

Read chain data with an MCP client.

Connect a client that supports MCP Streamable HTTP to the hosted endpoint. Query blocks, addresses, payouts, supply, and migration state without an API key or a local server. The adapter uses this site's public API and preserves its data-quality and availability limits. Reference files for other clients are llms.txt and llms-full.txt.

Connect your client

claude mcp add --transport http blackcoin https://projectblackcoin.org/mcp

Read-only, CORS-open, 240 requests/minute per client. The server is stateless Streamable HTTP: POST JSON-RPC (initialize, tools/list, tools/call). No session is required.

This is a public remote read-only adapter. The adapter source is privately hosted. The Blackcoin Core repository publishes Core source, not adapter source. MCP serverInfo.version identifies the adapter release, not a recommended Core release or the actual producer version.

Tools

  • get_chain_status: Height, sync state, per-index coverage (disclosed as from_height/complete).
  • get_live_snapshot: Quorum-verified live state with conditional next-block estimates.
  • get_migration_status: Replay attestation and the published consensus schedule.
  • get_chain_identity: Genesis hash, network magic, prefixes, lifecycle heights, source commit.
  • get_supply: Reconciled supply taxonomy with machine-tested equations.
  • get_block / get_transaction / get_address / get_shadow_record: Any record, by identifier.
  • search: Classify a height, hash, txid, or address to its exact record.
  • get_recent_blocks / get_events: The newest verified blocks; filtered payout history with coverage.
  • get_shadow_supply / get_leaderboard: Shadow supply pools; top holders (lower-bound under partial coverage).
  • get_network / get_network_series: Live network health; hourly hashrate/difficulty/interval series.
  • get_analytics_series: Per-height PoW/PoS issuance (exact sats) over a range.
  • get_address_utxos: Index-reported candidate outputs, not authoritative coin selection. This view does not independently verify current spentness or establish current spendability. Before constructing or submitting a payment, verify inputs with a compatible Core/wallet or Core-backed gateway preflight.
  • get_mempool: Pending mempool: count, bytes, and txids.
  • get_transaction_hex / get_block_hex: Raw serialized hex for decode / re-broadcast.

During Gold Rush, synthetic credits are phase-locked accounting and are not spendable. From migration height 6,193,000, authenticated unspent credits may become spendable when output maturity and all applicable consensus and authorization conditions are satisfied. The earliest eligible height is max(maturity_height, 6193000), not migration start plus a new blanket maturity period. A record alone does not establish a winning award, current spendability, exchange support, or guaranteed yield. Next-block values are conditional estimates, and block heights control every lifecycle boundary. Reproduce reported values on a compatible node at the same height and hash via the reproduction contract.

Resources & prompts

Beyond tools, the server advertises MCP resources (fetch with resources/read) and canned analysis prompts (prompts/get):

  • blackcoin://contract/openapi: The full machine-readable API contract.
  • blackcoin://chain/identity: Genesis hash, network magic, prefixes, lifecycle heights, source commit.
  • blackcoin://guide/agents: Framing rules, endpoint map, and error model for agents.
  • audit_supply: Walk the reconciled supply taxonomy and its machine-checked equations.
  • explain_migration: Explain the Protocol V4 migration schedule from live lifecycle state.
  • trace_address: Trace an address's base-chain and synthetic payout history.