Swiss Whale Intelligence MCP

Methodology-transparent on-chain forensics for Bitcoin and Ethereum, exposed via the Model Context Protocol (MCP). Real-time whale alerts, per-address MVRV, Meiklejohn-canonical clusters, mining-pool attribution, OFAC SDN sanctions tagging. 30 tools, anonymous OAuth 2.1 Free tier.

🌐 Live server: https://mcp.btcwhalealerts.com/mcp 📘 Documentation + landing page: https://btcwhalealerts.com/mcp/ 📜 Methodology whitepaper (CC-BY-4.0, SHA256-pinned): https://btcwhalealerts.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.btcwhalealerts.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

In Claude Code:

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

In Claude Desktop, add to your claude_desktop_config.json:

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

In Cursor (Settings → MCP → Add Server):

URL: https://mcp.btcwhalealerts.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.

Tools (30)

24 free + 6 paid. Free-tier covers the everyday "what just happened on-chain?" questions.

Bitcoin (21 tools)

Ethereum (5 tools)

Benchmarks + Pro tools (4)

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, 24 of 30 tools accessible without signup. The 6 paid tools are historical-export and full-address-history — the things that would cost us bandwidth 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://btcwhalealerts.com/whitepaper/v1.md is published under CC-BY-4.0 and is freely citable in academic work.

Links

• Live MCP server: https://mcp.btcwhalealerts.com/mcp

• Landing + onboarding: https://btcwhalealerts.com/mcp/

• OAuth discovery: https://mcp.btcwhalealerts.com/.well-known/oauth-authorization-server

• OpenAPI spec: https://api.btcwhalealerts.com/openapi.json

• Methodology whitepaper: https://btcwhalealerts.com/whitepaper/v1.md

• Public ledger (transparency): https://btcwhalealerts.com/ledger/

• Status page: https://mcp.btcwhalealerts.com/.well-known/oauth-authorization-server

• Imprint + privacy: https://btcwhalealerts.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.