multichain-tax-mcp

MCP server for multi-chain crypto tax reporting — Stacks, Celo, Base, Solana, BNB.

Gives Claude (and other MCP-compatible AI assistants) real-time access to on-chain transaction history, classification, PnL calculation, and tax report generation across five blockchains.

Install

npx @wkalidev/multichain-tax-mcp

Or add to your Claude Desktop config:

{
  "mcpServers": {
    "multichain-tax": {
      "command": "npx",
      "args": ["-y", "@wkalidev/multichain-tax-mcp"],
      "env": {
        "MULTICHAIN_TAX_LICENSE_KEY": "your-key-here"
      }
    }
  }
}

Tools

Free (no license key required)

| Tool | Description | |------|-------------| | get_transaction_history | Fetch all transactions for a wallet on a chain | | classify_transactions | Classify transactions by tax category |

Launch offer — use code TAXLAUNCH30 for 30% off your first 3 months

Pro — $19/mo

| Tool | Description | |------|-------------| | calculate_pnl | Realized/unrealized PnL with short/long-term breakdown | | get_tax_report | Form 8949 + Schedule D equivalent |

Team — $49/mo

| Tool | Description | |------|-------------| | export_csv | CSV export across multiple chains | | batch_wallets | Process many wallets in one call |

Supported Chains

| Chain | Provider | |-------|----------| | Stacks | Hiro API | | Celo | Alchemy RPC | | Base | Alchemy RPC | | Solana | Helius API | | BNB | BSCScan API |

Configuration

Copy .env.example to .env and fill in your keys:

cp .env.example .env

| Variable | Required | Description | |----------|----------|-------------| | MULTICHAIN_TAX_LICENSE_KEY | For Pro/Team | Lemon Squeezy license key | | LS_WEBHOOK_SECRET | For webhook | Lemon Squeezy webhook signing secret | | LS_API_KEY | Optional | Lemon Squeezy API key | | HIRO_API_URL | Optional | Defaults to https://api.hiro.so | | ALCHEMY_API_KEY | Optional | For Celo and Base | | HELIUS_API_KEY | Optional | For Solana | | BSCSCAN_API_KEY | Optional | For BNB | | COINGECKO_API_KEY | Optional | Historical/current USD pricing for PnL calculations; works without one at lower rate limits | | RESEND_API_KEY | Optional | For transactional email |

License Gating

License validation happens at server startup via the Lemon Squeezy API. The MULTICHAIN_TAX_LICENSE_KEY env var is matched against the meta.variant_name field in the LS validate response — must be exactly "Pro" or "Team". Any error or missing key falls back to "Free".

Development

npm install
npm run build
npm start

Deployment

Vercel

The repository is structured for zero-config Vercel deployment:

| Path | What Vercel does | |------|-----------------| | public/index.html | Served as the static landing page at / | | api/webhook.cjs | Deployed as a serverless function at /api/webhook | | /webhook | Rewritten to /api/webhook via vercel.json |

Deploy steps:

1. Install the Vercel CLI and log in:

   npm i -g vercel
   vercel login

2. Add each environment variable in the Vercel dashboard (Project → Settings → Environment Variables) or via CLI:

   vercel env add MULTICHAIN_TAX_LICENSE_KEY
   vercel env add LS_WEBHOOK_SECRET
   vercel env add LS_API_KEY
   vercel env add HIRO_API_URL          # default: https://api.hiro.so
   vercel env add ALCHEMY_API_KEY
   vercel env add HELIUS_API_KEY
   vercel env add BSCSCAN_API_KEY
   vercel env add COINGECKO_API_KEY
   vercel env add RESEND_API_KEY

3. Deploy:

   vercel deploy --prod

Required environment variables

| Variable | Required for | Notes | |----------|-------------|-------| | MULTICHAIN_TAX_LICENSE_KEY | Pro / Team features | Lemon Squeezy license key | | LS_WEBHOOK_SECRET | Webhook signature verification | Lemon Squeezy signing secret | | LS_API_KEY | License validation API calls | Lemon Squeezy API key | | HIRO_API_URL | Stacks chain | Defaults to https://api.hiro.so | | ALCHEMY_API_KEY | Celo + Base chains | Alchemy API key (not the full URL) | | HELIUS_API_KEY | Solana chain | Helius API key | | BSCSCAN_API_KEY | BNB chain | BSCScan / Etherscan V2 key | | COINGECKO_API_KEY | PnL/tax-report pricing | Optional; raises CoinGecko rate limits | | RESEND_API_KEY | Transactional email | Resend API key |

License

MIT