Swiss Whale Intelligence MCP

Methodology-transparent multi-asset on-chain forensics for Bitcoin, Ethereum, Solana, USDT (ETH + Tron), and tokenized gold (XAUT + PAXG), exposed via the Model Context Protocol (MCP). Real-time whale alerts, per-address MVRV, Meiklejohn-canonical clusters, mining-pool attribution, OFAC SDN sanctions tagging, treasury mint/burn events, plain-English glossary lookups. 45 tools, anonymous OAuth 2.1 Free tier.

🌐 Live server: https://mcp.swisswhaleintelligence.com/mcp 📘 Documentation + landing page: https://swisswhaleintelligence.com/mcp/ 📜 Methodology whitepaper (CC-BY-4.0, SHA256-pinned): https://swisswhaleintelligence.com/whitepaper/v1.md ✅ Status: Production. Listed in the official MCP Registry as io.github.alpineflow-io/swiss-whale-intelligence.

This repository contains the public metadata for the Swiss Whale Intelligence MCP server: documentation, install instructions, tool inventory, and methodology references. The server itself is hosted at mcp.swisswhaleintelligence.com — no clone, no install, no Docker required to use it.

What it does

Connect any MCP client (Claude Desktop, Claude Code, Cursor, ChatGPT plugins, custom agents) to a 4.7-million-transaction on-chain dataset for Bitcoin and Ethereum.

The server answers questions like:

• "Show me Bitcoin whale transactions over 1,000 BTC in the last 6 hours."
• "What's the MVRV state of address bc1q...? Is it in profit or loss?"
• "List the addresses that share a Meiklejohn cluster with this one."
• "Which mining pool extracted the most blocks last week?"
• "Compare BTC's risk-adjusted return vs SPY and Gold over the last quarter."
• "Which dormant wallets just woke up after being inactive for 5+ years?"
• "Is this address on the OFAC SDN list?"

Returns are first-party data only — no vendor labels, no AI-generated summaries presented as facts.

Install

Direct (recommended)

In Claude Code:

claude mcp add btc-whale-intelligence https://mcp.swisswhaleintelligence.com/mcp

In Claude Desktop, add to your claude_desktop_config.json:

{
  "mcpServers": {
    "btc-whale-intelligence": {
      "url": "https://mcp.swisswhaleintelligence.com/mcp"
    }
  }
}

In Cursor (Settings → MCP → Add Server):

URL: https://mcp.swisswhaleintelligence.com/mcp

OAuth 2.1 with anonymous Free tier — your client is auto-granted Free-tier access on first connect, no signup, no API key to copy-paste. Upgrade flow is in-product if you want paid-tier access.

Via Smithery Gateway (alternative)

If your MCP client has trouble with OAuth discovery or you want Smithery's built-in observability:

claude mcp add btc-whale-intelligence https://swiss-whale-intelligence.run.tools

Smithery's gateway proxies the connection and handles OAuth on behalf of the client. Slightly more latency, but smoother for some setups.

Tools (45)

38 free + 7 paid. Free-tier covers the everyday "what just happened on-chain?" questions across all 5 assets.

Bitcoin (21 tools)

Ethereum (5 tools)

Solana (4 tools — NEW since 2026-05)

USDT (4 tools — Ethereum + Tron)

Tokenized Gold (3 tools — XAUT + PAXG)

Glossary (2 tools — NEW since 2026-05)

Benchmarks + AI + Pro tools (6)

Why this exists

Most on-chain data services either (a) charge enterprise prices for everything ($799+/mo Glassnode Professional) or (b) sell convenient summaries without showing how they were computed. We do neither.

Three concrete differentiators:

1. Methodology-transparent. Every metric the server returns is reproducible from documented heuristics. The published whitepaper (CC-BY-4.0, SHA256-pinned) covers cluster computation (Meiklejohn 2013 + ETH hybrid L1+L3), MVRV (UTXO-age × historical price), and mining-pool attribution (coinbase-tag matching, 99.6% YTD coverage). Limitations — CoinJoin, PayJoin, pre-2014 data — are explicit, not hidden.

2. First-party data only. No vendor labels we couldn't ourselves verify. The label sources are public and citable (OFAC SDN, Etherscan public labels, MyEtherWallet darklist, Scamsniffer). A separate entity_label_imports audit table tracks every label-source run.

3. Free tier means free. Anonymous OAuth 2.1, 38 of 45 tools accessible without signup. The 7 paid tools are historical-export, full-address-history, and the AI-powered whale_explain synthesis — the things that would cost us bandwidth or LLM-credits at scale.

Verification

Three external audit reports, all green:

Reports available on request — happy to share with reviewers, partners, or anyone evaluating the server's reliability.

Pricing

Excludes 8.1% Swiss VAT for CH residents.

License

This repository (README and any docs/examples) is published under the MIT License. Anyone is free to fork, adapt, or redistribute the documentation.

The MCP server source code is not in this repository — it runs as a hosted service operated by Catering & Event Services GmbH from Switzerland. The methodology whitepaper at https://swisswhaleintelligence.com/whitepaper/v1.md is published under CC-BY-4.0 and is freely citable in academic work.

Links

• Live MCP server: https://mcp.swisswhaleintelligence.com/mcp
• Landing + onboarding: https://swisswhaleintelligence.com/mcp/
• OAuth discovery: https://mcp.swisswhaleintelligence.com/.well-known/oauth-authorization-server
• OpenAPI spec: https://swisswhaleintelligence.com/openapi.json
• Methodology whitepaper: https://swisswhaleintelligence.com/whitepaper/v1.md
• Public ledger (transparency): https://swisswhaleintelligence.com/ledger/
• Status page: https://mcp.swisswhaleintelligence.com/.well-known/oauth-authorization-server
• Imprint + privacy: https://swisswhaleintelligence.com/imprint/

About alpineflow-io

alpineflow-io is the engineering identity behind Swiss Whale Intelligence and related on-chain tooling. Built and operated independently from Switzerland.