API

Bitcoin metrics for AI agents

Connect Claude, GPT, or any MCP-compatible AI to 154+ Bitcoin on-chain and market metrics via the Model Context Protocol.

154 metrics
13 categories
7 tools
Streamable HTTP

Available Tools

Seven tools that let AI agents discover, query, and compare any Bitcoin metric.

list_metrics

Browse all available metrics by category. 13 categories covering price, on-chain, mining, derivatives, and more.

search_metrics

Search metrics by keyword across names, descriptions, slugs, and field names.

get_metric

Retrieve time-series data for any metric. Supports date ranges, pagination, and last-N queries.

get_latest

Get the most recent value for up to 10 metrics at once. Perfect for quick lookups.

compare_metrics

Compare up to 5 metrics side-by-side, aligned by date over a common range.

get_market_overview

Instant Bitcoin market snapshot: price, market cap, MVRV, NUPL, hashrate, and technicals.

subscribe

Self-subscribe for higher rate limits via Lightning Network payment.

Metric Categories

154 metrics organized into 13 categories:

market on-chain supply mining exchange holders addresses derivatives macro altcoins stocks valuation coin-days-destroyed

Use list_metrics with a category to explore, or search_metrics with any keyword.

1 Connect from Claude Desktop

Add the MCP server to your Claude Desktop configuration file:

Remote (Streamable HTTP)
Local (stdio)
// Claude Desktop → Settings → Developer → Edit Config
// File: %APPDATA%\Claude\claude_desktop_config.json (Windows)
//       ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "bgapi": {
      "type": "streamable-http",
      "url": "https://bitcoin-data.com/mcp"
    }
  }
}
// Run the MCP server locally via npx

{
  "mcpServers": {
    "bgapi": {
      "command": "npx",
      "args": ["@bgeometrics/mcp-server"],
      "env": {
        "BGAPI_TOKEN": "your-token-here"
      }
    }
  }
}

Restart Claude Desktop after saving. You should see the tools icon in the chat input area.

2 Connect from Claude Code

Add the server to your Claude Code settings:

// .claude/settings.json

{
  "mcpServers": {
    "bgapi": {
      "type": "streamable-http",
      "url": "https://bitcoin-data.com/mcp"
    }
  }
}

Restart Claude Code to load the MCP server.

3 Connect from any MCP client

The server supports the Streamable HTTP transport. Any MCP-compatible client can connect:

# Endpoint
POST https://bitcoin-data.com/mcp
    
# Initialize a session and call get latest
SESSION_ID=$(curl -s -i -X POST https://bitcoin-data.com/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}' \
    | grep -i "mcp-session-id" | tr -d '\r' | awk '{print $2}')

echo "Session: $SESSION_ID"

curl -s -X POST https://bitcoin-data.com/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -H "mcp-session-id: $SESSION_ID" \
    -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_latest","arguments":{"metrics":["btc-price","mvrv","nupl"]}},"id":2}'

Rate Limits

The API applies rate limits based on your authentication tier:

TierRequests / hourRequests / dayCost
Free815Free
Advance2005,000Lightning payment

No subscription is required. The subscribe tool to upgrade your tier directly from the AI chat via Lightning Network.

Example Prompts

Once connected, ask your AI assistant questions like: