Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "papertax": {
      "type": "http",
      "url": "https://papertax.xyz/mcp",
      "headers": {
        "Authorization": "Bearer ${PAPERTAX_TOKEN}"
      }
    }
  }
}

claude mcp add --transport http papertax https://papertax.xyz/mcp --header "Authorization: Bearer ${PAPERTAX_TOKEN}"

[mcp_servers.papertax]
url = "https://papertax.xyz/mcp"
bearer_token_env_var = "PAPERTAX_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "papertax": {
      "type": "remote",
      "url": "https://papertax.xyz/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:PAPERTAX_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "papertax": {
      "type": "http",
      "url": "https://papertax.xyz/mcp",
      "headers": {
        "Authorization": "Bearer ${PAPERTAX_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=papertax&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcGFwZXJ0YXgueHl6L21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke1BBUEVSVEFYX1RPS0VOfSJ9fQ%3D%3D"
}

{
  "servers": {
    "papertax": {
      "type": "http",
      "url": "https://papertax.xyz/mcp",
      "headers": {
        "Authorization": "Bearer ${PAPERTAX_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "papertax": {
      "httpUrl": "https://papertax.xyz/mcp",
      "headers": {
        "Authorization": "Bearer ${PAPERTAX_TOKEN}"
      }
    }
  }
}

extensions:
  "papertax":
    enabled: true
    name: "papertax"
    type: streamable_http
    uri: "https://papertax.xyz/mcp"
    headers:
      "Authorization": "Bearer ${PAPERTAX_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${PAPERTAX_TOKEN}. The registry never accepts secret values.

Quality 89 / 100new

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene100 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations8 of 8 tools declare readOnlyHint or destructiveHint
pass
tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
pass
tools.token_costabout 3,208 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool history recorded for 3 of the 7 days needed

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

8 tools, about 3,208 tokens to load them all · tool set 70f0b69bcde1 · tools last changed 2026-10-19 · checked 2026-10-19 10:20 UTC

Tool changes

2026-10-19get_launchpad_infochangeddescriptionmeaning changed
before
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).
after · 30% of words in common
Status and design notes for the papertax token launchpad and the $TAX token. Both are paused: nothing is deployed (not even on testnet), and there is nothing to launch, stake, claim or buy. Use this to answer questions about the pause or how the launchpad was designed (pool fee split, $TAX allocation). Official news comes only from X @papertaxdev. With an address, also returns that wallet's current PAPER stake on papertrade (public on-chain data); this says nothing about any future airdrop.
2026-10-19buy_reportadded
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.
2026-10-19create_verified_pnlchangedinput schema
2026-10-19explain_tax_treatmentchangeddescription, input schema
before
papertax's default treatment notes for Australia, the US, the UK, Canada or New Zealand, optionally for one event type. Not tax advice.
after · 91% of words in common
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.
2026-10-19export_tax_filechangeddescription, input schema, annotations
before
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.
after · 86% of words in common
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.
2026-10-19get_ledger_eventschangedinput schema, annotations
2026-10-19get_tax_summarychangeddescription, input schema
before
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.
after · 59% of words in common
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.
2026-10-18get_gameschangedtitle, description
before
How PaperTax games work (Liquidation Chicken, The Run, Duel and Lobby rooms on real papertrade positions, with crews and weekly leaderboards), this week's boards (top 10 named players or crews; wallets are never shown), open and live rooms, and the Bulls vs Bears tally. Read-only; playing needs the website and a wallet.
after · 82% of words in common
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 named players or crews; wallets are never shown), open and live rooms, and the Bulls vs Bears tally. Read-only; playing needs the website and a wallet.
2026-10-18get_launchpad_infochangedtitle, description
before
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).
after · 100% of words in common
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).
2026-10-18explain_tax_treatmentchangeddescription
before
PaperTax's default treatment notes for Australia, the US, the UK, Canada or New Zealand, optionally for one event type. Not tax advice.
after · 100% of words in common
papertax's default treatment notes for Australia, the US, the UK, Canada or New Zealand, optionally for one event type. Not tax advice.

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 80 / 100

no-repository

provenance45

liveness100

freshness100

hygiene80

+website +reachable +uptime-100% +updated-1d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://papertax.xyz/mcp` streamable-http	none	yes	100%	939 ms	2025-11-25	2026-10-19

Tools (8)

`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.
`create_verified_pnl`read-only	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.
`explain_tax_treatment`read-only	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_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.
`get_games`read-only	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 named players or crews; wallets are never shown), open and live rooms, and the Bulls vs Bears tally. Read-only; playing needs the website and a wallet.
`get_launchpad_info`read-only	Status and design notes for the papertax token launchpad and the $TAX token. Both are paused: nothing is deployed (not even on testnet), and there is nothing to launch, stake, claim or buy. Use this to answer questions about the pause or how the launchpad was designed (pool fee split, $TAX allocation). Official news comes only from X @papertaxdev. With an address, also returns that wallet's current PAPER stake on papertrade (public on-chain data); this says nothing about any future airdrop.
`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.
`get_tax_summary`read-only	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.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.AwakeWeb3/papertax",
  "icons": [
    {
      "src": "https://papertax.xyz/assets/icon-256.png",
      "sizes": [
        "256x256"
      ],
      "mimeType": "image/png"
    }
  ],
  "title": "PaperTax",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://papertax.xyz/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Optional. 'Bearer ptx_...' PaperTax API key for full ledgers, exports and card purchases; summaries work without it."
        }
      ]
    }
  ],
  "version": "0.10.0",
  "websiteUrl": "https://papertax.xyz",
  "description": "Hyperliquid tax exports, papertrade trade view and a token launchpad with the $TAX airdrop"
}