xmr.pub MCP — Monero node, fees, mempool & payment verification (read-only)

门罗主网实时状态：高度、同步状态、难度与全网算力、内存池、链库体积。数据来自 xmr.pub 自建全节点。

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

门罗动态区块大小与费率预言机：返回当前费率档位，以及区块权重中位数/上限，解释门罗「自适应区块」共识（无固定区块上限，按权重惩罚调节）。

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

内存池健康度：排队交易数、体积、费率中位数、最老交易等待时间，以及 key image（防双花）跟踪规模。

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

【零私钥对账】用 tx-proof 校验某笔交易是否真的支付给你的地址：调用方提供 txid、收款地址、对方给出的 tx_key、以及你自己的 view_key，服务端用一次性只读钱包校验（不落盘、不记录、无法转账）。Paid: x402 credit pack or API key.

{
  "type": "object",
  "properties": {
    "txid": {
      "type": "string",
      "description": "64 位十六进制交易哈希"
    },
    "address": {
      "type": "string",
      "description": "你的门罗收款地址（4/8 开头，95 字符）"
    },
    "tx_key": {
      "type": "string",
      "description": "付款方提供的交易密钥（tx proof）"
    },
    "view_key": {
      "type": "string",
      "description": "你的只读私钥 view key（无法用于转账）"
    }
  },
  "required": [
    "txid",
    "address",
    "tx_key",
    "view_key"
  ],
  "additionalProperties": false
}

【商户对账·可批量】核验一笔或多笔门罗到账：调用方给出收款地址、只读 view_key，以及每笔的 txid + 付款方的 tx_key（可选 amount 期望金额），服务端用一次性只读钱包解密出「该地址在这笔交易里实际收到多少 XMR」，并给出 paid / 确认数 / 差额。When to use：订单到账确认、OTC 收款核验、批量对账。Do not use：查交易是否上链（用 xmr_verify_tx_proof 或区块浏览器）。Paid: x402 credit pack or API key.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "你的门罗收款地址（4/8 开头，95 字符）"
    },
    "view_key": {
      "type": "string",
      "description": "该地址的只读私钥 view key（无法转账）"
    },
    "amount_tolerance_percent": {
      "type": "number",
      "description": "允许的金额容差百分比，默认 1.0"
    },
    "payments": {
      "type": "array",
      "description": "批量核验列表（≤100 笔）",
      "items": {
        "type": "object",
        "properties": {
          "txid": {
            "type": "string"
          },
          "tx_key": {
            "type": "string"
          },
          "amount": {
            "type": "number",
            "description": "期望金额（XMR），可省略"
          },
          "label": {
            "type": "string",
            "description": "你自己的订单号/备注"
          }
        },
        "required": [
          "txid",
          "tx_key"
        ],
        "additionalProperties": false
      }
    },
    "txid": {
      "type": "string",
      "description": "单笔简写：txid"
    },
    "tx_key": {
      "type": "string",
      "description": "单笔简写：tx_key"
    },
    "amount": {
      "type": "number",
      "description": "单笔简写：期望金额"
    },
    "label": {
      "type": "string",
      "description": "单笔简写：备注"
    }
  },
  "required": [
    "address",
    "view_key"
  ],
  "additionalProperties": false
}

【商户对账·历史】按时间窗汇总某地址的收款流水：逐日笔数与金额、总额、确认数、未解锁/待确认笔数、最常见金额分布。输入 address + view_key + period_days（1–30）。When to use：财务对账、月度流水、税务留痕、异常金额排查。Do not use：单笔到账确认（用 xmr_verify_payment，秒级返回）。Paid: x402 credit pack or API key.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "门罗收款地址"
    },
    "view_key": {
      "type": "string",
      "description": "只读私钥 view key（无法转账）"
    },
    "period_days": {
      "type": "integer",
      "description": "回溯天数，1–30，默认 7"
    },
    "include_pending": {
      "type": "boolean",
      "description": "是否含内存池未确认笔，默认 true"
    },
    "limit": {
      "type": "integer",
      "description": "返回明细条数上限，默认 500，上限 2000"
    }
  },
  "required": [
    "address",
    "view_key"
  ],
  "additionalProperties": false
}

【矿工决策】给定算力（H/s）与功耗/电价，算出日/月毛收益、净收益、盈亏平衡电价与回本天数（数据来自本节点的链上网络口径）。When to use：判断要不要开挖、买什么机器、电价谈到多少才划算。Do not use：查询收益历史（本工具是前瞻测算，不是结算单）。Paid: x402 credit pack or API key.

{
  "type": "object",
  "properties": {
    "hashrate_hs": {
      "type": "number",
      "description": "算力，单位 H/s（例：100000 = 100 kH/s）"
    },
    "hashrate_khs": {
      "type": "number",
      "description": "算力的 kH/s 简写（与 hashrate_hs 二选一）"
    },
    "hashrate_mhs": {
      "type": "number",
      "description": "算力的 MH/s 简写"
    },
    "power_watts": {
      "type": "number",
      "description": "整机功耗（瓦），用于算电费"
    },
    "power_cost_kwh": {
      "type": "number",
      "description": "电价（美元/kWh）"
    },
    "service_fee_percent": {
      "type": "number",
      "description": "你所用挖矿服务的费率（%），默认 0；xmr.pub 不收取任何费率"
    },
    "xmr_price_usd": {
      "type": "number",
      "description": "XMR 价格（美元），填了才给美元净收益"
    },
    "hardware_cost_usd": {
      "type": "number",
      "description": "机器成本（美元），用于算回本天数"
    }
  },
  "additionalProperties": false
}