Swiss Whale Intelligence

by alpineflow-io

700 downloads

Not rated

GitHub

Finance

About

**Swiss Whale Intelligence MCP** — 45 on-chain analytics tools for **Bitcoin, Ethereum, Solana, USDT (ETH + Tron), and tokenized gold (XAUT + PAXG)**, exposed via Model Context Protocol with anonymous OAuth 2.1 (Free tier, no signup required to install).

Details

Author: alpineflow-io
Downloads: 700
Categories: Finance

- Methodology‑transparent on‑chain forensics for five assets.
- 45 tools: whale alerts, MVRV, clusters, mining attribution.
- Real‑time whale alerts and dormant wallet wake‑ups.
- OFAC SDN sanctions tagging for addresses.
- Free tier: 24 tools, 10 API calls/day, no signup.
- First‑party data only – no vendor labels.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Swiss Whale Intelligence

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

From the repository

No installation is required. Add the server URL (https://mcp.swisswhaleintelligence.com/mcp) to any MCP client (e.g., Claude Desktop, Claude Code, Cursor). The anonymous OAuth 2.1 Free tier is auto‑granted on first connect; use the included whale_my_status tool to confirm your tier.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "swiss whale intelligence": {
            "swiss-whale-intelligence": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.swisswhaleintelligence.com/mcp"
                ]
            }
        }
    }
}

McpServers

{
    "swiss-whale-intelligence": {
        "command": "npx",
        "args": [
            "-y",
            "mcp-remote",
            "https://mcp.swisswhaleintelligence.com/mcp"
        ]
    }
}

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)

| Tool | Free? | Description |
|---|---|---|
| whale_my_status | ✅ | Show authenticated user's tier and capabilities |
| whale_recent | ✅ | Recent BTC whale transactions (filterable by min_btc, flow_type, hours) |
| whale_top_holders | ✅ | Top BTC holders by current balance |
| whale_top_coins | ✅ | Top crypto coins by market cap with current prices |
| whale_lookup | ✅ | Lookup BTC address details (balance, history, cluster) |
| whale_lookup_any | 💎 | Universal address lookup (any chain) — Pro tier |
| whale_tx_detail | ✅ | Detailed BTC transaction analysis with cluster + flow context |
| whale_address_cluster | ✅ | Get Meiklejohn cluster for a BTC address |
| whale_address_mvrv | ✅ | MVRV per BTC address (profit/loss state) |
| whale_address_story | ✅ | Wallet-story timeline (key events, dormancy, large moves) |
| whale_cohort_breakdown | ✅ | BTC whale activity by holder-size cohort |
| whale_exchange_flows | ✅ | Exchange inflows/outflows over a time window |
| whale_frequency_context | ✅ | How rare is this whale activity vs historical baseline |
| whale_btc_price | ✅ | Current BTC price + 24h change |
| whale_btc_indicators | ✅ | BTC indicators (Pi Cycle Top, Stock-to-Flow, dominance) |
| whale_fear_greed | ✅ | Crypto Fear & Greed Index (alternative.me) |
| whale_dominance | ✅ | BTC + ETH market dominance |
| whale_dormant_wakeups | ✅ | Recently-awakened dormant whale addresses |
| whale_hodl_wave | ✅ | UTXO age distribution (HODL waves) |
| whale_sopr | ✅ | Spent Output Profit Ratio for whale cohort |
| whale_miner_balances | ✅ | Mining pool balance snapshots |
| whale_entity_search | ✅ | Search known entities (exchanges, OFAC, mining pools) |

Ethereum (5 tools)

| Tool | Free? | Description |
|---|---|---|
| whale_eth_recent | ✅ | Recent ETH whale transactions |
| whale_eth_cohort_breakdown | ✅ | ETH whale activity by holder-size cohort |
| whale_eth_address_cluster | ✅ | Get hybrid L1+L3 cluster for an ETH address |
| whale_eth_cluster_members | ✅ | List all members of an ETH cluster |
| whale_eth_mvrv | ✅ | MVRV per ETH address (3-tier doctrine) |

Solana (4 tools — NEW since 2026-05)

| Tool | Free? | Description |
|---|---|---|
| whale_sol_recent | ✅ | Recent SOL whale transactions (native + SPL token transfers) |
| whale_sol_address | ✅ | SOL address profile (rent-reclaim-aware balance) |
| whale_sol_top_movers | ✅ | Top SOL movers over a time window |
| whale_sol_flow_breakdown | ✅ | SOL flow classification (CEX / DEX / wallet-to-wallet) |

USDT (4 tools — Ethereum + Tron)

| Tool | Free? | Description |
|---|---|---|
| whale_usdt_recent | ✅ | Recent USDT whale transfers across both chains |
| whale_usdt_address | ✅ | Per-address USDT activity (chain-agnostic) |
| whale_usdt_lookup | ✅ | USDT address profile + label resolution |
| whale_usdt_treasury_events | ✅ | Tether-Treasury mint/burn events |

Tokenized Gold (3 tools — XAUT + PAXG)

| Tool | Free? | Description |
|---|---|---|
| whale_gold_recent | ✅ | Recent gold-token whale transfers (combined XAUT + PAXG) |
| whale_gold_top_holders | ✅ | Top tokenized-gold holders, optionally filtered by issuer |
| whale_gold_supply | ✅ | Gold-supply mint/burn events (macro signal) |

Glossary (2 tools — NEW since 2026-05)

| Tool | Free? | Description |
|---|---|---|
| whale_glossary_lookup | ✅ | Plain-English definition of an on-chain term (MVRV, SOPR, HODL waves, etc.) |
| whale_glossary_search | ✅ | Search glossary by keyword (returns trilingual EN/DE/ES definitions) |

Benchmarks + AI + Pro tools (6)

| Tool | Free? | Description |
|---|---|---|
| whale_benchmark_compare | ✅ | Compare BTC strategies vs SPY / Gold (Alpha/Beta/Sharpe/MaxDD) |
| whale_benchmark_prices | ✅ | Historical benchmark prices (BTC/SPY/Gold) |
| whale_explain | 💎 | AI-synthesized plain-English narrative of an address or transaction (LLM-backed) |
| whale_address_history | 💎 | Full address transaction history — Pro tier |
| whale_export_csv | 💎 | CSV export with backfill — Pro tier |

---

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:

| Report | Phases | Result |
|---|---|---|
| Production audit | 30 tools tested anonymously (audit 2026-05-03) | 24 PASS / 1 latency-WARN / 5 INFO / 0 FAIL · expanded to 45 tools since |
| Deep audit | A (doc-vs-reality) + B (chains) + C (inner-consistency) | 47 PASS / 0 FAIL |
| External cross-check | D (vs mempool.space + Etherscan + CoinGecko + alternative.me) + E (internal source freshness) | 23 PASS / 0 FAIL |

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

---

Pricing

| Tier | Price | Access |
|---|---|---|
| Free | 0 | Anonymous OAuth, 24 tools, 10 API calls/day |
| Trial 30d | 0 | Login required, full access for 30 days, no auto-renewal |
| Intelligence | 49 CHF/mo | Realtime dashboard, custom tickers, 100 lookups/day, 10K API/day, personal license |
| Pro | 149 CHF/mo | REST API 100k/mo, 60/min, 3 seats, business license, full address-history, MCP/Claude-native |
| Academic | 0 | Verified .edu / .ac. / .uni- domains, 12-month renewal, citation required |
| Enterprise | Custom | Unlimited seats, white-label possible — contact form |

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.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Swiss Whale Intelligence MCP

What it does

Install

Direct (recommended)

Via Smithery Gateway (alternative)

Tools (45)

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

Verification

Pricing

License

Links

About alpineflow-io

Install

More like this

Stripe

Defeatbeta Api

MetaTrader MCP Server

EVM MCP Server

Polygon.io MCP Server

AI看线 - A股技术分析与AI预测工具