io.github.nowi333/monerometrics

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Live Monero network metrics: reorgs, orphans, pool centralization and the Haveno order book.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "monerometrics": {
      "url": "https://api.monerometrics.net/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (19)

• network_info

  Current Monero network state: latest indexed height, difficulty, network hashrate and mempool size.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• price

  Current Monero (XMR) price: centralized spot plus both sides of the Haveno peer-to-peer book. Returns the best offer and the amount-weighted average on each side, resting depth, offer counts, and round_trip_cost_pct: the cost of buying XMR and selling it straight back, which is far larger than the headline premium.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• haveno_book

  The live Haveno XMR/USD order book, both sides, priced against centralized spot. Each price level carries its cumulative depth, offer count, payment methods and a reversible flag. `asks` are makers selling XMR, so taking one means buying; `bids` are makers buying, so taking one means selling. Offers are advertisements with differing payment methods rather than a matched book, so nothing executes on its own and the best bid can sit at or above the best ask.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• haveno_premium

  Haveno peer-to-peer quotes against centralized spot over time, both sides. window in 24h,7d,30d,90d,1y. History starts on 24 August 2026, when recording began.

  Parameters:

  • window — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• haveno_payment_methods

  Executed Haveno trades grouped by payment method, with the premium over spot. window in 30d,90d,180d,1y,all. currency in USD,EUR. The premium tracks how reversible and convenient the payment rail is, not privacy: every one of these trades is equally non-KYC. The reversible flag is our own classification, not a Haveno field.

  Parameters:

  • window — string
  • currency — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• network_hashrate

  Network hashrate time series. window in 1h,24h,7d,30d,90d,1y,5y.

  Parameters:

  • window — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• network_blocktime

  Block-time variance time series (seconds between blocks). window in 1h,24h,7d,30d,90d,1y,5y.

  Parameters:

  • window — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• network_mempool

  Mempool size time series (number of pending transactions). window in 1h,24h,7d,30d,90d,1y,5y.

  Parameters:

  • window — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• network_emission

  Block reward / emission time series (XMR per block). window in 1h,24h,7d,30d,90d,1y,5y.

  Parameters:

  • window — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• reorgs

  Detected Monero chain reorganizations, most recent first, with fork point, depth and affected transactions.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• reorg_stats

  Aggregate reorg statistics over windows: counts, average and maximum depth, affected transactions.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• recent_orphans

  Most recent orphan blocks with their canonical counterpart at the same height, newest first. limit 1..50; window in 24h,48h,7d,30d,90d,180d,1y,all (default all, so the last N orphans are returned however old they are).

  Parameters:

  • limit — integer
  • window — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• pool_distribution

  Mining-pool distribution over a window: block share per pool, largest-pool share and the Nakamoto coefficient (minimum pools controlling >50% of blocks). window in 1h,6h,24h,48h,7d.

  Parameters:

  • window — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• pool_sources

  Reachability status of each mining-pool API used for block attribution.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• chain_provenance

  How mining-pool attribution was established over a window: share proven by view key, claimed by pool API, inferred from coinbase, or unattributed. window in 1h,6h,24h,48h,7d.

  Parameters:

  • window — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_block

  Full detail for one block by its 64-character block hash: height, previous hash, size, difficulty, reward, coinbase, transaction list and merge-mining tags.

  Parameters:

  • hash (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_block

  Find a block by height (a number) or by 64-character hash, anywhere in the chain down to the genesis block (height 0). Returns the block detail plus whether it is canonical or an orphan.

  Parameters:

  • query (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• lookup_transaction

  Look up a transaction by its 64-character hash: whether it is in the mempool or mined, its block, confirmations, whether it is spendable yet, the pool that mined its block, and whether that height was ever contested by a reorg. No amounts, senders or recipients: the protocol encrypts them.

  Parameters:

  • tx_hash (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• chain_fork_window

  Canonical chain plus any competing orphan blocks around a height. 'to' is the highest height in the window (defaults to the current tip); lower it to browse older history down to the genesis block. limit 10..500.

  Parameters:

  • to
  • limit — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.