How do I install Btcfi Api?

Btcfi Api is a local plugin. Install it using npm package: @aiindigo/btcfi-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Btcfi Api need?

Btcfi Api requires the following credentials or environment variables: SVM_PRIVATE_KEY. You can find setup instructions on the server detail page.

What AI apps work with Btcfi Api?

Btcfi Api uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Btcfi Api MCP Server

by Aiindigo925

Developer ToolsModerate7.7MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

7.7

Moderate7.7Low Risk

Valid MCP server (3 strong, 5 medium validity signals). 3 known CVEs in dependencies (0 critical, 1 high severity) ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

9 files analyzed · 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Solana private key for x402 payments (optional, Base payments work without)Required

Environment variable: SVM_PRIVATE_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-aiindigo925-btcfi": {
      "env": {
        "SVM_PRIVATE_KEY": "your-svm-private-key-here"
      },
      "args": [
        "-y",
        "@aiindigo/btcfi-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

Endpoint	Description	Price
`GET /api/v1/fees`	Fee estimates (fastest, 30min, 1hr, economy) with USD values	$0.01
`GET /api/v1/mempool`	Mempool summary, tx count, size, fee histogram	$0.01
`GET /api/v1/address/{addr}`	Address balance, tx count, funded/spent stats	$0.01
`GET /api/v1/address/{addr}/utxos`	Unspent transaction outputs	$0.01
`GET /api/v1/address/{addr}/txs`	Transaction history	$0.01
`GET /api/v1/tx/{txid}`	Full transaction details	$0.01
`GET /api/v1/tx/{txid}/status`	Confirmation status	$0.01
`POST /api/v1/tx/broadcast`	Broadcast signed transaction	$0.05
`GET /api/v1/block/latest`	Latest blocks with details	$0.01
`GET /api/v1/block/{id}`	Block by height or hash	$0.01

Intelligence Endpoints

Endpoint	Description	Price
`GET /api/v1/intelligence/fees`	AI fee prediction (1h, 6h, 24h windows)	$0.02
`GET /api/v1/intelligence/whales`	Large transaction detection	$0.02
`GET /api/v1/intelligence/risk/{addr}`	Address risk scoring	$0.02
`GET /api/v1/intelligence/network`	Hashrate, difficulty, congestion	$0.02
`GET /api/v1/intelligence/consolidate/{addr}`	UTXO consolidation advice	$0.02
`GET /api/v1/intelligence/mvrv`	MVRV ratio	$0.02
`GET /api/v1/intelligence/sopr`	SOPR (Spent Output Profit Ratio)	$0.02
`GET /api/v1/intelligence/nupl`	NUPL (Net Unrealized Profit/Loss)	$0.02
`GET /api/v1/intelligence/hodl-waves`	HODL wave distribution	$0.02

Security Endpoints

Endpoint	Description	Price
`GET /api/v1/security/threat/{addr}`	YARA-pattern threat analysis (8 patterns)	$0.02

ZK Proof Endpoints

Endpoint	Description	Price
`POST /api/v1/zk/balance-proof`	Prove balance ≥ threshold	$0.03
`POST /api/v1/zk/age-proof`	Prove UTXO age ≥ N blocks	$0.03
`POST /api/v1/zk/membership`	Prove set membership	$0.03
`POST /api/v1/zk/verify`	Verify any ZK proof	$0.01

Solv Protocol Endpoints

Endpoint	Description	Price
`GET /api/v1/solv/reserves`	SolvBTC supply, backing ratio, TVL	$0.02
`GET /api/v1/solv/yield`	xSolvBTC APY, yield strategies	$0.02
`GET /api/v1/solv/liquidity`	Cross-chain SolvBTC distribution	$0.02
`GET /api/v1/solv/risk`	Multi-factor risk assessment	$0.02

Cross-Chain Endpoints

Ethereum ($0.01):

Endpoint	Description
`GET /api/v1/eth/gas`	ETH gas prices
`GET /api/v1/eth/address/{addr}`	ETH address balance
`GET /api/v1/eth/tx/{hash}`	ETH transaction details

Solana ($0.01):

Endpoint	Description
`GET /api/v1/sol/fees`	SOL priority fees
`GET /api/v1/sol/address/{addr}`	SOL address balance

Runes Endpoints

Endpoint	Description	Price
`GET /api/v1/runes`	List all Bitcoin Runes tokens	$0.02
`GET /api/v1/runes/trending`	Trending Runes by 24h activity	$0.02
`GET /api/v1/runes/{ticker}`	Runes token details	$0.02
`GET /api/v1/runes/{ticker}/holders`	Holder distribution	$0.02
`GET /api/v1/runes/{ticker}/transfers`	Recent transfers	$0.02

Taproot Assets Endpoints

Endpoint	Description	Price
`GET /api/v1/taproot/assets/{addr}`	Taproot Assets held by address	$0.02
`GET /api/v1/taproot/assets/{addr}/{assetId}`	Taproot Asset details	$0.02

Lightning Network Endpoints

Endpoint	Description	Price
`GET /api/v1/lightning/node/{pubkey}`	Lightning node info	$0.02
`GET /api/v1/lightning/channels/{chanId}`	Channel details	$0.02
`GET /api/v1/lightning/routing-fee`	Routing fee estimate	$0.02
`GET /api/v1/intelligence/lightning`	Lightning network intelligence	$0.02

Portfolio Endpoints

Endpoint	Description	Price
`GET /api/v1/portfolio`	List portfolios	$0.01
`GET /api/v1/portfolio/{userId}`	Get user portfolio	$0.01
`GET /api/v1/portfolio/{userId}/analytics`	Portfolio analytics	$0.02
`GET /api/v1/intelligence/portfolio/{addr}`	Address portfolio analysis	$0.02

Alerts Endpoints

Endpoint	Description	Price
`GET /api/v1/alerts`	List alert rules	Free
`GET /api/v1/alerts/rules`	Manage alert rules	Free
`DELETE /api/v1/alerts/rules/{id}`	Delete alert rule	Free
`GET /api/v1/alerts/history`	Alert trigger history	Free
`POST /api/v1/alerts/evaluate`	Evaluate alert conditions	Free

Price Endpoints

Endpoint	Description	Price
`GET /api/v1/price`	BTC price (CoinGecko: 38 fiat currencies)	Free

Real-Time Streams

Endpoint	Description	Price
`GET /api/v1/stream`	SSE: new blocks, fee changes, mempool surges	$0.01
`GET /api/v1/stream/whales`	SSE: whale transaction alerts (`?min=100` BTC)	$0.01

Agent Integration

Endpoint	Description	Price
`GET /api/mcp`	MCP server info and tools	Free
`GET /llms.txt`	AI agent discovery file	Free
`GET /api/v1/agent-skills`	Agent skill registry	Free

System Endpoints

Endpoint	Description	Price
`GET /api/health`	System health check	Free
`GET /api/v1/staking/status`	Staking tier and rate limit status	Free

Pricing

Category	Price (USDC)
Core Bitcoin (fees, mempool, address, tx, block)	$0.01
Intelligence (whales, risk, MVRV, SOPR, NUPL, HODL waves, cluster, graph)	$0.02
Security (threat analysis)	$0.02
Solv Protocol (reserves, yield, liquidity, risk)	$0.02
Runes (tokens, holders, transfers, trending)	$0.02
Taproot Assets (asset list, asset details)	$0.02
Lightning Network (nodes, channels, routing fees)	$0.02
Portfolio (addresses, analytics)	$0.01–$0.02
ZK Proofs (balance, age, membership)	$0.03
Transaction broadcast	$0.05
Ethereum / Solana	$0.01
Streams (SSE)	$0.01
Price (CoinGecko multi-currency)	Free
Alerts (rules, history, evaluate)	Free
System (health, status)	Free
Agent Discovery (/llms.txt, /api/mcp)	Free

Free Tier: 100 calls/day per IP, no signup required.

Authentication

BTCFi API uses x402 micropayments — no API keys, no OAuth, no subscriptions.

Free endpoints — No authentication. Just make a request.
Paid endpoints — Include an X-Payment header with a USDC micropayment proof.
Payment networks:
- Base (EVM L2) — Coinbase facilitator, zero fees, ERC-3009
- Solana — NLx402 by PCEF (nonprofit), zero fees

Request signing (optional, for higher rate limits):

Wallet-based signing with Ed25519 (Solana) or secp256k1 (EVM)
Headers: X-Signature, X-Nonce, X-Signer, X-Timestamp

Free for Humans

Completely free — no signup, no API keys, no secrets. This is a PUBLIC repository. Just open Telegram:

@BTC_Fi_Bot — 38 commands + inline mode: /start /help /price /whale /fear /hash /mempool /halving /etf /funding /dominance /mining /lightning /signal /l2 /block /mvrv /sopr /nupl /entity /portfolio /staking /threat /eth_addr /sol_addr /digest /alerts /watch /unwatch /watchlist /runes /ordinals /taproot /cluster /graph /batch /webhooks /premium
@BTCFi_Whales — Real-time whale transaction alerts, auto-posted every 15 min
Web Dashboard — Live BTC price, fees, mempool, address lookup, whale watch

Security

Wallet-based request signing (Ed25519 + secp256k1)
Encrypted responses (Curve25519 + XSalsa20-Poly1305)
Zero-knowledge proofs (Groth16)
8 YARA-style threat detection patterns
Nonce replay protection
PEAC Protocol cryptographic receipts
Tiered rate limiting (free: 100/min, signed: 500/min, paid: unlimited)

Report vulnerabilities: security@aiindigo.com

Self-Hosted

Run the API locally for development or private deployment:

git clone https://github.com/aiindigo925/btcfi-api.git
cd btcfi-api
npm install
cp .env.example .env    # Configure environment variables
npm run dev              # Start on port 3001

Required environment variables:

UPSTASH_REDIS_REST_URL — Redis connection for caching
UPSTASH_REDIS_REST_TOKEN — Redis auth token
X402_NETWORK — Payment network (base or solana)
X402_FACILITATOR_URL — x402 facilitator endpoint

Documentation

Doc	Description
docs/ROADMAP.md	Project history and future plans
docs/ARCHITECTURE.md	System design and endpoint reference
docs/SECURITY.md	Security model and features
docs/CHANGELOG.md	Version history

Packages & Distribution

Package	Description
`@aiindigo/btcfi`	TypeScript SDK — 28 methods
`@aiindigo/btcfi-mcp`	MCP Server — 45 tools for Claude, ChatGPT, Gemini
MCP Registry	`io.github.aiindigo925/btcfi`
Glama	Indexed — searchable MCP directory
@BTC_Fi_Bot	Telegram bot — 28 commands + inline mode

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

No token. No API keys. Just Bitcoin data. Ship > talk. 🚀

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Btcfi Api MCP Server

About

Security Report

Findings (4)Action required

Permissions Required

What You'll Need

How to Install

Documentation

BTCFi API

Free Tier

Quick Start

API Reference

Core Bitcoin Endpoints

Intelligence Endpoints

Security Endpoints

ZK Proof Endpoints

Solv Protocol Endpoints

Cross-Chain Endpoints

Runes Endpoints

Taproot Assets Endpoints

Lightning Network Endpoints

Portfolio Endpoints

Alerts Endpoints

Price Endpoints

Real-Time Streams

Agent Integration

System Endpoints

Pricing

Authentication

Free for Humans

Security

Self-Hosted

Documentation

Packages & Distribution

Contributing

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Toleno

mcp-creator-python

MarkItDown

FinAgent

mcp-creator-typescript