# swiss-whale-intelligence

Real-time whale alerts, per-address MVRV (profit/loss state via UTXO-age × historical price), Meiklejohn-canonical clusters, mining-pool attribution (99.6% YTD coverage), exchange flows, dormant-wall…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add avk359/swiss-whale-intelligence

# Browse available tools
npx -y smithery tool list avk359/swiss-whale-intelligence

# Get full schema for a tool
npx -y smithery tool get avk359/swiss-whale-intelligence whale_lookup

# Call a tool
npx -y smithery tool call avk359/swiss-whale-intelligence whale_lookup '{}'
```

## Direct MCP Connection

Endpoint: `https://swiss-whale-intelligence.run.tools`

## Tools (30)

- `whale_lookup` — Look up a Bitcoin address's whale profile.
- `whale_recent` — List recent whale transactions matching the filter.
- `whale_tx_detail` — Get full detail for a single whale transaction.
- `whale_entity_search` — Search the entity-label catalog.
- `whale_cohort_breakdown` — Cohort breakdown of whale moves over the last N days.
- `whale_exchange_flows` — Daily exchange in/out flows over the last N days.
- `whale_hodl_wave` — HODL Wave UTXO age distribution from `whale_hodl_waves`.
- `whale_sopr` — Whale-specific SOPR (Spent Output Profit Ratio) time series.
- `whale_miner_balances` — Mining-pool BTC hot-wallet balances over time (15+ tracked pools).
- `whale_frequency_context` — How common is a whale-move of this size + flow this week?
- `whale_my_status` — Show your current MCP-server access tier, scopes, and rate limits.
- `whale_btc_price` — BTC price time series with optional whale-event overlay.
- `whale_top_coins` — Snapshot of 16 tracked non-stablecoin coins with price + 24h change.
- `whale_fear_greed` — Fear & Greed Index daily values from alternative.me.
- `whale_dominance` — BTC and ETH dominance (% of total market cap) time series.
- `whale_btc_indicators` — Current state of two macro Bitcoin top/cycle indicators.
- `whale_address_mvrv` — Per-address MVRV-style cost-basis breakdown.
- `whale_address_cluster` — Show all addresses controlled by the same entity (canonical Meiklejohn cluster).
- `whale_top_holders` — Top whale addresses by current BTC holdings (UTXO truth-source).
- `whale_dormant_wakeups` — Find whale addresses that became active after a real dormancy gap.
- `whale_eth_recent` — Recent Ethereum whale transactions.
- `whale_eth_cohort_breakdown` — ETH whale movements grouped by amount bucket × flow_type.
- `whale_eth_address_cluster` — ETH address → cluster_id with confidence-tier transparency.
- `whale_eth_cluster_members` — All addresses belonging to a given ETH cluster_id.
- `whale_eth_mvrv` — ETH MVRV-equivalent for a given address.
- `whale_address_history` — Full transaction history for a Bitcoin address (Premium-only).
- `whale_export_csv` — Bulk CSV export of whale data (Research-tier only).
- `whale_lookup_any` — Public-address lookup for any BTC address (Research-tier).
- `whale_benchmark_prices` — Daily-close prices for traditional benchmark assets.
- `whale_benchmark_compare` — Cumulative-return comparison: BTC vs S&P 500, Gold, 70/30 portfolio.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get avk359/swiss-whale-intelligence <tool-name>
```

## Resources

- `swiss-whale://docs/methodology` — Methodology reference describing the volume_index and clustering.
- `swiss-whale://docs/doctrine` — Editorial doctrine for AI quote-generation.
- `swiss-whale://ledger/latest` — Pointer to the latest 90-day Open Trading Ledger CSV.
- `swiss-whale://openapi` — Pointer to the OpenAPI 3.0.3 REST spec.
- `swiss-whale://help/glossary` — Glossary of every metric, label, and concept used by these tools.
- `swiss-whale://help/getting-started` — Quick-start guide for analysts using this MCP server.
- `swiss-whale://help/comparison` — How this MCP server differs from Glassnode, CryptoQuant, Arkham, Nansen.