satoshidata — Bitcoin entity intelligence

Official44 tools

by satoshidata

Bitcoin entity and risk-exposure evidence for AI agents; keyless MCP, no risk_check score/verdict.

Provide Bitcoin entity identification and risk exposure evidence for AI agents.

Captured live from the server via tools/list.

wallet_trust_safety

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

Parameters (1)

addressstringrequired

address_risk

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.

Parameters (1)

addressstringrequired

batch_trust_safety

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.

Parameters (1)

addressesarrayrequired
Bitcoin addresses to look up, in result order.

batch_summary

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

Parameters (1)

addressesarrayrequired
Bitcoin addresses to summarize, in result order.

batch_risk_signals

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

Parameters (1)

addressesarrayrequired
Bitcoin addresses to score, in result order.

risk_check

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

Parameters (1)

addressstringrequired

risk_check_batch

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

Parameters (1)

addressesarrayrequired
Bitcoin addresses to screen, in result order.

address_evidence_pack

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.

Parameters (4)

addressstringrequired
Bitcoin wallet address to report on.
depthinteger
Flow-graph depth when include_graph=true.
tx_limitinteger
Recent transaction rows to include.
include_graphboolean
Whether to include the bounded value-flow graph component.

batch_intelligence

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

Parameters (1)

addressesarrayrequired
Bitcoin addresses to enrich, in result order.

wallet_flow_graph

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

Parameters (8)

addressstringrequired
Bitcoin wallet address to graph.
hopsinteger
Maximum graph hop depth.
directionstring
Transaction-flow direction to include: incoming, outgoing, or both.
min_btcnumber
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.
sinceany
Only include transactions at or after this ISO timestamp.
include_labelsboolean
Include label/entity context for graph nodes when available.
node_limitinteger
Maximum graph nodes to return.
viewany
Optional response view. Set `view=compact` for a smaller agent-oriented payload.

wallet_summary

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

Parameters (1)

addressstringrequired

wallet_detail

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

Parameters (1)

addressstringrequired

wallet_contributors

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

Parameters (1)

addressstringrequired

address_intelligence

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.

Parameters (1)

addressstringrequired
Bitcoin wallet address to enrich.

bitcoin_price

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

No parameters.

onchain_stats

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

No parameters.

network_intelligence

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.

Parameters (1)

include_chartsboolean

fees_recommended

Return current recommended Bitcoin fee estimates from satoshidata.ai.

No parameters.

mempool_stats

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

No parameters.

mempool_stress

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.

Parameters (2)

include_componentsboolean
history_hoursany

chain_awakenings

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.

Parameters (8)

min_dormancy_daysinteger
Minimum untouched age of the spent UTXO.
min_btcnumber
Minimum BTC value of the spent dormant UTXO.
sinceany
Window start as block height, ISO date/time, or relative Nd value. Defaults to last 24h.
untilany
Window end as block height, ISO date/time, or now. Defaults to now.
address_filterany
Comma-separated Bitcoin address watchlist filter.
cursorany
Integer pagination cursor returned by the previous page.
formatstring
Response format.
limitinteger
Maximum rows to return.

mempool_tx

Inspect a single unconfirmed Bitcoin transaction currently in the mempool.

Parameters (1)

txidstringrequired

block_detail

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

Parameters (1)

height_or_hashstringrequired

entity_list

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.

Parameters (3)

categoryany
Optional entity category filter.
limitinteger
Maximum entity rollups to return.
sortstring
Entity rollup sort order.

entity_lookup

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.

Parameters (2)

entity_namestringrequired
member_limitinteger

entity_recent_activity

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

Parameters (3)

entity_namestringrequired
limitinteger
sinceany

entity_categories

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

No parameters.

whale_alerts

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.

Parameters (5)

min_btcnumber
Minimum BTC amount for a transfer to appear in the feed.
rangestring
Recent time window. `24h` is accepted as a legacy alias for `1d`.
flow_typeany
Optional comma-separated flow filter.
limitinteger
Maximum returned alerts. Capped at 1000.
offsetinteger
Zero-based offset into descending-time alerts after range and min_btc filtering.

pulse_whales

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

Parameters (3)

limitinteger
min_btcnumber
sinceany

pulse_dormant

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

Parameters (4)

limitinteger
min_age_yearsnumber
min_btcnumber
sinceany

pulse_consolidations

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

Parameters (4)

limitinteger
min_inputsinteger
min_btcnumber
sinceany

pulse_summary

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

No parameters.

dormancy_flushes

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

Parameters (3)

limitinteger
sinceany
classificationany

pool_list

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

No parameters.

pool_detail

Return free satoshidata.ai mining-pool detail for a named pool.

Parameters (1)

pool_namestringrequired

mining_pool_info

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.

Parameters (4)

block_heightany
block_hashany
pool_nameany
addressany

tx_status

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

Parameters (1)

txidstringrequired

op_return_decode

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

Parameters (1)

txidstringrequired

tx_broadcast

Broadcast a fully signed raw Bitcoin transaction hex through satoshidata.ai.

Parameters (1)

hexstringrequired

tx_verify

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

Parameters (4)

txidstringrequired
expected_addressstringrequired
min_amount_satsintegerrequired
min_confirmationsintegerrequired

timestamp_hash

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

Parameters (1)

hash_hexstringrequired

timestamp_quote

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

No parameters.

verify_timestamp

Verify a detached OpenTimestamps proof against the Bitcoin blockchain.

Parameters (1)

proof_base64stringrequired

submit_feedback

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

Parameters (14)

feedback_typestringrequired
addressany
current_labelany
suggested_labelany
suggested_categoryany
reasonany
confidenceany
source_urlany
summaryany
messageany
endpointany
severityany
categoryany
asksany

Install

Tools (44)

wallet_trust_safetyaddress_riskbatch_trust_safetybatch_summarybatch_risk_signalsrisk_checkrisk_check_batchaddress_evidence_pack

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://satoshidata.ai/mcp/v1/

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "wallet-intelligence": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://satoshidata.ai/mcp/v1/"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.