Skip to content

io.github.nowi333/monerometrics

by nowi333 · remote · no sign-in to list tools · v0.4.0 · published by GitHub user nowi333

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

Final · 1Changes · 15

19 tools: 1 do something that can't be undone, 15 change things and 3 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http monerometrics https://api.monerometrics.net/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

19 tools

Can't be undone 1Claude Code: ask
  • chain_fork_windowCanonical chain plus any competing orphan blocks around a height.Can send data outNo findings

    Why it is in this group

    • The name "chain_fork_window" says "fork": a word for a change.
    • The input addresses people (input.to): what it sends cannot be taken back.

    What it can reach

    • outboundThe input takes a destination (input.to): what the tool writes goes there.
    Description, as the server wrote it
    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.
Changes things 15Claude Code: ask
  • chain_provenanceHow mining-pool attribution was established over a window: share proven by view key, claimed by pool API, inferred from coinbase, or unattributed.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.
  • haveno_bookThe live Haveno XMR/USD order book, both sides, priced against centralized spot.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.
  • haveno_payment_methodsExecuted Haveno trades grouped by payment method, with the premium over spot.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.
  • haveno_premiumHaveno peer-to-peer quotes against centralized spot over time, both sides.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.
  • network_blocktimeBlock-time variance time series (seconds between blocks).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Block-time variance time series (seconds between blocks). window in 1h,24h,7d,30d,90d,1y,5y.
  • network_emissionBlock reward / emission time series (XMR per block).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Block reward / emission time series (XMR per block). window in 1h,24h,7d,30d,90d,1y,5y.
  • network_hashrateNetwork hashrate time series.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Network hashrate time series. window in 1h,24h,7d,30d,90d,1y,5y.
  • network_infoCurrent Monero network state: latest indexed height, difficulty, network hashrate and mempool size.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Current Monero network state: latest indexed height, difficulty, network hashrate and mempool size.
  • network_mempoolMempool size time series (number of pending transactions).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Mempool size time series (number of pending transactions). window in 1h,24h,7d,30d,90d,1y,5y.
  • pool_distributionMining-pool distribution over a window: block share per pool, largest-pool share and the Nakamoto coefficient (minimum pools controlling >50% of blocks).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.
  • pool_sourcesReachability status of each mining-pool API used for block attribution.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Reachability status of each mining-pool API used for block attribution.
  • priceCurrent Monero (XMR) price: centralized spot plus both sides of the Haveno peer-to-peer book.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.
  • recent_orphansMost recent orphan blocks with their canonical counterpart at the same height, newest first.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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).
  • reorg_statsAggregate reorg statistics over windows: counts, average and maximum depth, affected transactions.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Aggregate reorg statistics over windows: counts, average and maximum depth, affected transactions.
  • reorgsDetected Monero chain reorganizations, most recent first, with fork point, depth and affected transactions.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Detected Monero chain reorganizations, most recent first, with fork point, depth and affected transactions.
Only reads 3Claude Code: allow
  • get_blockFull detail for one block by its 64-character block hash: height, previous hash, size, difficulty, reward, coinbase, transaction list and merge-mining tags.No findings

    Why it is in this group

    • The name "get_block" says "get": a word for reading.
    Description, as the server wrote it
    Full detail for one block by its 64-character block hash: height, previous hash, size, difficulty, reward, coinbase, transaction list and merge-mining tags.
  • lookup_transactionLook 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 whe…No findings

    Why it is in this group

    • The name "lookup_transaction" says "lookup": a word for reading.
    Description, as the server wrote it
    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.
  • search_blockFind a block by height (a number) or by 64-character hash, anywhere in the chain down to the genesis block (height 0).No findings

    Why it is in this group

    • The name "search_block" says "search": a word for reading.
    Description, as the server wrote it
    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.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

No private-data, untrusted-input, outbound path in this server alone: no tool is tagged private-data or untrusted-input.

Reads private data0
Reads files, mail, messages, databases, secrets, calendars or repositories.
Reads text others write0
Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
Can send data out1
Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Install

Pinned to version 0.4.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http monerometrics https://api.monerometrics.net/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__monerometrics__get_block",
      "mcp__monerometrics__search_block",
      "mcp__monerometrics__lookup_transaction"
    ],
    "ask": [
      "mcp__monerometrics__network_info",
      "mcp__monerometrics__price",
      "mcp__monerometrics__haveno_book",
      "mcp__monerometrics__haveno_premium",
      "mcp__monerometrics__haveno_payment_methods",
      "mcp__monerometrics__network_hashrate",
      "mcp__monerometrics__network_blocktime",
      "mcp__monerometrics__network_mempool",
      "mcp__monerometrics__network_emission",
      "mcp__monerometrics__reorgs",
      "mcp__monerometrics__reorg_stats",
      "mcp__monerometrics__recent_orphans",
      "mcp__monerometrics__pool_distribution",
      "mcp__monerometrics__pool_sources",
      "mcp__monerometrics__chain_provenance",
      "mcp__monerometrics__chain_fork_window"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as monerometrics. Review it before you use it.

Capability tags behind 1 rule
  • mcp__monerometrics__chain_fork_window outbound