satoshidata — Bitcoin entity intelligence
A keyless Bitcoin chain-intelligence API built for autonomous agents.
What it can do
- 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.
- 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/compl
- 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.
What data it sees
Do you need an account
No: the server works without sign-in
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.
How to connect
How to connect satoshidata — Bitcoin entity intelligence to Claude
The server address to paste into Claude settings:
https://wallet-intelligence--satoshidata.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect satoshidata — Bitcoin entity intelligence to ChatGPT
The server address to paste into ChatGPT settings:
https://wallet-intelligence--satoshidata.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect satoshidata — Bitcoin entity intelligence to Cursor
The server address to paste into Cursor settings:
https://wallet-intelligence--satoshidata.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (44)
Raw names from tools/list. Only developers need these.
| 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. |
| 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. |
| 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. |
| batch_summary | Return satoshidata.ai wallet/entity summaries for multiple Bitcoin addresses in one call. Forwards X-WR-API-Key/Bearer auth when present. |
| 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. |
| risk_check | Return a free evidence + confidence BTC screening bundle for one address, not a recommendation; you decide whether to transact. |
| risk_check_batch | Return free evidence + confidence BTC screening bundles for up to 100 addresses, not recommendations; you decide whether to transact. |
| 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. |
| batch_intelligence | Return satoshidata.ai address-intelligence cards for multiple Bitcoin addresses in one call. Forwards X-WR-API-Key/Bearer auth when present. |
| wallet_flow_graph | Return a render-ready transaction-flow graph for a Bitcoin wallet address. |
| wallet_summary | Return the premium satoshidata.ai chain intelligence summary for a single Bitcoin address. |
| wallet_detail | Return grouped satoshidata.ai label evidence and detail for a single Bitcoin address. |
| wallet_contributors | Return satoshidata.ai contributor depth and category distribution for a single Bitcoin address. |
| 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. |
| 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. |
| 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. |
| fees_recommended | Return current recommended Bitcoin fee estimates from satoshidata.ai. |
| mempool_stats | Return the current Bitcoin mempool size, fee floor, and congestion summary. |
| 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. |
| 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. |
| mempool_tx | Inspect a single unconfirmed Bitcoin transaction currently in the mempool. |
| block_detail | Return Bitcoin block metadata, coinbase attribution, and a transaction sample for a height or block hash. |
| 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. |
| 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. |
| entity_recent_activity | Return a bounded recent on-chain activity sample for a small named Bitcoin entity. |
| entity_categories | Return available Bitcoin entity rollup categories, counts, and coverage_status distributions. |
| 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. |
| pulse_whales | Return recent large Bitcoin movements from satoshidata.ai's live on-chain Pulse feed. |
| pulse_dormant | Return recent dormant-coin reactivations from satoshidata.ai's live on-chain Pulse feed. |
| pulse_consolidations | Return recent consolidation candidates from satoshidata.ai's live on-chain Pulse feed. |
| pulse_summary | Return satoshidata.ai on-chain Pulse scanner health and 24-hour event totals. |
| dormancy_flushes | Return recent CMCS dormancy awakenings classified as exchange-bound sell pressure, housekeeping consolidation, HODLer rotation, or unknown. |
| pool_list | Return the free satoshidata.ai mining-pool roster with recent block-share windows. |
| pool_detail | Return free satoshidata.ai mining-pool detail for a named pool. |
| 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. |
| tx_status | Return a narrow Bitcoin transaction state check: unknown, mempool, conflicted, or confirmed. |
| op_return_decode | Decode OP_RETURN protocol markers and ordinals inscription envelopes for a Bitcoin transaction. |
| tx_broadcast | Broadcast a fully signed raw Bitcoin transaction hex through satoshidata.ai. |
| 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 satoshidata.ai'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. |