@aiindigo/btcfi-mcp

@aiindigo/btcfi-mcp

MCP server for BTCFi API — Bitcoin + BTCFi data for AI agents via x402 micropayments.

27 tools for Bitcoin blockchain data, AI-powered intelligence, security analysis, Solv Protocol BTCFi data, ZK proofs, and real-time streams.

Quick Start

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "btcfi": {
      "command": "npx",
      "args": ["@aiindigo/btcfi-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "your-base-wallet-private-key",
        "PAYMENT_NETWORK": "base"
      }
    }
  }
}

Or with Solana (NLx402 — zero fees):

{
  "mcpServers": {
    "btcfi": {
      "command": "npx",
      "args": ["@aiindigo/btcfi-mcp"],
      "env": {
        "SVM_PRIVATE_KEY": "your-solana-private-key",
        "PAYMENT_NETWORK": "solana"
      }
    }
  }
}

Programmatic

npm install @aiindigo/btcfi-mcp

EVM_PRIVATE_KEY=0x... npx @aiindigo/btcfi-mcp

Tools

Tool	Description	Price
btcfi_get_fees	Current Bitcoin fee rates + USD estimates	$0.01
btcfi_get_mempool	Mempool summary + recent txs	$0.01
btcfi_get_address	Address balance + stats	$0.01
btcfi_get_utxos	Unspent transaction outputs	$0.01
btcfi_get_address_txs	Address transaction history	$0.01
btcfi_get_tx	Transaction details	$0.01
btcfi_get_tx_status	Transaction confirmation status	$0.01
btcfi_broadcast_tx	Broadcast signed transaction	$0.05
btcfi_get_block	Block by height or hash	$0.01
btcfi_get_latest_blocks	Recent blocks	$0.01
btcfi_consolidation_advice	UTXO consolidation advisor	$0.02
btcfi_fee_prediction	AI fee prediction (1h/6h/24h)	$0.02
btcfi_whale_alert	Large tx detection	$0.02
btcfi_address_risk	Address risk scoring	$0.02
btcfi_network_health	Network health dashboard	$0.02
btcfi_threat_analysis	YARA-pattern threat detection	$0.02
btcfi_staking_status	Staking tier check	free
btcfi_solv_reserves	SolvBTC supply + backing ratio	$0.02
btcfi_solv_yield	xSolvBTC APY + strategies	$0.02
btcfi_solv_liquidity	Cross-chain liquidity	$0.02
btcfi_solv_risk	Multi-factor risk assessment	$0.02
btcfi_zk_balance_proof	ZK proof: balance ≥ threshold	$0.03
btcfi_zk_age_proof	ZK proof: UTXO age ≥ N blocks	$0.03
btcfi_zk_membership	ZK proof: address in set	$0.03
btcfi_zk_verify	Verify any ZK proof	$0.01
btcfi_health	API health status	free
btcfi_api_index	Full API index	free

Environment Variables

Variable	Description	Required
BTCFI_API_URL	API base URL (default: https://btcfi.aiindigo.com)	No
EVM_PRIVATE_KEY	EVM private key for Base USDC payments	One of
SVM_PRIVATE_KEY	Solana private key for NLx402 payments	One of
PAYMENT_NETWORK	base or solana (default: base)	No

Payment Networks

• Base (Coinbase): ERC-3009 USDC settlement. Standard fees.
• Solana (NLx402): Nonce-locked, hash-bound. Zero facilitator fees via PCEF nonprofit.

Links

• API: https://btcfi.aiindigo.com
• OpenAPI: https://btcfi.aiindigo.com/openapi.json
• x402 Manifest: https://btcfi.aiindigo.com/.well-known/x402-manifest.json
• Builder: AI Indigo