# Wallet Intelligence

Bitcoin wallet intelligence API. Identify any Bitcoin address — entity, category, confidence scoring. Millions of labeled wallets covering exchanges, mining pools, scams, gambling, marketplaces, mixe…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add satoshidata/wallet-intelligence

# Browse available tools
npx -y @smithery/cli@latest tool list satoshidata/wallet-intelligence

# Get full schema for a tool
npx -y @smithery/cli@latest tool get satoshidata/wallet-intelligence wallet_trust_safety

# Call a tool
npx -y @smithery/cli@latest tool call satoshidata/wallet-intelligence wallet_trust_safety '{}'
```

## Direct MCP Connection

Endpoint: `https://wallet-intelligence--satoshidata.run.tools`

**Optional config:**
- `x-wr-api-key` (header) — Optional satoshidata.ai Agent API Bridge Pass key. Get one at https://satoshidata.ai/pay. Free tools work without a key.

## Tools (14)

- `wallet_trust_safety` — Return White Rabbit's free Bitcoin wallet trust and safety teaser for a single address.
- `wallet_summary` — Return the premium White Rabbit wallet intelligence summary for a single Bitcoin address.
- `wallet_detail` — Return grouped White Rabbit label evidence and detail for a single Bitcoin address.
- `wallet_contributors` — Return White Rabbit contributor depth and category distribution for a single Bitcoin address.
- `bitcoin_price` — Return the current Bitcoin price snapshot and 24 hour change from satoshidata.ai.
- `onchain_stats` — Return the current satoshidata.ai on-chain market and network snapshot.
- `fees_recommended` — Return current recommended Bitcoin fee estimates from satoshidata.ai.
- `mempool_stats` — Return the current Bitcoin mempool size, fee floor, and congestion summary.
- `tx_status` — Return a narrow Bitcoin transaction state check: unknown, mempool, conflicted, or confirmed.
- `tx_verify` — Verify that a Bitcoin transaction paid enough sats to the expected address with enough confirmations.
- `timestamp_hash` — Submit a SHA-256 digest to White Rabbit's Bitcoin timestamping batch.
- `timestamp_quote` — Return the current Bitcoin timestamping preflight quote, including the fixed service fee and estimated anchor-fee share.
- `verify_timestamp` — Verify a detached OpenTimestamps proof against the Bitcoin blockchain.
- `submit_feedback` — Submit machine-readable label corrections, missing-label suggestions, data-quality reports, or general feedback.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get satoshidata/wallet-intelligence <tool-name>
```