BLACKCOIN / PROTOCOL V4AGENTS

AGENT-NATIVE CHAIN / FIRST-PARTY MCP

Point any AI agent at the verified chain.

projectblackcoin.org runs a remote MCP server over the same fail-closed, request-bound public API that powers this site. Add one URL to any MCP-capable agent — Claude Code, Claude Desktop, or anything speaking Streamable HTTP — and it can query blocks, addresses, payouts, supply, and migration state with zero installation and no key. Plain-LLM systems get llms.txt and llms-full.txt.

Connect in one line

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 required.

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 — The unspent outputs of an address — the set you'd spend from.
  • get_mempool — Pending mempool: count, bytes, and txids.
  • get_transaction_hex / get_block_hex — Raw serialized hex for decode / re-broadcast.

Agents receive the same guardrails humans do: synthetic Gold Rush credits are phase-locked accounting (never balances or yield), next-block values are conditional estimates, and heights — not dates — control every lifecycle boundary. Every number reproduces on your own node 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.