# Bitpoort

On-chain blockchain data for AI agents. 41 MCP tools for whale tracking, entity analysis, exchange flows, ML predictions, wallet profiling, direct Ethereum RPC, and cross-chain signals across Ethereu…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add bitpoort/on-chain-data

# Browse available tools
npx -y @smithery/cli@latest tool list bitpoort/on-chain-data

# Get full schema for a tool
npx -y @smithery/cli@latest tool get bitpoort/on-chain-data query_blocks

# Call a tool
npx -y @smithery/cli@latest tool call bitpoort/on-chain-data query_blocks '{}'
```

## Direct MCP Connection

Endpoint: `https://on-chain-data--bitpoort.run.tools`

## Tools (41)

- `query_blocks` — Get recent blocks for a specific blockchain. Returns block number, hash, timestamp, tx count, and gas used.
- `query_transactions` — Get transactions for a chain, optionally filtered by block number. Returns tx hash, from/to addresses, USD value, type,…
- `search_rag` — Semantic search over indexed blockchain data. Returns ranked results with text, topic, chain, and relevance score. Uses…
- `get_whale_activity` — Get recent whale (high-value) transactions. Returns structured array with tx_hash, from/to addresses and labels, value_…
- `get_intent_detections` — Get detected behavioral patterns (accumulation, distribution, arbitrage, rug signals, etc.). Includes confidence scores…
- `get_pipeline_status` — Get the current state of the 7-stage data pipeline (INGEST -> NORMALIZE -> ENRICH -> CHUNK -> EMBED -> INDEX -> STORE).…
- `get_chain_status` — Get processing status for a specific blockchain including block watermarks, lag, and errors per pipeline stage.
- `get_health` — Get the overall system health score (0-100) and status (HEALTHY/DEGRADED/IMPAIRED/CRITICAL) with per-stage breakdown.
- `inspect_block` — Get full detail for a specific block including all transactions, whale activity, and RAG chunks. Useful for deep invest…
- `get_logs` — Get recent system log entries, optionally filtered by level (INFO/WARNING/ERROR) and service (ingest/normalize/enrich/c…
- `get_alerts` — Get alert history including triggered rules, severity, and resolution status.
- `get_stats` — Get aggregate system statistics: total blocks, transactions, RAG chunks, whale transactions, active intents, DLQ entrie…
- `ask_blockchain` — Ask a natural language question about blockchain activity. Returns an array of relevant data chunks with text, topic, c…
- `get_network_summary` — Get a structured network summary: hourly stats (tx_count, volume, gas), whale activity (count, top movements), latest b…
- `get_entity_activity` — Get activity history for a named entity (e.g. 'Binance', 'Wintermute') or wallet address. Returns structured periods wi…
- `get_mev_leaderboard` — Get MEV bot leaderboard ranked by 7-day extracted value. Returns bot address, strategy (flash_loan_arb, lending_arb, de…
- `get_smart_wallets` — Get top wallets ranked by 7-day trading performance. Returns wallet address, composite score (0-100), win rate, total P…
- `get_trade_signals` — Get composite trade signals from cross-signal analysis. Returns structured signals array with token, direction (bullish…
- `get_predictions` — Get ML-based short-term price predictions for tracked tokens. Uses LightGBM trained on 30+ on-chain and technical featu…
- `get_conviction_signals` — Get conviction signals from cross-signal correlation. Combines 7 sources (swap pressure, smart money, exchange flow, to…
- `get_exchange_flows` — Get exchange inflow/outflow data. Returns aggregate net flow with direction, per-exchange breakdown (inflow/outflow/net…
- `get_token_flows` — Get tokens ranked by net buying or selling pressure. Returns sellers[] and buyers[] arrays with token, buy_usd, sell_us…
- `get_price_history` — Get recent price candles (OHLCV) and price change for a token. Returns candles[] array with OHLCV data and price_change…
- `get_risk_briefing` — Get a security-focused risk briefing. Returns structured arrays: risk_events (anomalies), intents (behavioral patterns …
- `get_alarm_feed` — Get the alarm feed with triggered on-chain events. Returns structured events array with alarm_type, severity, chain, ti…
- `get_alarm_categories` — List all available alarm categories with severity levels, supported chains, and default thresholds.
- `get_emerging_tokens` — Get emerging tokens ranked by momentum score. Returns tokens discovered on-chain with swap activity, unique traders, ho…
- `get_trending_tokens` — Get tokens ranked by swap volume over a time window. Returns symbol, volume, change percentage, swap count, unique wall…
- `get_wallet_profile` — Get complete wallet profile for an Ethereum address: label, classification, risk score, volume, transaction count, top …
- `get_intelligence_feed` — Unified event feed from 6 sources: whale transfers, intent detections, liquidation risks, profitable trades, MEV extrac…
- `get_hl_market` — Hyperliquid market state: smart money positioning (long/short %), aggressive flow direction, and funding rates with ope…
- `get_hl_traders` — Top Hyperliquid perpetual traders ranked by smart money score. Returns win rate, PnL, Sharpe ratio, profit factor, edge…
- `get_btc_flows` — Bitcoin whale flows with entity enrichment from 2.3M labeled addresses. Returns flow type, BTC/USD amount, from/to enti…
- `get_cross_chain_signals` — ETH on-chain to Hyperliquid perpetual correlation signals. Detects when ETH whale activity (accumulation, exchange with…
- `rpc_get_balance` — Get ETH balance of an Ethereum address. Returns balance in ETH and wei, with entity label if known. Use for checking wa…
- `rpc_get_block` — Get Ethereum block details: timestamp, gas usage, transaction count, base fee. Omit block_number for latest block. Set …
- `rpc_get_transaction` — Get full transaction details by hash: from/to with entity labels, value in ETH, gas cost, status (success/reverted), lo…
- `rpc_get_logs` — Get event logs emitted by a contract. Useful for tracking Transfer events, approvals, swaps, etc. Max 2000-block range.…
- `rpc_get_contract_info` — Check if an address is a smart contract, get its ETH balance, code size, and transaction count (nonce). Also returns en…
- `rpc_read_contract` — Read smart contract state by calling a view function. Supports common ERC-20 functions: name(), symbol(), decimals(), t…
- `rpc_trace_transaction` — Get internal call trace of a transaction: all internal calls, ETH transfers, contract interactions with entity labels. …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get bitpoort/on-chain-data <tool-name>
```
