All servers · Crypto & blockchain · Payments & accounting

papertax

io.github.AwakeWeb3/papertax · v0.16.0

Measured by MCP Station

Description written by the publisher, not verified

Hyperliquid tax reports and Koinly/CTC exports, papertrade positions and top traders for agents

Connect

claude mcp add --transport http papertax https://papertax.xyz/mcp

{
  "mcpServers": {
    "papertax": {
      "url": "https://papertax.xyz/mcp"
    }
  }
}

Tools as reported by the server

• get_tax_summary
  Free. Per-venue realised gains and losses, fees, funding, liquidations, open positions and items needing review for one wallet and tax year, plus trading analytics (fee and funding drag, liquidation review, net after costs by market and month). For live wallets, report gives the event count, the ful
• get_ledger_events
  Individual ledger rows with default tax classification: perp opens, closes, liquidations and funding; spot buys and sells; vault deposits and withdrawals; staking rewards; HyperEVM swaps and protocol deposits; transfers; papertrade mints and staking. Filter by event type or venue. Without paid acces
• export_tax_file
  Koinly universal CSV, Crypto Tax Calculator advanced CSV, Cryptact custom file (JST, priced in yen by Cryptact), plain-text accountant summary, or the audit pack (audit = JSON with every figure tied to its transaction hash, a rules version and a data fingerprint; auditpdf = the printable PDF). Live
• explain_tax_treatment
  papertax's default treatment notes for Australia, the US, the UK, Canada, New Zealand, Japan or Spain, optionally for one event type. Not tax advice.
• create_verified_pnl
  Read a wallet's results for one tax year from the chain and return a public, signed link (https://papertax.xyz/v/…) with a share image, for posting on X or anywhere else. Free, and nothing is stored. Dollar amounts are included only when amounts is true. With private true (the default) the wallet ad
• buy_report
  Buy the full report for one wallet and tax year ($29 up to 500 events, $59 up to 5,000, $99 above; upgrades charge the difference). method "card" charges the account owner's saved card: needs Authorization: Bearer ptx_… and the owner's opt-in; set max_price_cents to cap it. method "usdc" returns a q
• get_papertrade_positions
  Free, read-only. A wallet's papertrade (BTC and ETH perps on HyperEVM) balance and open positions: market, side, leverage, margin, entry, current price, liquidation price and how far away it is, and what each would keep if closed now, after papertrade's impact haircut and 2% win fee. Answers "how ar
• preview_papertrade_close
  Free, read-only. What closing one papertrade position (or all of them) would keep at the current price or a price you give, and what that does to the wallet's realised net for a tax year (all venues, and papertrade alone). Answers "what would closing my ETH long do to my tax year?". An estimate, not
• get_papertrade_results
  Free, read-only. What a wallet kept from papertrade closes over a period (default the last 30 days): closes, wins, losses, liquidations, win fees paid, PAPER minted, by market, and the best and worst trade. Answers "what did I keep this month?".
• get_top_traders
  Free, read-only. papertrade's top traders by profit and loss over 24h, 7d, 30d or all time, or a search by leaderboard name or wallet, with the X account a trader signed in with, if any, and a link to their page on papertax.xyz/traders, where people can follow them. Not recommendations.
• get_games
  How papertax games work (Edge, Climb, and 1v1 and Pit rooms on real papertrade positions, with crews and weekly leaderboards), this week's boards (top 10 players or crews; players show as their X account, papertrade name or wallet), open and live rooms, and the Bulls vs Bears tally. Read-only; playi

Tool changes

• 2026-10-20: get_tax_summary, get_ledger_events, export_tax_file, explain_tax_treatment, create_verified_pnl, buy_report, get_papertrade_positions, preview_papertrade_close, get_papertrade_results, get_top_traders, get_games
• 2026-10-18: get_tax_summary, get_ledger_events, export_tax_file, explain_tax_treatment, create_verified_pnl, get_launchpad_info, get_games
• 2026-10-18: get_tax_summary, get_ledger_events, export_tax_file, explain_tax_treatment, create_verified_pnl, get_launchpad_info, get_games
• 2026-10-18: get_tax_summary, get_ledger_events, export_tax_file, explain_tax_treatment, create_verified_pnl, get_launchpad_info, get_games
• 2026-10-17: get_tax_summary, get_ledger_events, export_tax_file, explain_tax_treatment, create_verified_pnl, get_launchpad_info

Website · JSON · Text for agents · Registry updated 2026-10-19