Bitcoin MCP

49 ferramentas Bitcoin para agentes: taxas, mempool, blocos, mineração, preço e transações.

GitHub
5
Experimente este MCPPatrocinado

Documentação

bitcoin-mcp

Dê a qualquer agente de IA superpoderes do Bitcoin — inteligência de taxas, análise de mempool e 50 ferramentas apoiadas pelo seu nó Bitcoin ou API compatível.

PyPI Downloads Tests License: MIT Python 3.10+ GitHub Sponsors

50 ferramentas padrão · 6 prompts · 8 recursos · Backend Bitcoin Core ou API compatível · Licença MIT

Se o bitcoin-mcp for útil para você, considere dar uma estrela — isso ajuda outras pessoas a descobrirem o projeto.

pip install "bitcoin-mcp>=0.5.2"

O bitcoin-mcp precisa de um backend de dados do Bitcoin. Ele detecta automaticamente um nó local Bitcoin Core/Knots a partir do cookie ou das configurações de RPC. Sem um nó local, defina SATOSHI_API_URL para uma implantação compatível.

Status do serviço: a API pública Satoshi anteriormente hospedada em bitcoinsapi.com está pausada e não deve ser tratada como um padrão funcional. Use um nó local ou uma API compatível explicitamente configurada.

Status da instalação

A versão 0.5.2 inclui a restrição de compatibilidade do MCP SDK 1.x e a seleção explícita de backend. Atualize instalações mais antigas para receber essas correções.

Início rápido

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["--from", "bitcoin-mcp>=0.5.2", "bitcoin-mcp"]
    }
  }
}

Claude Code

claude mcp add bitcoin -- uvx --from "bitcoin-mcp>=0.5.2" bitcoin-mcp

Cursor

Adicione ao .cursor/mcp.json:

{
  "mcpServers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["--from", "bitcoin-mcp>=0.5.2", "bitcoin-mcp"]
    }
  }
}

VS Code

Adicione ao .vscode/mcp.json:

{
  "servers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["--from", "bitcoin-mcp>=0.5.2", "bitcoin-mcp"]
    }
  }
}

Zed

Adicione ao seu settings.json do Zed em context_servers:

{
  "context_servers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["--from", "bitcoin-mcp>=0.5.2", "bitcoin-mcp"]
    }
  }
}

Consulte a documentação do MCP do Zed para a localização atual das configurações e o fluxo de servidor personalizado.

Docker

docker build -t bitcoin-mcp .
docker run -i bitcoin-mcp

Ou com docker compose:

docker compose up

Passe variáveis de ambiente para conectar a um nó Bitcoin Core local ou a uma API compatível:

docker run -i -e BITCOIN_RPC_HOST=host.docker.internal -e BITCOIN_RPC_PORT=8332 bitcoin-mcp
# or
docker run -i -e SATOSHI_API_URL=https://your-api.example bitcoin-mcp

Pergunte se deve enviar Bitcoin agora

Use este como o primeiro caminho de ativação útil após a instalação:

"Preciso enviar uma transação de Bitcoin hoje. Use o bitcoin-mcp para decidir se devo enviar agora ou esperar, e mostre a taxa que você usou."

Caminho esperado:

  1. O agente chama get_fee_recommendation.
  2. A resposta dá uma recomendação clara de enviar agora ou esperar, com taxas em sat/vB.
  3. Se o backend não estiver disponível, configure um nó local ou defina SATOSHI_API_URL antes de tentar novamente.

Depois que funcionar, dê uma estrela neste repositório e compartilhe um breve exemplo com o prompt, a chamada de ferramenta e o resultado, para que outros construtores de agentes Bitcoin possam ver o caminho.

Integração com agentes

Para repositórios que precisam de ferramentas Bitcoin, adicione bitcoin-mcp à configuração MCP do agente e configure um dos backends suportados:

Exemplos HTTP gerados devem usar caminhos canônicos /api/v1 da API Satoshi.

Por que bitcoin-mcp?

  • Inteligência de taxas que economiza dinheiro real — saiba o momento mais barato para enviar, compare níveis de taxas, estime custos exatos antes de transmitir
  • Escolha de backend — use seu próprio nó Bitcoin Core/Knots ou uma API compatível explicitamente configurada
  • Ferramentas MCP de código aberto — definições de ferramentas, testes e exemplos de configuração de cliente estão disponíveis neste repositório

Principais casos de uso

Pergunte ao seu agente de IA:

PromptO que faz
"Qual é o momento mais barato para enviar Bitcoin hoje?"Recomendação de taxa com detalhamento de economia
"Analise a congestão atual do mempool"Profundidade do mempool em tempo real, níveis de taxas, contagem de transações pendentes
"Quanto eu economizaria esperando 6 blocos em vez do próximo bloco?"Comparação lado a lado de taxas entre alvos de confirmação
"Procure esta transação: abc123..."Decodificação completa da transação com detecção de inscrições
"Dê-me um resumo da situação do Bitcoin agora"Preço, taxas, mempool, mineração, dificuldade — em uma chamada

Referência completa de ferramentas

Todas as 50 ferramentas padrão por categoria

Inteligência de taxas

FerramentaDescrição
get_fee_recommendationTaxa ideal com níveis de urgência e dicas de economia
get_fee_estimatesEstimativas de taxas em todos os alvos de confirmação
estimate_smart_feeEstimativa de taxa para um alvo de confirmação específico
compare_fee_estimatesComparação lado a lado de fontes de taxas
estimate_transaction_costEstimativa de custo exata para uma transação antes de enviar

Blocos e transações

FerramentaDescrição
analyze_blockAnálise profunda de qualquer bloco por altura ou hash
get_block_statsDetalhamento estatístico de um bloco
get_block_countAltura atual da cadeia
compare_blocksCompare dois blocos lado a lado
search_blocksPesquise uma faixa de blocos
analyze_transactionAnálise completa de transação com detecção de inscrições
decode_raw_transactionDecodifique um hex de transação bruta
send_raw_transactionTransmita uma transação assinada
check_utxoVerifique se um UTXO está gasto ou não gasto

Mempool

FerramentaDescrição
analyze_mempoolAnálise completa do mempool — profundidade, taxas, congestão
get_mempool_infoTamanho do mempool, bytes, piso de taxas
get_mempool_entryDetalhes de uma transação não confirmada específica
get_mempool_ancestorsCadeia ancestral de uma transação no mempool

Mineração

FerramentaDescrição
get_mining_infoDificuldade de mineração atual, hashrate, recompensa de bloco
analyze_next_blockPrévia do próximo modelo de bloco
get_mining_pool_rankingsPrincipais pools de mineração por blocos recentes
get_difficulty_adjustmentTempo e porcentagem da próxima mudança de dificuldade
get_halving_countdownBlocos e tempo estimado até o próximo halving

Rede e status

FerramentaDescrição
get_blockchain_infoEstado da cadeia, progresso da verificação, status de softfork
get_network_infoVersão do nó, conexões, informações de relay
get_node_statusStatus da conexão e saúde do nó
get_peer_infoDetalhes dos pares conectados
get_chain_tipsPontas da cadeia ativas e obsoletas
get_chain_tx_statsTaxa de transferência de transações em N blocos
get_utxo_set_infoTamanho do conjunto UTXO e oferta total
get_supply_infoOferta circulante, taxa de inflação, porcentagem minerada
get_situation_summaryVisão geral agregada — preço, taxas, mempool, mineração
get_btc_pricePreço atual BTC/USD
get_market_sentimentÍndice de medo/ganância e indicadores de mercado

Endereço e UTXO

FerramentaDescrição
get_address_utxosUTXOs de um endereço
validate_addressValide e classifique um endereço Bitcoin

Endereço indexado (requer indexador de blockchain)

FerramentaDescrição
get_address_balanceTotal recebido/enviado/saldo, contagem de transações, primeira/última vez vista
get_address_historyHistórico de transações paginado com mudança líquida de valor
get_address_transactionsHistórico de transações com detalhes de valor por transação
get_indexed_transactionTransação enriquecida com endereços de entrada resolvidos + status de gasto
get_indexer_statusProgresso da sincronização, ETA, blocos/segundo

Segurança

FerramentaDescrição
analyze_psbt_securityAnálise de segurança de uma transação Bitcoin parcialmente assinada
explain_inscription_listing_securityGuia de segurança para listagens de inscrições ordinais

Utilidade

FerramentaDescrição
search_blockchainPesquisa universal — endereço, txid, hash de bloco ou altura
generate_keypairGere um novo par de chaves Bitcoin
explain_scriptDecodifique e explique um script Bitcoin
decode_bolt11_invoiceDecodifique uma fatura BOLT11 da Lightning Network
describe_rpc_commandTexto de ajuda para qualquer comando RPC do Bitcoin Core
list_rpc_commandsListe todos os comandos RPC disponíveis
decode_xpubDecodifique e inspecione uma chave pública estendida

Ferramenta opcional de API remota

query_remote_api é registrada somente quando SATOSHI_API_URL está definido e o extra l402 está instalado. Ela consulta rotas canônicas /api/v1 nesse endpoint explicitamente configurado.

Configuração

Configure um nó local Bitcoin Core/Knots ou uma API remota compatível. Se nenhum estiver disponível, o bitcoin-mcp sai da verificação de conexão com um erro de configuração em vez de selecionar silenciosamente um serviço público indisponível.

Flags de CLI

bitcoin-mcp suporta as seguintes flags em tempo de execução:

FlagValoresPadrãoDescrição
--transportstdio, sse, streamable-httpstdioTransporte MCP a executar
--hosthostname / IP127.0.0.1 para transportes HTTPHost de ligação para sse e streamable-http
--portinteiro8000 para transportes HTTPPorta de ligação para sse e streamable-http
--log-levelDEBUG, INFO, WARNING, ERRORINFOVerbosidade do log do servidor

Exemplo:

bitcoin-mcp --transport sse --host 127.0.0.1 --port 8000 --log-level DEBUG
VariávelDescriçãoPadrão
BITCOIN_RPC_HOSTHost RPC do Bitcoin Core127.0.0.1
BITCOIN_RPC_PORTPorta RPC do Bitcoin CoreAutomático por rede
BITCOIN_NETWORKmainnet, testnet, signet ou regtestmainnet
SATOSHI_API_URLURL base da API Satoshi compatívelNenhum
SATOSHI_API_KEYChave de API para acesso autenticadoNenhum

Para conectar a um nó Bitcoin Core local:

{
  "mcpServers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["--from", "bitcoin-mcp>=0.5.2", "bitcoin-mcp"],
      "env": {
        "BITCOIN_RPC_HOST": "127.0.0.1",
        "BITCOIN_RPC_PORT": "8332"
      }
    }
  }
}

Prompts e recursos

6 prompts integrados para fluxos de trabalho comuns: analyze_fee_environment, investigate_transaction, monitor_mempool_fees, taproot_adoption_report, network_health_report, track_transaction

8 recursos para injeção de contexto: bitcoin://connection/status, bitcoin://node/status, bitcoin://fees/current, bitcoin://fees/history, bitcoin://mempool/snapshot, bitcoin://protocol/script-opcodes, bitcoin://protocol/address-types, bitcoin://protocol/sighash-types

Links

Exemplos

Consulte a pasta examples/ para padrões de uso documentados:

Apoie este projeto

O bitcoin-mcp é uma infraestrutura Bitcoin gratuita e de código aberto. Apoie o desenvolvimento por meio do GitHub Sponsors, relatórios de problemas reproduzíveis, melhorias na documentação e patches testados.

Contribuindo

Contribuições são bem-vindas. Consulte CONTRIBUTING.md para diretrizes, incluindo como adicionar novas ferramentas e a lista de verificação de PR.

Por favor, relate vulnerabilidades de segurança de forma privada — consulte SECURITY.md.

Sobre

O bitcoin-mcp é criado e mantido por Andrew Barnes, conectando agentes de IA e infraestrutura Bitcoin por meio do Model Context Protocol.

Projetos relacionados:

  • Satoshi API — API de inteligência de taxas Bitcoin, 108 endpoints, utilizável como backend compatível auto-hospedado
  • ChainPulse — CLI de inteligência de rede Bitcoin com IA
  • BAIP-1 — Protocolo de Identidade de Agentes Bitcoin
  • bitcoin-fee-observatory — Painel de análise do mercado de taxas

Licença

MIT