BTCFi API MCP server

by aiindigo925·io.github.aiindigo925/btcfi·v3.0.1

No reviews yet

Bitcoin data for AI agents. 27 tools with x402 micropayments. No API keys needed.

B80/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B80/100

full report

Adoption

Growing

0 stars32 downloads/wk

Reviews

Write one

Nobody has reviewed BTCFi API yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

BTCFi API tools (27)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

btcfi_address_risk
Risk score for a Bitcoin address based on transaction patterns, age, and known entity analysis.
btcfi_api_index
Get full BTCFi API index with all endpoints, pricing, security features, and x402 status.
btcfi_broadcast_tx
Broadcast a signed Bitcoin transaction to the network.
btcfi_consolidation_advice
Get UTXO consolidation advice for a Bitcoin address. Analyzes dust UTXOs and optimal consolidation timing.
btcfi_fee_prediction
AI-powered fee prediction for 1h, 6h, and 24h windows.
btcfi_get_address
Get Bitcoin address info including balance, tx count, and funded/spent stats.
btcfi_get_address_txs
Get transaction history for a Bitcoin address.
btcfi_get_block
Get a Bitcoin block by height or hash.
btcfi_get_fees
Get current Bitcoin fee rates with USD estimates. Returns fastest, medium, slow fee recommendations.
btcfi_get_latest_blocks
Get the most recent Bitcoin blocks.
btcfi_get_mempool
Get Bitcoin mempool summary including tx count, total size, fee histogram, and recent transactions.
btcfi_get_tx
Get full details of a Bitcoin transaction.
btcfi_get_tx_status
Get confirmation status of a Bitcoin transaction.
btcfi_get_utxos
Get unspent transaction outputs (UTXOs) for a Bitcoin address.
btcfi_health
Check BTCFi API health status including upstream services and RPC status.
btcfi_network_health
Bitcoin network health dashboard: hashrate trends, mempool congestion, difficulty adjustments.
btcfi_solv_liquidity
Cross-chain SolvBTC liquidity distribution. Filter by chain.
btcfi_solv_reserves
SolvBTC total supply across chains (Ethereum, BNB, Arbitrum) with backing ratio and TVL.
btcfi_solv_risk
Multi-factor risk assessment for Solv Protocol: reserve backing, chain diversification, concentration, smart contract security, TVL health.
btcfi_solv_yield
xSolvBTC yield data: current APY, yield strategies, and comparisons with other BTC yield products.
btcfi_staking_status
Check staking tier status for a wallet address.
btcfi_threat_analysis
YARA-pattern threat analysis for a Bitcoin address. Detects mixer usage, darknet patterns, ransomware signatures.
btcfi_whale_alert
Detect large Bitcoin transactions and whale movements in recent blocks and mempool.
btcfi_zk_age_proof
Generate ZK UTXO age proof \u2014 prove address has UTXOs older than N blocks without revealing which.
btcfi_zk_balance_proof
Generate ZK balance range proof \u2014 prove address balance >= threshold without revealing exact balance.
btcfi_zk_membership
Generate ZK set membership proof \u2014 prove address belongs to a trusted set without revealing which address.
btcfi_zk_verify
Verify any BTCFi ZK proof without regeneration. Agent B verifies proof created by Agent A.

Public scan report

scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it

no findings

Code scan4 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 3 days ago15/15
Maintainer identityregistry namespace matches repository owner6/10

Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How BTCFi API compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 80/100; higher than 60% of 48,255 servers
Tools: 27; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 32; more than 20% of 12,191 servers with a package

What its tools let an agent do: 27 read

Install BTCFi API in Claude Code, Cursor or VS Code

Runs npx -y @aiindigo/btcfi-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add btcfi -- npx -y @aiindigo/btcfi-mcp

Add to Cursor

What the publisher says

From the BTCFi API repository's README, as published. We do not edit it. Read it on GitHub

BTCFi API

Bitcoin Intelligence API for AI Agents

Live at btcfi.aiindigo.com · Built by AI Indigo · GitHub

BTCFi API is an agent-native Bitcoin intelligence platform providing 80+ endpoints across Bitcoin, Ethereum, Solana, Lightning Network, Runes, and Taproot Assets. Powered by x402 micropayments — pay $0.01–$0.05 per query in USDC, no API keys or subscriptions required. CoinGecko integration provides multi-currency pricing (38 fiat currencies). AI agents discover endpoints at /llms.txt and integrate via MCP, SDK, or raw HTTP.

Free Tier

100 calls/day per IP — no signup, no API keys, just make a request:

curl https://btcfi.aiindigo.com/api/v1/fees

{
  "fastest": 12,
  "30min": 8,
  "1hr": 5,
  "economy": 3,
  "fastestUSD": "$2.40",
  "recommended": "8 sat/vB"
}

Quick Start

AI Agents (MCP):

npx @aiindigo/btcfi-mcp

SDK:

npm install @aiindigo/btcfi

import { BTCFi } from "@aiindigo/btcfi";

const btcfi = new BTCFi({ network: "base" });
const fees = await btcfi.fees();
const risk = await btcfi.intelligence.risk("bc1q...");

Raw HTTP:

# Free endpoint — no auth needed
curl https://btcfi.aiindigo.com/api/v1/mempool

# Paid endpoint — requires x402 micropayment
curl -X GET https://btcfi.aiindigo.com/api/v1/intelligence/whales \
  -H "X-Payment: <x402-payment-proof>"

OpenAPI Spec:

https://btcfi.aiindigo.com/openapi.json

API Reference

Core Bitcoin Endpoints

Intelligence Endpoints

Security Endpoints

ZK Proof Endpoints

Solv Protocol Endpoints

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

BTCFi API: common questions

Is BTCFi API MCP server safe?: Mostly: it is graded B (80/100). Read the BTCFi API safety report
How do I install BTCFi API?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does BTCFi API need an API key?: Yes. The registry entry asks for SVM_PRIVATE_KEY.
Is BTCFi API maintained?: The last commit was 40 days ago (2026-09-25). The latest release is v3.0.1.
How does BTCFi API compare with other MCP servers?: safety score 80/100 (higher than 60% of 48,255 servers); tools 27 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.