PaperTax
Hyperliquid tax exports, papertrade trade view and a token launchpad with the $TAX airdrop
我該用這個嗎
品質與安全性
發現項目（4）
- HIGHTool poisoning patterns detected
- MEDIUMTool 'get_launchpad_info' description contains placeholder text在 get_launchpad_info 中
- MEDIUMTool description contains URL to non-standard domain在 create_verified_pnl 中
- LOWTool 'explain_tax_treatment' description lacks action verb在 explain_tax_treatment 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"papertax": {
"url": "https://papertax.xyz/mcp"
}
}
}遠端端點
https://papertax.xyz/mcpstreamable-http它能做什麼
工具清單
工具（6）
🟢get_tax_summary(address, tax_year, jurisdiction, sample)
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, and net after costs by market and by month.
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Public Hyperliquid wallet address"
},
"tax_year": {
"type": "string",
"enum": [
"AU-2027",
"AU-2026",
"US-2026",
"US-2025",
"UK-2027",
"UK-2026",
"CA-2026",
"CA-2025",
"NZ-2027",
"NZ-2026"
],
"description": "Tax year. AU-2027 = Australia · FY 2026–27; AU-2026 = Australia · FY 2025–26; US-2026 = United States · 2026; US-2025 = United States · 2025; UK-2027 = United Kingdom · 2026–27; UK-2026 = United Kingdom · 2025–26; CA-2026 = Canada · 2026; CA-2025 = Canada · 2025; NZ-2027 = New Zealand · 2026–27; NZ-2026 = New Zealand · 2025–26. Defaults to the year being filed now."
},
"jurisdiction": {
"type": "string",
"enum": [
"AU",
"US",
"UK",
"CA",
"NZ"
],
"default": "AU",
"description": "Used when tax_year is not given. AU = 1 Jul–30 Jun; US and CA = calendar year; UK = 6 Apr–5 Apr; NZ = 1 Apr–31 Mar"
},
"sample": {
"type": "boolean",
"default": false,
"description": "Return deterministic sample data instead of reading Hyperliquid"
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢get_ledger_events(address, tax_year, jurisdiction, sample, unlock_token, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Public Hyperliquid wallet address"
},
"tax_year": {
"type": "string",
"enum": [
"AU-2027",
"AU-2026",
"US-2026",
"US-2025",
"UK-2027",
"UK-2026",
"CA-2026",
"CA-2025",
"NZ-2027",
"NZ-2026"
],
"description": "Tax year. AU-2027 = Australia · FY 2026–27; AU-2026 = Australia · FY 2025–26; US-2026 = United States · 2026; US-2025 = United States · 2025; UK-2027 = United Kingdom · 2026–27; UK-2026 = United Kingdom · 2025–26; CA-2026 = Canada · 2026; CA-2025 = Canada · 2025; NZ-2027 = New Zealand · 2026–27; NZ-2026 = New Zealand · 2025–26. Defaults to the year being filed now."
},
"jurisdiction": {
"type": "string",
"enum": [
"AU",
"US",
"UK",
"CA",
"NZ"
],
"default": "AU",
"description": "Used when tax_year is not given. AU = 1 Jul–30 Jun; US and CA = calendar year; UK = 6 Apr–5 Apr; NZ = 1 Apr–31 Mar"
},
"sample": {
"type": "boolean",
"default": false,
"description": "Return deterministic sample data instead of reading Hyperliquid"
},
"unlock_token": {
"type": "string",
"description": "Unlock token returned by buy_report (or the website after paying), for wallets bought without an API key"
},
"type": {
"type": "string",
"enum": [
"open",
"loss",
"liq",
"gain",
"queued",
"funding",
"mint",
"stake",
"stakepay",
"spotbuy",
"spotgain",
"spotloss",
"vaultin",
"vaultgain",
"vaultloss",
"income",
"airdrop",
"xfer",
"evmswap",
"defiin",
"defiout",
"receive"
]
},
"venue": {
"type": "string",
"description": "Venue key: hl (perps), hip3:<dex> (e.g. hip3:xyz), spot, vault, staking, evm (HyperEVM), pt (papertrade), fork, core (deposits and transfers)"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"default": 100
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢export_tax_file(address, tax_year, jurisdiction, sample, unlock_token, ...)
Koinly universal CSV, Crypto Tax Calculator advanced CSV, 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.
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Public Hyperliquid wallet address"
},
"tax_year": {
"type": "string",
"enum": [
"AU-2027",
"AU-2026",
"US-2026",
"US-2025",
"UK-2027",
"UK-2026",
"CA-2026",
"CA-2025",
"NZ-2027",
"NZ-2026"
],
"description": "Tax year. AU-2027 = Australia · FY 2026–27; AU-2026 = Australia · FY 2025–26; US-2026 = United States · 2026; US-2025 = United States · 2025; UK-2027 = United Kingdom · 2026–27; UK-2026 = United Kingdom · 2025–26; CA-2026 = Canada · 2026; CA-2025 = Canada · 2025; NZ-2027 = New Zealand · 2026–27; NZ-2026 = New Zealand · 2025–26. Defaults to the year being filed now."
},
"jurisdiction": {
"type": "string",
"enum": [
"AU",
"US",
"UK",
"CA",
"NZ"
],
"default": "AU",
"description": "Used when tax_year is not given. AU = 1 Jul–30 Jun; US and CA = calendar year; UK = 6 Apr–5 Apr; NZ = 1 Apr–31 Mar"
},
"sample": {
"type": "boolean",
"default": false,
"description": "Return deterministic sample data instead of reading Hyperliquid"
},
"unlock_token": {
"type": "string",
"description": "Unlock token returned by buy_report (or the website after paying), for wallets bought without an API key"
},
"format": {
"type": "string",
"enum": [
"koinly",
"ctc",
"summary",
"audit",
"auditpdf"
],
"default": "koinly"
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢explain_tax_treatment(jurisdiction, event_type)
PaperTax's default treatment notes for Australia, the US, the UK, Canada or New Zealand, optionally for one event type. Not tax advice.
輸入結構描述
{
"type": "object",
"properties": {
"jurisdiction": {
"type": "string",
"enum": [
"AU",
"US",
"UK",
"CA",
"NZ"
],
"default": "AU",
"description": "Used when tax_year is not given. AU = 1 Jul–30 Jun; US and CA = calendar year; UK = 6 Apr–5 Apr; NZ = 1 Apr–31 Mar"
},
"event_type": {
"type": "string",
"enum": [
"loss",
"liq",
"gain",
"queued",
"funding",
"mint",
"stakepay",
"spotgain",
"spotloss",
"vaultgain",
"vaultloss",
"income",
"airdrop",
"xfer",
"evmswap",
"defiin",
"defiout",
"receive"
]
}
},
"additionalProperties": false
}🟢create_verified_pnl(address, tax_year, jurisdiction, amounts, private)
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.
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Public Hyperliquid wallet address"
},
"tax_year": {
"type": "string",
"enum": [
"AU-2027",
"AU-2026",
"US-2026",
"US-2025",
"UK-2027",
"UK-2026",
"CA-2026",
"CA-2025",
"NZ-2027",
"NZ-2026"
],
"description": "Tax year. AU-2027 = Australia · FY 2026–27; AU-2026 = Australia · FY 2025–26; US-2026 = United States · 2026; US-2025 = United States · 2025; UK-2027 = United Kingdom · 2026–27; UK-2026 = United Kingdom · 2025–26; CA-2026 = Canada · 2026; CA-2025 = Canada · 2025; NZ-2027 = New Zealand · 2026–27; NZ-2026 = New Zealand · 2025–26. Defaults to the year being filed now."
},
"jurisdiction": {
"type": "string",
"enum": [
"AU",
"US",
"UK",
"CA",
"NZ"
],
"default": "AU",
"description": "Used when tax_year is not given. AU = 1 Jul–30 Jun; US and CA = calendar year; UK = 6 Apr–5 Apr; NZ = 1 Apr–31 Mar"
},
"amounts": {
"type": "boolean",
"default": false,
"description": "Include net result, gains, losses and fees"
},
"private": {
"type": "boolean",
"default": true,
"description": "Leave the wallet address out of the link and page"
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢get_launchpad_info(address)
How the PaperTax token launchpad works (HyperEVM testnet now): the 2% pool fee split, what $TAX and PAPER stakers get, the $TAX platform token's split, and the contract addresses (not yet deployed; $TAX address coming soon). With an address, also returns that wallet's PAPER stake on papertrade at the latest HyperEVM mainnet block and whether it currently qualifies for the $TAX airdrop (1,000+ PAPER staked; the airdrop itself depends on the stake at the snapshot taken at launch).
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Optional wallet address to check its PAPER stake"
}
},
"additionalProperties": false
}社群
證據