{
  "name": "papertrade-yield",
  "title": "Papertrade Yield (unofficial)",
  "version": "0.2.0",
  "description": "Unofficial PAPER staking and yield tools for Papertrade: stats, APR, yield history, wallet stake and rewards, rewards calculator, unsigned stake/unstake/claim plans.",
  "transport": "streamable-http",
  "protocolVersions": [
    "2025-06-18",
    "2025-03-26",
    "2024-11-05"
  ],
  "endpoint": "https://papertrade-yield.pages.dev/mcp",
  "usage": "POST JSON-RPC 2.0 messages to this URL with Content-Type: application/json.",
  "tools": [
    {
      "name": "get_staking_stats",
      "title": "PAPER staking stats",
      "description": "Current PAPER staking state on Papertrade: total supply, staked amount and share, undistributed staker rewards, minimum stake, the current mint rate (PAPER minted per $1 of loss), liquidity context, and the realized USDC yield per 1M PAPER per day over 24h, 7d and 30d. PAPER has no market price, so yield is quoted per 1M PAPER, not as a percentage. Read only."
    },
    {
      "name": "get_apr",
      "title": "Realized yield and implied APR",
      "description": "Realized staking yield for PAPER over 24h, 7d and 30d as USDC per 1M PAPER per day. PAPER has no market price, so a percentage APR exists only for a price you assume: pass assumedPaperPriceUsd to get a simple (non-compounding) implied APR for that price. Without a price, impliedAprPercent is null. Read only."
    },
    {
      "name": "get_yield_history",
      "title": "Hourly staking reward history",
      "description": "Hourly history of USDC distributed to PAPER stakers, newest last: reward in USD, mean staked PAPER, USDC per PAPER and the pace as USDC per 1M PAPER per day, for the trailing number of hours. Buckets before staking rewards began are omitted. Read only."
    },
    {
      "name": "get_claims_activity",
      "title": "On-chain claims activity",
      "description": "USDC that stakers claimed on chain (PaperStaking Claimed events on HyperEVM) over the trailing 1 to 72 hours, bucketed per hour, with unique claimers and the largest claim. Claiming is a choice, so this differs from USDC distributed. Read only."
    },
    {
      "name": "get_wallet_staking",
      "title": "Wallet stake and rewards",
      "description": "Staking position of one wallet: staked PAPER (net of the wallet's Staked and Unstaked history), unstaked PAPER balance and pending USDC reward (both read on chain now), lifetime USDC claimed, and the ten most recent staking events. Amounts are in PAPER and USDC; raw 18-decimal values are included. Read only: it never needs or accepts a key."
    },
    {
      "name": "project_rewards",
      "title": "Projected staking rewards calculator",
      "description": "Calculator: what a PAPER position would earn if the realized pace of a trailing window simply continued. Give either paperAmount (PAPER you hold or would stake) or lossUsd (a hypothetical trading loss, converted to PAPER at today's mint rate; liquidations mint on the full loss, normal closes on 98%). The result is an extrapolation of history, not a forecast: the pace and the mint rate both move. Add assumedPaperPriceUsd for an implied APR. Read only."
    },
    {
      "name": "plan_staking_action",
      "title": "Plan a stake, unstake or claim (unsigned)",
      "description": "Builds an UNSIGNED plan for staking, unstaking or claiming PAPER staking rewards: preflight checks against the wallet's real balance, staked amount and pending reward, the EIP-712 type and domain the wallet would be asked to sign, and a link to the app where the owner signs in their own wallet. This tool never signs, never submits and never moves funds; the nonce and deadline are only allocated when the owner signs. Read only."
    }
  ],
  "links": {
    "docs": "https://papertrade-yield.pages.dev/docs/",
    "openapi": "https://papertrade-yield.pages.dev/openapi.json",
    "llms": "https://papertrade-yield.pages.dev/llms.txt",
    "serverCard": "https://papertrade-yield.pages.dev/.well-known/mcp/server-card.json",
    "agentCard": "https://papertrade-yield.pages.dev/.well-known/agent-card.json",
    "source": "https://github.com/nirholas/papertrade-yield"
  }
}