papertax is listed as active in the registry but did not answer our last check. It exposes 11 tools.
Hyperliquid tax reports and Koinly/CTC exports for agents
Uptime history
24 days of history · worst day 0%
24 days agonow
0.0%
Uptime 24h
0 of 92 checks
11
Tools
read from the server
132 ms
Response time
average over 24h
open, no key
Access
streamable-http
What changed 21
Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 17 October 2026. No other catalogue keeps this.
25 Oct
5 tools appeared
buy_report, get_papertrade_positions, get_papertrade_results and 2 more
25 Oct
5 tools changed the parameters they ask for
create_verified_pnl, explain_tax_treatment, export_tax_file and 2 more
25 Oct
4 tool descriptions were rewritten
explain_tax_treatment, export_tax_file, get_games and 1 more
25 Oct
a tool disappeared
get_launchpad_info
18 Oct
a tool appeared
get_games
18 Oct
a tool description was rewritten
create_verified_pnl
18 Oct
a tool changed the parameters it asks for
create_verified_pnl
17 Oct
a tool description was rewritten2 times that day
get_launchpad_info
17 Oct
a tool changed version
and 1 more, back to 17 October 2026
papertax does not always answer
Over the last week it answered 0.0% of our checks. We check every 15 minutes, so you hear about the next outage within the hour — not from your users.
Connect this server
Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 0 min ago.
run in your terminal
claude mcp add papertax --transport http https://papertax.xyz/mcpSettings → Connectors → Add custom connector, then paste this address
https://papertax.xyz/mcp~/.codex/config.toml
[mcp_servers.papertax]
url = "https://papertax.xyz/mcp".cursor/mcp.json
{
"mcpServers": {
"papertax": {
"url": "https://papertax.xyz/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"papertax": {
"type": "http",
"url": "https://papertax.xyz/mcp"
}
}
}Available tools 11
Read directly from the server with tools/list, grouped by what they act on.
If a tool disappears, we record the date.
papertrade
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 are my positions doing?". Closing or opening needs the wallet's signature on papertax.xyz.
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?".
buy
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 quote: send exactly that USDC amount on HyperEVM (chain 999) to the given address, then call again with quote_id and tx_hash. (x402 clients can instead pay in USDC on Base or Solana at GET https://papertax.xyz/api/buy?address=…&year=….) Returns an unlock_token and export links. This spends money: confirm with the user first.
explain
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.
export
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 wallets need paid access (API key or paid report). Large files are cut short with a download link.
games
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; playing needs the website and a wallet, and games open when trading on papertax goes live.
ledger
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 access, live wallets return the first 10 rows.
preview
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 tax advice; nothing is closed.
tax
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 full report's price for this caller, whether they already have access, and how to buy it.
top
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.
verified
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 address is left out of the link and the page; with private false the page shows it, so check with the user first. It proves what the wallet did, not who owns it.
Tools removed
Tools this server used to expose. Anything built against them stopped working on the day they went.
get_launchpad_info
removed 25 Oct 2026
Endpoints
| URL | Transport | State | Latency | Checked |
|---|---|---|---|---|
| https://papertax.xyz/mcp | streamable-http | answering | 132 ms | 0 min ago |
Alternatives to papertax
same job, measured the same wayCrypto Market Data
by zaffy18
Live crypto market data and Hyperliquid wallet reports for AI agents, paid per call with x402.
PDF MCP
by wesseltl
Extract text and tables from PDFs for an agent: invoices, reports, statements.
Agent Ready Report
by agenticplug
Scan any public website and see how ready it is for AI agents and AI search, explained plainly.
Agentloopkit
by abhiyoheswaran1
Read-only MCP server for AgentLoopKit tasks, policies, reports, handoffs, and status.
Receipt Expense Scanner Reports
by theluckystrike
Log expenses and export clean reports for tax time - your ledger never leaves your machine.
Codesign
by img
Local design engine for AI agents: create, edit and export real, editable designs.
Execute defi-yield-tax-reporter-mcp
by evozim
Premium agentic endpoint for defi-yield-tax-reporter-mcp.
rag-rat
by cq27-dev
Repository intelligence, code graph, history, papertrail, and cross-agent memory for coding agents.
papertax — questions
Answers built from our own checks of this server.
What can papertax do?
It exposes 11 tools, read directly from the server on our last check. Among them: buy_report, create_verified_pnl, explain_tax_treatment, export_tax_file, get_games, get_ledger_events and 5 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README.
How MCP servers expose tools in the first place →
Is papertax working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 0 of 92 checks got a reply (0.0%), average response time 132 ms. The bar chart above shows every period we have measured.
Did papertax ever remove tools?
Yes. get_launchpad_info is no longer exposed — we recorded the date each one disappeared. A tool vanishing usually means a breaking change for anything that depended on it.
The registry lists papertax as active — why does it not respond?
The official MCP registry stores what the author submitted; it does not verify that the server still runs. We check the endpoint ourselves, and this one does not answer. Catalogues that copy the registry without checking will show it as working.
How do I connect papertax?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does papertax need an API key?
No. papertax completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 11 of them are readable on this page. This is what we observed, not what the docs claim.