About Satoshidata Wallet Intelligence
Satoshidata Wallet Intelligence is an MCP server for Bitcoin address investigations, intended for agents that need to assess recipients and verify transactions. It provides address labels, trust and safety scores, entity attribution, and timestamp verification, alongside free endpoints and paid per-call capabilities.
Key features
- 01Look up Bitcoin address labels and entities
- 02View trust and safety scores
- 03Verify transactions and payments
- 04Submit and verify timestamp proofs
- 05Check addresses in batches
Use cases
- 01Identify an address entity before sending Bitcoin
- 02Assess a wallet's trust and safety
- 03Verify a Bitcoin transaction or payment
- 04Investigate multiple wallet addresses in batches
MCP support
This remote MCP server provides clients with tools for Bitcoin wallet intelligence, transaction verification, timestamps, and batch lookups. The README also lists free and paid API endpoints.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://satoshidata.ai/mcp/claude mcp add --transport http satoshidata-examples https://satoshidata.ai/mcp/{"mcpServers":{"satoshidata-examples":{"type":"http","url":"https://satoshidata.ai/mcp/"}}}Open in Cursor{"servers":{"satoshidata-examples":{"type":"http","url":"https://satoshidata.ai/mcp/"}}}Open in VS Code{"mcpServers":{"satoshidata-examples":{"type":"http","url":"https://satoshidata.ai/mcp/"}}}{"mcpServers":{"satoshidata-examples":{"serverUrl":"https://satoshidata.ai/mcp/"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://satoshidata.ai/mcp/Auth requiredTools
44| Parameter | Type | Required | Description |
|---|---|---|---|
| address | string | Yes |
Details
From the project READMEsatoshidata.ai — Bitcoin Wallet Intelligence API
Other Bitcoin APIs tell you the fee rate. We tell you who you're sending to.
30M+ labeled Bitcoin addresses. Identify exchanges, mining pools, scams, gambling, government seizures — with confidence scoring on every response. No signup, no API key for free tier.
30-second demo
curl https://satoshidata.ai/v1/wallets/bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h/trust-safety
{
"address": "bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h",
"label": { "category": "exchange", "value": "Binance" },
"confidence": "verified",
"evidence_tier": "strong",
"assessment": {
"state": "labeled",
"headline": "Verified entity hit"
}
}
Add to your AI agent
Claude Code
claude mcp add satoshidata --url https://satoshidata.ai/mcp/
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"satoshidata": {
"url": "https://satoshidata.ai/mcp/"
}
}
}
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"satoshidata": {
"url": "https://satoshidata.ai/mcp/"
}
}
}
VS Code
Add to .vscode/mcp.json:
{
"servers": {
"satoshidata": {
"url": "https://satoshidata.ai/mcp/"
}
}
}
Then ask: "Who owns Bitcoin address bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h?"
Python examples
Investigate addresses (zero dependencies, free)
python python/investigate.py
Output:
Bitcoin Address Investigation
============================================================
bc1qm34lsc65...j77s3h
Entity: Binance (exchange)
Confidence: verified
1N52wHoVR79P...CdGquK
Entity: Bittrex (exchange)
Confidence: high
============================================================
Investigation complete. 0 sats spent.
Single address lookup
pip install requests
python python/lookup.py bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h
Batch check
python python/batch_check.py
Free endpoints (10)
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/wallets/{addr}/trust-safety | Wallet trust & safety profile |
| GET | /v1/price | BTC price snapshot |
| GET | /v1/onchain | On-chain activity |
| GET | /v1/fees/recommended | Fee recommendations |
| GET | /v1/mempool/stats | Mempool state |
| GET | /v1/tx/{txid}/status | Transaction status |
| GET | /v1/capabilities | All capabilities |
| GET | /v1/timestamp/{hash} | Timestamp status |
| GET | /v1/timestamp/quote | Timestamp quote |
| POST | /v1/timestamp/verify | Verify a proof |
Premium endpoints (21 sats / $0.01 per call)
Pay with Lightning L402 or x402 USDC on Base — per-call, no key needed. Or get a monthly API key for $4.99.
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/wallets/{addr}/summary | Full wallet intelligence |
| GET | /v1/wallets/{addr}/detail | Label evidence |
| GET | /v1/wallets/{addr}/contributors | Label contributors |
| POST | /v1/batch/trust-safety | Batch (up to 100) |
| POST | /v1/batch/summary | Batch summaries |
| GET | /v1/tx/{txid} | Full transaction |
| POST | /v1/tx/verify | Payment verification |
| POST | /v1/timestamp | Submit timestamp |
| GET | /v1/timestamp/{hash}/proof | Download proof |
Links
- API: satoshidata.ai
- MCP: satoshidata.ai/mcp/
- OpenAPI: satoshidata.ai/openapi.json
- Smithery: satoshidata/wallet-intelligence
- Substack: satoshiai.substack.com
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.