Quickstart

No account, API key or install is needed to read data.

1. Read the yield#

curl -s https://papertrade-yield.pages.dev/api/staking | jq '.yield.windows[] | {label, usdPer1MPaperPerDay, complete}'

Each window reports usdPer1MPaperPerDay: USDC paid to stakers per 1,000,000 staked PAPER per day, measured from real history. complete: false means the protocol has less history than the window asks for.

2. Call the MCP server#

The endpoint speaks MCP Streamable HTTP and is stateless, so there is no session to open.

curl -s https://papertrade-yield.pages.dev/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

List the tools, then call one:

curl -s https://papertrade-yield.pages.dev/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

curl -s https://papertrade-yield.pages.dev/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_apr","arguments":{}}}'

3. Connect your AI#

For Claude Code:

claude mcp add --transport http papertrade-yield https://papertrade-yield.pages.dev/mcp

Then ask: "What did PAPER stakers earn per million PAPER over the last 7 days?" Other clients are on the Connect your AI page.

4. Look at one wallet#

curl -s 'https://papertrade-yield.pages.dev/api/staking/wallet?address=0x0000000000000000000000000000000000000001'

Replace the address with any HyperEVM address. The response has raw 18-decimal values as strings.

5. Use the web app#

Open papertrade-yield.pages.dev, paste an address for a read-only view, or connect a browser wallet to stake, unstake and claim. Every action opens a confirmation dialog first, and the wallet signs.

View this page as markdown