Quickstart

satoshidata is a Bitcoin chain-intelligence API for AI agents. Point your MCP client at us, or call our HTTP endpoints directly. Get back wallet labels, transaction context, network state, risk signals, and more across 39 MCP tools and 87 HTTP endpoints.

Free during beta. No signup. No API key.

Try it right now (no install)

The fastest way to see what we return is to paste these calls directly into your terminal.

Wallet summary: Satoshi genesis address

curl https://satoshidata.ai/v1/wallets/1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa/summary

Expected response shape (truncated):

{
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "label": {
    "category": "service",
    "value": "Satoshi Nakamoto - Genesis Address"
  },
  "claim_type": "inference",
  "confidence": "inferred",
  "evidence_types": ["curated_iconic"],
  "label_count": 6,
  "unique_contributors": 1,
  "has_conflict": false,
  "short_explanation": "One public source associates this address with Satoshi Nakamoto - Genesis Address (service). Informational; verify independently.",
  "access": {
    "tier": "beta_free",
    "auth_mode": "beta_public"
  },
  "_meta": {
    "freshness": "2026-05-30T04:59:57.415558+00:00",
    "price_sats": 21,
    "warnings": []
  }
}

Live BTC + FX snapshot

curl https://satoshidata.ai/v1/price

Use this when you want a simple call that needs no address input.

Configure your MCP client

For ongoing use through Claude Desktop, Cursor, or any compatible client, use this endpoint.

MCP server URL: https://satoshidata.ai/mcp/
Transport: streamable-http
Auth: none (during beta)

Claude Desktop

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "satoshidata": {
      "url": "https://satoshidata.ai/mcp/",
      "transport": "streamable-http"
    }
  }
}

Restart Claude Desktop, then ask: Use satoshidata to look up wallet 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa.

Cursor

In Settings → MCP, add:

{
  "satoshidata": {
    "url": "https://satoshidata.ai/mcp/",
    "transport": "streamable-http"
  }
}

Then ask Cursor chat to use satoshidata for a wallet lookup.

Generic MCP client

If your client supports streamable HTTP transport, point it at https://satoshidata.ai/mcp/. During beta no auth header is required.

The client should auto-discover all tools through tools/list.

curl -X POST https://satoshidata.ai/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

What's free, what's coming

Beta posture

Everything is free during beta: no signup, no API key, no per-call charges. Be reasonable with rate limits and we stay out of your way.

Specialization

Bitcoin only. If you need multi-chain breadth, this is not the right API. If you need deep Bitcoin chain intelligence, this is the core product surface.

Pricing transparency

Some endpoints expose price_sats in _meta as the advertised post-beta x402 micropayment reference. During beta those calls remain free.

Next steps

OpenAPI spec → /openapi.json Live capabilities → /v1/capabilities MCP discovery manifest → /.well-known/mcp.json Agent index → /llms.txt Rendered API reference → /api/reference