Kraken Portfolio

A portfolio tracker and tax tool for Kraken day traders in Germany. Connects to the Kraken Futures and Spot APIs, computes FIFO cost basis, and tells you if you owe tax.

What you get

Dashboard at http://localhost:8000 with:

• Cash balance across Futures and Spot accounts

• Tax overview with filing status (single/married) and allowance calculations

• Futures P&L and Spot P&L summaries

• Merged transaction history with source filtering, date range, and pagination

• Positions table with sorting, side filtering (Long/Short), and source filtering

• Everything filterable by year, shareable via URL

MCP Server for AI assistants (Claude Code, Cursor, Codex) to query your portfolio and generate tax reports.

REST API for programmatic access to all your Kraken data.

Related MCP server: zerion-mcp

Quick start

git clone <repo-url> && cd kraken-portfolio-mcp
npm install

Create .env:

KRAKEN_FUTURES_PUBLIC_KEY=your_key
KRAKEN_FUTURES_PRIVATE_KEY=your_key
KRAKEN_SPOT_API_KEY=your_key
KRAKEN_SPOT_API_SECRET=your_key

Run:

npm run dev     # dashboard with auto-reload
npm start       # production
npm run mcp     # MCP server for AI assistants

Open http://localhost:8000 and hit Sync.

Tax reporting

Built for German tax law. The dashboard shows a live tax overview per year. For a detailed report, ask your AI assistant:

Generate my German crypto tax report for 2025

The MCP tool handles everything:

• Spot trades FIFO cost basis, 1-year holding period check, Freigrenze (1,000 EUR)

• Margin positions P&L classified under private sales

• Futures realized P&L + funding fees, Sparerpauschbetrag (1,000/2,000 EUR), 20k loss cap

• Staking rewards at EUR fair market value, 256 EUR Freigrenze

Returns Elster line references and a CSV for WISO Steuer or Taxfix.

API

Futures

Spot

Other

MCP setup

Add to your AI client config:

{
  "mcpServers": {
    "kraken-portfolio": {
      "command": "npx",
      "args": ["tsx", "/path/to/kraken-portfolio-mcp/src/mcp-server.ts"],
      "env": {
        "KRAKEN_FUTURES_PUBLIC_KEY": "...",
        "KRAKEN_FUTURES_PRIVATE_KEY": "...",
        "KRAKEN_SPOT_API_KEY": "...",
        "KRAKEN_SPOT_API_SECRET": "..."
      }
    }
  }
}

Available tools

Tech

• TypeScript + Express

• MCP SDK for AI tool integration

• FIFO lot tracking for cost basis

• Server-Sent Events for live sync

• CoinGecko API for crypto icons

• No frontend framework single self-contained HTML page