MCP Server

monerometrics

io.github.nowi333/monerometrics

What this MCP does

Provides live Monero network, mining-pool, chain-reorganization, mempool, emission, price, and Haveno peer-to-peer order-book metrics.

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.
Input schema
{'type': 'object', 'title': 'chain_fork_windowArguments', 'properties': {'to': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'To', 'default': None}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 100}}}
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.
Input schema
{'type': 'object', 'title': 'chain_provenanceArguments', 'properties': {'window': {'type': 'string', 'title': 'Window', 'default': '24h'}}}
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.
Input schema
{'type': 'object', 'title': 'get_blockArguments', 'required': ['hash'], 'properties': {'hash': {'type': 'string', 'title': 'Hash'}}}
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.
Input schema
{'type': 'object', 'title': 'haveno_bookArguments', 'properties': {}}
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.
Input schema
{'type': 'object', 'title': 'haveno_payment_methodsArguments', 'properties': {'window': {'type': 'string', 'title': 'Window', 'default': '180d'}, 'currency': {'type': 'string', 'title': 'Currency', 'default': 'USD'}}}
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.
Input schema
{'type': 'object', 'title': 'haveno_premiumArguments', 'properties': {'window': {'type': 'string', 'title': 'Window', 'default': '7d'}}}
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.
Input schema
{'type': 'object', 'title': 'lookup_transactionArguments', 'required': ['tx_hash'], 'properties': {'tx_hash': {'type': 'string', 'title': 'Tx Hash'}}}
network_blocktime
Block-time variance time series (seconds between blocks). window in 1h,24h,7d,30d,90d,1y,5y.
Input schema
{'type': 'object', 'title': 'network_blocktimeArguments', 'properties': {'window': {'type': 'string', 'title': 'Window', 'default': '24h'}}}
network_emission
Block reward / emission time series (XMR per block). window in 1h,24h,7d,30d,90d,1y,5y.
Input schema
{'type': 'object', 'title': 'network_emissionArguments', 'properties': {'window': {'type': 'string', 'title': 'Window', 'default': '30d'}}}
network_hashrate
Network hashrate time series. window in 1h,24h,7d,30d,90d,1y,5y.
Input schema
{'type': 'object', 'title': 'network_hashrateArguments', 'properties': {'window': {'type': 'string', 'title': 'Window', 'default': '30d'}}}
network_info
Current Monero network state: latest indexed height, difficulty, network hashrate and mempool size.
Input schema
{'type': 'object', 'title': 'network_infoArguments', 'properties': {}}
network_mempool
Mempool size time series (number of pending transactions). window in 1h,24h,7d,30d,90d,1y,5y.
Input schema
{'type': 'object', 'title': 'network_mempoolArguments', 'properties': {'window': {'type': 'string', 'title': 'Window', 'default': '24h'}}}
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.
Input schema
{'type': 'object', 'title': 'pool_distributionArguments', 'properties': {'window': {'type': 'string', 'title': 'Window', 'default': '24h'}}}
pool_sources
Reachability status of each mining-pool API used for block attribution.
Input schema
{'type': 'object', 'title': 'pool_sourcesArguments', 'properties': {}}
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.
Input schema
{'type': 'object', 'title': 'priceArguments', 'properties': {}}
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).
Input schema
{'type': 'object', 'title': 'recent_orphansArguments', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20}, 'window': {'type': 'string', 'title': 'Window', 'default': 'all'}}}
reorgs
Detected Monero chain reorganizations, most recent first, with fork point, depth and affected transactions.
Input schema
{'type': 'object', 'title': 'reorgsArguments', 'properties': {}}
reorg_stats
Aggregate reorg statistics over windows: counts, average and maximum depth, affected transactions.
Input schema
{'type': 'object', 'title': 'reorg_statsArguments', 'properties': {}}
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.
Input schema
{'type': 'object', 'title': 'search_blockArguments', 'required': ['query'], 'properties': {'query': {'type': 'string', 'title': 'Query'}}}
Added
lookup_transaction
Sept. 25, 2026, 2:55 a.m.
Changed
recent_orphans
Sept. 25, 2026, 2:55 a.m.
Added
chain_fork_window
Sept. 17, 2026, 12:45 p.m.
Added
search_block
Sept. 17, 2026, 12:45 p.m.
Added
get_block
Sept. 17, 2026, 12:45 p.m.
Added
chain_provenance
Sept. 17, 2026, 12:45 p.m.
Added
pool_sources
Sept. 17, 2026, 12:45 p.m.
Added
pool_distribution
Sept. 17, 2026, 12:45 p.m.
Added
recent_orphans
Sept. 17, 2026, 12:45 p.m.
Added
reorg_stats
Sept. 17, 2026, 12:45 p.m.
Added
reorgs
Sept. 17, 2026, 12:45 p.m.
Added
network_emission
Sept. 17, 2026, 12:45 p.m.
Added
network_mempool
Sept. 17, 2026, 12:45 p.m.
Added
network_blocktime
Sept. 17, 2026, 12:45 p.m.
Added
network_hashrate
Sept. 17, 2026, 12:45 p.m.
Added
haveno_payment_methods
Sept. 17, 2026, 12:45 p.m.
Added
haveno_premium
Sept. 17, 2026, 12:45 p.m.
Added
haveno_book
Sept. 17, 2026, 12:45 p.m.
Added
price
Sept. 17, 2026, 12:45 p.m.
Added
network_info
Sept. 17, 2026, 12:45 p.m.