home / mcp / btcfi mcp server

BTCFi MCP Server

Provides 31 Bitcoin data endpoints via MCP micropayments for AI agents, without keys or subscriptions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aiindigo925-btcfi-api": {
      "command": "npx",
      "args": [
        "@aiindigo/btcfi-mcp"
      ]
    }
  }
}

You can access Bitcoin data and intelligence through an MCP server that lets AI agents query 31 endpoints using lightweight micropayments. This setup enables fast, permissionless access to Bitcoin data without API keys or subscriptions, supporting practical use in AI workflows and automated decision making.

How to use

To run the MCP server for Bitcoin data, start the MCP client that connects to the BTCFi MCP server. You will then query endpoints such as fees, mempool status, address data, UTXOs, transactions, blocks, risk scores, whale alerts, and network health. All interactions are paid via the x402 USDC micropayments model, with no keys required and no signup.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Install the MCP client and run the BTCFi MCP server client as shown.

# Start the BTCFi MCP client for AI agents
npx @aiindigo/btcfi-mcp
```

```
# For developers who want the SDK (optional for client interactions)
npm install @aiindigo/btcfi

Additional content and notes

Key capabilities include core data access (fees, mempool, address data, UTXOs, transactions, blocks), intelligence features (fee predictions, whale alerts, risk scoring, network health), security analyses (YARA-style threat detection), Solv Protocol data (reserves, yield, liquidity, risk), ZK proofs (balance ranges, UTXO age, set membership), real-time streams (live blocks, whale transactions), and system status checks. You can interact with humans or agents via supported clients and rely on the built-in security model to protect requests and responses.

Security and payments

Payments are processed through a dual-network x402 micropayments system in USDC. No API keys or sign-up are required; you pay per query and receive the data in return. Core security features include wallet-based request signing, encrypted responses, zero-knowledge proofs, nonce replay protection, and cryptographic receipts.

Available tools

fees

Fetch current network and protocol fees used for pricing and transaction prioritization.

mempool

Access the current mempool to understand pending transactions and congestion.

address

Retrieve data associated with a Bitcoin address, including balances and activity.

utxos

Query unspent transaction outputs for an address or script.

transactions

Get details about specific transactions, including inputs, outputs, and confirmations.

blocks

Access block information, including height, hash, time, and transactions.

risk

Assess risk related to addresses or transactions based on intelligence signals.

whale

Receive whale activity alerts and high-value transaction insights.

network

Obtain health and status information about the Bitcoin network.

solv_reserves

Query SolvBTC reserves and related liquidity metrics.

solv_yield

Access yield data related to Solv Protocol integrations.

solv_liquidity

Inspect liquidity metrics and risk within the Solv ecosystem.

solv_risk

Evaluate risk exposure within Solv Protocol integrations.

balance_range

Obtain ZK-based balance range proofs for addresses.

utxo_age

Check age ranges for UTXOs to assess spendability timing.

set_membership

Verify set membership for private sets without revealing membership data.

blocks_stream

Real-time streaming of new blocks and related events.

whale_stream

Real-time whale transaction events with alerts.

health

System health and index status checks.

index

Status of data indices used for fast querying.

staking_status

Status information on staking-related data (where applicable).