Hosted MCP server · #128 most used on Smithery

satoshidata — Bitcoin entity intelligence

satoshidata/wallet-intelligence

A keyless Bitcoin chain-intelligence API built for autonomous agents. Resolve addresses to known entities, pull wallet evidence packs, and check sanctions / illicit-fund exposure over MCP, no account required. Includes risk_check for free keyless exposure evidence, wallet evidence packs, entity / label lookup, and the Risk Exposure Oracle v0 with explicit disclaimers. Evidence-first: no opaque risk score or verdict from risk_check; agents receive underlying signals so they can decide. Core public surface is free during beta; optional X-WR-API-Key unlocks premium endpoints.

Backend & APIs Agents & orchestration

Install ↓Smithery ↗Website ↗

Uses: 4.1k
Tools: 44
Runs: Hosted
Listed: 8mo ago

Get started

Add it to your agent

npx -y @smithery/cli@latest install satoshidata/wallet-intelligence --client claude

Swap --client claude for cursor, vscode, windsurf or another client. The CLI asks for any required settings.

claude mcp add --transport http satoshidata-bitcoin-entity-intel https://server.smithery.ai/satoshidata/wallet-intelligence/mcp

A hosted server: nothing to install. Run /mcp in Claude Code to sign in if it asks.

[mcp_servers.satoshidata-bitcoin-entity-intel]
url = "https://server.smithery.ai/satoshidata/wallet-intelligence/mcp"

Add to ~/.codex/config.toml.

{
  "mcpServers": {
    "satoshidata-bitcoin-entity-intel": {
      "url": "https://server.smithery.ai/satoshidata/wallet-intelligence/mcp"
    }
  }
}

Add to ~/.cursor/mcp.json.

{
  "servers": {
    "satoshidata-bitcoin-entity-intel": {
      "type": "http",
      "url": "https://server.smithery.ai/satoshidata/wallet-intelligence/mcp"
    }
  }
}

Add to .vscode/mcp.json.

gemini mcp add --transport http satoshidata-bitcoin-entity-intel https://server.smithery.ai/satoshidata/wallet-intelligence/mcp

Saved to .gemini/settings.json.

What it can do

44 tools

wallet_trust_safety1 paramReturn satoshidata.ai's free Bitcoin wallet trust and safety teaser for a single address, including the examined marker when no clear cat…

Return satoshidata.ai's free Bitcoin wallet trust and safety teaser for a single address, including the examined marker when no clear category matched.

Parameter	Type	Description
`address`	string

address_risk1 paramReturn factual address risk signals: entity label/category, source count, bounded behavioral flags, coarse risk_indicator, and an informa…

Return factual address risk signals: entity label/category, source count, bounded behavioral flags, coarse risk_indicator, and an informational-only disclaimer. This is not AML/KYT/compliance advice.

Parameter	Type	Description
`address`	string

batch_trust_safety1 paramLook up labels and trust-safety signals for multiple Bitcoin addresses in one call. Returns the REST batch trust-safety payload and forwa…

Look up labels and trust-safety signals for multiple Bitcoin addresses in one call. Returns the REST batch trust-safety payload and forwards X-WR-API-Key/Bearer auth when present.

Parameter	Type	Description
`addresses`	array	Bitcoin addresses to look up, in result order.

batch_summary1 paramReturn satoshidata.ai wallet/entity summaries for multiple Bitcoin addresses in one call. Forwards X-WR-API-Key/Bearer auth when present.

Parameter	Type	Description
`addresses`	array	Bitcoin addresses to summarize, in result order.

batch_risk_signals1 paramReturn factual label-derived risk indicators for multiple Bitcoin addresses in one call. Forwards X-WR-API-Key/Bearer auth when present.

Parameter	Type	Description
`addresses`	array	Bitcoin addresses to score, in result order.

risk_check1 paramReturn a free evidence + confidence BTC screening bundle for one address, not a recommendation; you decide whether to transact.

Parameter	Type	Description
`address`	string

risk_check_batch1 paramReturn free evidence + confidence BTC screening bundles for up to 100 addresses, not recommendations; you decide whether to transact.

Parameter	Type	Description
`addresses`	array	Bitcoin addresses to screen, in result order.

address_evidence_pack4 paramsReturn a free sectioned evidence report for one Bitcoin address. Packages labels, trust-safety, risk signals, optional risk_check, overvi…

Return a free sectioned evidence report for one Bitcoin address. Packages labels, trust-safety, risk signals, optional risk_check, overview, recent transactions, and optional flow graph with component statuses. Evidence only: no score, verdict, clearance, or compliance recommendation.

Parameter	Type	Description
`depth`	integer	Flow-graph depth when include_graph=true.
`address`	string	Bitcoin wallet address to report on.
`tx_limit`	integer	Recent transaction rows to include.
`include_graph`	boolean	Whether to include the bounded value-flow graph component.

batch_intelligence1 paramReturn satoshidata.ai address-intelligence cards for multiple Bitcoin addresses in one call. Forwards X-WR-API-Key/Bearer auth when present.

Parameter	Type	Description
`addresses`	array	Bitcoin addresses to enrich, in result order.

wallet_flow_graph8 paramsReturn a render-ready transaction-flow graph for a Bitcoin wallet address.

Parameter	Type	Description
`hops`	integer	Maximum graph hop depth.
`view`		Optional response view. Set `view=compact` for a smaller agent-oriented payload.
`since`		Only include transactions at or after this ISO timestamp.
`address`	string	Bitcoin wallet address to graph.
`min_btc`	number	Minimum BTC value for an edge candidate to appear. Default 0.1 BTC is a value-flow display filter; use min_btc=0 for ownership or attribution analysis.
`direction`	string	Transaction-flow direction to include: incoming, outgoing, or both.
`node_limit`	integer	Maximum graph nodes to return.
`include_labels`	boolean	Include label/entity context for graph nodes when available.

wallet_summary1 paramReturn the premium satoshidata.ai chain intelligence summary for a single Bitcoin address.

Parameter	Type	Description
`address`	string

wallet_detail1 paramReturn grouped satoshidata.ai label evidence and detail for a single Bitcoin address.

Parameter	Type	Description
`address`	string

wallet_contributors1 paramReturn satoshidata.ai contributor depth and category distribution for a single Bitcoin address.

Parameter	Type	Description
`address`	string

address_intelligence1 paramReturn the premium satoshidata.ai address-intelligence card for a single Bitcoin address, including current best label, live wallet activ…

Return the premium satoshidata.ai address-intelligence card for a single Bitcoin address, including current best label, live wallet activity, cohort hints, and scanner signals.

Parameter	Type	Description
`address`	string	Bitcoin wallet address to enrich.

bitcoin_priceReturn the current Bitcoin price snapshot and 24 hour change from satoshidata.ai.

onchain_statsReturn the current satoshidata.ai on-chain market and network snapshot.

network_intelligence1 paramReturn the combined Bitcoin network summary for agents: price, fees, mempool, blocks, and satoshidata.ai chain-intelligence context. Set …

Return the combined Bitcoin network summary for agents: price, fees, mempool, blocks, and satoshidata.ai chain-intelligence context. Set include_charts=true only when chart arrays are needed.

Parameter	Type	Description
`include_charts`	boolean

fees_recommendedReturn current recommended Bitcoin fee estimates from satoshidata.ai.

mempool_statsReturn the current Bitcoin mempool size, fee floor, and congestion summary.

mempool_stress2 paramsReturn the current mempool-stress index. Set include_components=true or history_hours=1-168 for the Premium component/history payload; fo…

Return the current mempool-stress index. Set include_components=true or history_hours=1-168 for the Premium component/history payload; forwards Wallet+ Bearer or x402 payment headers when present.

Parameter	Type	Description
`history_hours`
`include_components`	boolean

chain_awakenings8 paramsReturn dormant-coin awakening events over a bounded window. Supports filters for minimum dormancy age, minimum BTC value, window bounds, …

Return dormant-coin awakening events over a bounded window. Supports filters for minimum dormancy age, minimum BTC value, window bounds, and result limit; forwards Wallet+ Bearer or x402 payment headers when present.

Parameter	Type	Description
`limit`	integer	Maximum rows to return.
`since`		Window start as block height, ISO date/time, or relative Nd value. Defaults to last 24h.
`until`		Window end as block height, ISO date/time, or now. Defaults to now.
`cursor`		Integer pagination cursor returned by the previous page.
`format`	string	Response format.
`min_btc`	number	Minimum BTC value of the spent dormant UTXO.
`address_filter`		Comma-separated Bitcoin address watchlist filter.
`min_dormancy_days`	integer	Minimum untouched age of the spent UTXO.

mempool_tx1 paramInspect a single unconfirmed Bitcoin transaction currently in the mempool.

Parameter	Type	Description
`txid`	string

block_detail1 paramReturn Bitcoin block metadata, coinbase attribution, and a transaction sample for a height or block hash.

Parameter	Type	Description
`height_or_hash`	string

entity_list3 paramsReturn named Bitcoin entity rollups, optionally filtered by category. coverage_status indicates whether each rollup is full, substantial,…

Return named Bitcoin entity rollups, optionally filtered by category. coverage_status indicates whether each rollup is full, substantial, partial, or seed-only coverage; last_activity_at is label-DB activity, not last on-chain transaction time.

Parameter	Type	Description
`sort`	string	Entity rollup sort order.
`limit`	integer	Maximum entity rollups to return.
`category`		Optional entity category filter.

entity_lookup2 paramsReturn one named Bitcoin entity rollup and a bounded member-address sample. coverage_status indicates whether the rollup is full, substan…

Return one named Bitcoin entity rollup and a bounded member-address sample. coverage_status indicates whether the rollup is full, substantial, partial, or seed-only coverage; last_activity_at is label-DB activity, not last on-chain transaction time.

Parameter	Type	Description
`entity_name`	string
`member_limit`	integer

entity_recent_activity3 paramsReturn a bounded recent on-chain activity sample for a small named Bitcoin entity.

Parameter	Type	Description
`limit`	integer
`since`
`entity_name`	string

entity_categoriesReturn available Bitcoin entity rollup categories, counts, and coverage_status distributions.

whale_alerts5 paramsReturn recent large Bitcoin transfers with label-DB flow_type and flow_direction classification. range is one of 1d, 7d, or 30d; 24h is a…

Return recent large Bitcoin transfers with label-DB flow_type and flow_direction classification. range is one of 1d, 7d, or 30d; 24h is accepted by REST as a legacy alias for 1d. flow_direction is one of to_exchange, from_exchange, cross_exchange, or unknown.

Parameter	Type	Description
`limit`	integer	Maximum returned alerts. Capped at 1000.
`range`	string	Recent time window. `24h` is accepted as a legacy alias for `1d`.
`offset`	integer	Zero-based offset into descending-time alerts after range and min_btc filtering.
`min_btc`	number	Minimum BTC amount for a transfer to appear in the feed.
`flow_type`		Optional comma-separated flow filter.

pulse_whales3 paramsReturn recent large Bitcoin movements from satoshidata.ai's live on-chain Pulse feed.

Parameter	Type	Description
`limit`	integer
`since`
`min_btc`	number

pulse_dormant4 paramsReturn recent dormant-coin reactivations from satoshidata.ai's live on-chain Pulse feed.

Parameter	Type	Description
`limit`	integer
`since`
`min_btc`	number
`min_age_years`	number

pulse_consolidations4 paramsReturn recent consolidation candidates from satoshidata.ai's live on-chain Pulse feed.

Parameter	Type	Description
`limit`	integer
`since`
`min_btc`	number
`min_inputs`	integer

pulse_summaryReturn satoshidata.ai on-chain Pulse scanner health and 24-hour event totals.

dormancy_flushes3 paramsReturn recent CMCS dormancy awakenings classified as exchange-bound sell pressure, housekeeping consolidation, HODLer rotation, or unknown.

Parameter	Type	Description
`limit`	integer
`since`
`classification`

pool_listReturn the free satoshidata.ai mining-pool roster with recent block-share windows.

pool_detail1 paramReturn free satoshidata.ai mining-pool detail for a named pool.

Parameter	Type	Description
`pool_name`	string

mining_pool_info4 paramsReturn mining-pool attribution by block height/hash, known pool name, or candidate payout address. Block identifiers use /v1/blocks, pool…

Return mining-pool attribution by block height/hash, known pool name, or candidate payout address. Block identifiers use /v1/blocks, pool names use /v1/pools/{pool_name}, and addresses use wallet trust-safety.

Parameter	Type	Description
`address`
`pool_name`
`block_hash`
`block_height`

tx_status1 paramReturn a narrow Bitcoin transaction state check: unknown, mempool, conflicted, or confirmed.

Parameter	Type	Description
`txid`	string

op_return_decode1 paramDecode OP_RETURN protocol markers and ordinals inscription envelopes for a Bitcoin transaction.

Parameter	Type	Description
`txid`	string

tx_broadcast1 paramBroadcast a fully signed raw Bitcoin transaction hex through satoshidata.ai.

Parameter	Type	Description
`hex`	string

tx_verify4 paramsVerify that a Bitcoin transaction paid enough sats to the expected address with enough confirmations.

Parameter	Type	Description
`txid`	string
`min_amount_sats`	integer
`expected_address`	string
`min_confirmations`	integer

timestamp_hash1 paramSubmit a SHA-256 digest to satoshidata.ai's Bitcoin timestamping batch.

Parameter	Type	Description
`hash_hex`	string

timestamp_quoteReturn the current Bitcoin timestamping preflight quote, including the fixed service fee and estimated anchor-fee share.

verify_timestamp1 paramVerify a detached OpenTimestamps proof against the Bitcoin blockchain.

Parameter	Type	Description
`proof_base64`	string

submit_feedback12 paramsSubmit machine-readable label corrections, missing-label suggestions, data-quality reports, or general feedback.

Parameter	Type	Description
`asks`
`reason`
`address`
`message`
`summary`
`category`
`endpoint`
`severity`
`confidence`
`source_url`
`current_label`
`feedback_type`	string