Каталог MCP
Bortlesboat/bitcoin-mcp

Bortlesboat/bitcoin-mcp

Name: Bortlesboat/bitcoin-mcp
Availability: InStock
Author: bortlesboat

MCP-сервер для AI-агентов: анализ биткоин-комиссий, mempool и 49 инструментов без конфигурации. Нулевая настройка — идеально для разработчиков и трейдеров, автоматизирующих Bitcoin-операции.

Github PyPi Сайт сервера

README

50 инструментов

Версии

Установить сервер

bitcoin-mcp

Give any AI agent Bitcoin superpowers — fee intelligence, mempool analysis, and 50 tools backed by your Bitcoin node or compatible API.

50 standard tools · 6 prompts · 8 resources · Bitcoin Core or compatible API backend · MIT licensed

If bitcoin-mcp is useful to you, consider giving it a star — it helps others discover the project.

pip install "bitcoin-mcp>=0.5.2"

bitcoin-mcp needs a Bitcoin data backend. It auto-detects a local Bitcoin Core/Knots node from its cookie or RPC settings. Without a local node, set SATOSHI_API_URL to a compatible deployment.

Service status: the public Satoshi API previously hosted at bitcoinsapi.com is paused and should not be treated as a working default. Use a local node or an explicitly configured compatible API.

Install status

Version 0.5.2 includes the MCP SDK 1.x compatibility constraint and explicit backend selection. Upgrade older installations to receive these fixes.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

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

Инструменты были проиндексированы: 15.10.2026

analyze_block

Анализирует блок: майнинг-пул, внедрение SegWit/Taproot, распределение комиссий, доход. Аргументы: height_or_hash: Высота блока (например "939290") или хеш блока

Параметры

height_or_hashstringобязательный

analyze_mempool

Анализирует mempool: количество транзакций, группы комиссий, уровень загруженности, минимальную комиссию для следующего блока.

Параметры

Без параметров.

analyze_next_block

Предсказывает следующий блок: транзакции, использование веса, доход майнера, процентили комиссии, транзакции с наибольшей комиссией.

Параметры

Без параметров.

analyze_psbt_security

Анализирует PSBT на наличие уязвимости mempool sniping в листингах ординалов. Обнаруживает, уязвим ли PSBT листинга ординалов к опережению в mempool. Листинг считается УЯЗВИМЫМ, когда используется SIGHASH_SINGLE|ANYONECANPAY без блокировки в мультисиге 2-из-2 — злоумышленник может перенаправить инскрипцию до подтверждения. Листинг считается ЗАЩИЩЁННЫМ, когда инскрипция зафиксирована в мультисиге 2-из-2 P2WSH, а маркетплейс подписывается SIGHASH_ALL, что предотвращает любые модификации транзакции. Узел Bitcoin не требуется — анализ ведётся чисто по разбору PSBT (BIP 174). Аргументы: psbt_hex: строка PSBT в hex-кодировке (BIP 174 v0)

Параметры

psbt_hexstringобязательный

analyze_transaction

Декодирует и анализирует транзакцию: входы, выходы, ставку комиссии, флаги SegWit/Taproot, обнаружение инскрипций. Аргументы: txid: Хеш транзакции (64 шестнадцатеричных символа). Локальным узлам требуется txindex=1 для подтверждённых транзакций; размещённый API обрабатывает это автоматически.

Параметры

txidstringобязательный

check_utxo

Проверяет, не израсходован ли конкретный выход транзакции (UTXO lookup). Аргументы: txid: Хэш транзакции vout: Индекс выхода

Параметры

txidstringобязательный
voutintegerобязательный

compare_blocks

Сравнивает статистику блоков на двух высотах блоков рядом. Аргументы: height1: Высота первого блока height2: Высота второго блока

Параметры

height1integerобязательный
height2integerобязательный

compare_fee_estimates

Сравнивает оценки комиссий бок о бок с пометками срочности и стоимостью для типичной транзакции объемом 140 vB.

Параметры

Без параметров.

decode_bolt11_invoice

Декодирует счет BOLT11 Lightning без внешних зависимостей. Разбирает человекочитаемую часть и извлекает сеть, сумму и метку времени. НЕ проверяет подпись и не разбирает тегированные поля, кроме базового извлечения. Аргументы: invoice: строка платежного запроса BOLT11 (начинается с lnbc, lntb или lnbcrt)

Параметры

invoicestringобязательный

decode_raw_transaction

Декодирует сырой hex транзакции без поиска входов. Аргументы: hex_string: Сырая транзакция в hex-формате

Параметры

hex_stringstringобязательный

decode_xpub

Выводит адреса и метаданные из расширенного открытого ключа.

Параметры

accountinteger
derive_countinteger
xpubstringобязательный

describe_rpc_command

Получает структурированную справку для команды Bitcoin RPC: описание, аргументы, примеры. Аргументы: command: имя команды RPC (например, "getblock", "sendrawtransaction")

Параметры

commandstringобязательный

estimate_smart_fee

Получает оценку комиссии для заданного целевого времени подтверждения. Аргументы: conf_target: количество блоков для подтверждения (1-1008)

Параметры

conf_targetintegerобязательный

estimate_transaction_cost

Оценивает стоимость транзакции Bitcoin в сатоши И долларах США при разных уровнях срочности. Поддерживает типы адресов: p2pkh (legacy), p2sh-p2wpkh (nested segwit), p2wpkh (native segwit), p2tr (taproot). Показывает, сколько вы экономите при ожидании.

Параметры

address_typestring
input_countinteger
output_countinteger

explain_inscription_listing_security

Объясняет простым языком, защищена ли от перехвата листинг надписей Ordinals. Анализирует PSBT и возвращает понятное текстовое описание: - Можно ли перехватить листинг в mempool (front-running) - Какой тип sighash использует каждый вход и почему это важно - Конкретные шаги по устранению уязвимости, если листинг уязвим Используйте этот инструмент, когда нужно понятное объяснение для разработчика или оператора маркетплейса, а не необработанные аналитические данные. Args: psbt_hex: PSBT-строка в шестнадцатеричном формате (BIP 174 v0)

Параметры

psbt_hexstringобязательный

explain_script

Декодирует шестнадцатеричную строку Bitcoin Script и разбирает opcodes. Аргументы: hex_script: скрипт в шестнадцатеричном формате

Параметры

hex_scriptstringобязательный

generate_keypair

Генерирует новый биткоин-адрес через кошелёк подключённого узла. Требуется локальный узел с загруженным кошельком — недоступно при использовании хостингового Satoshi API. БЕЗОПАСНОСТЬ: Закрытые ключи по умолчанию скрываются, так как ответы инструментов AI-провайдера могут логироваться. Устанавливайте include_private_key=True только если понимаете риск — ключ появится в вашей истории переписки и должен считаться потенциально скомпрометированным для использования с высокими ценностями. Аргументы: address_type: Тип адреса — "legacy" (P2PKH), "p2sh-segwit" (P2SH-P2WPKH), "bech32" (P2WPKH, по умолчанию) или "bech32m" (P2TR taproot) include_private_key: Если True, включает WIF-закрытый ключ в ответ. По умолчанию False для безопасности.

Параметры

address_typestring
include_private_keyboolean

get_address_balance

Получает общий баланс, количество транзакций и время первого/последнего появления для Bitcoin-адреса. Использует индекс блокчейна Satoshi API, если он доступен, иначе обращается к mempool.space. Возвращает общее полученное, общее отправленное, текущий баланс, количество транзакций и временные метки. Аргументы: address: Bitcoin-адрес (любой формат: legacy, P2SH, bech32, bech32m)

Параметры

addressstringобязательный

get_address_history

Получает историю транзакций Bitcoin-адреса с постраничной разбивкой. Использует индексатор блокчейна Satoshi API, если он доступен, в противном случае переключается на mempool.space. Показывает каждую транзакцию с указанием высоты блока, временной метки и изменения чистого баланса для данного адреса. Результаты упорядочены от новых к старым. Аргументы: address: Bitcoin-адрес (в любом формате) offset: Пропустить указанное количество транзакций (для пагинации, по умолчанию 0) limit: Максимальное количество возвращаемых транзакций (по умолчанию 25, максимум 100)

Параметры

addressstringобязательный
limitinteger
offsetinteger

get_address_transactions

Получает постраничную историю транзакций для Bitcoin-адреса с деталями суммы по каждой транзакции.

Параметры

addressstringобязательный
limitinteger
offsetinteger

get_address_utxos

Сканирует набор UTXO для поиска всех неизрасходованных выходов, принадлежащих адресу. Примечание: сканирует полный набор UTXO, может занять несколько минут. Аргументы: address: Bitcoin-адрес для сканирования

Параметры

addressstringобязательный

get_blockchain_info

Получает информацию о блокчейне: chain, difficulty, softfork statuses, chain work, pruning.

Параметры

Без параметров.

get_block_count

Получает текущую высоту блока (легковесный, быстрый).

Параметры

Без параметров.

get_block_stats

Получает необработанную статистику блока: медианная комиссия, общий вывод, субсидия, вес, количество транзакций. Аргументы: height: Высота блока

Параметры

heightintegerобязательный

get_btc_price

Получает текущую цену BTC/USD из CoinGecko (бесплатно, без API-ключа). Возвращает цену, изменение за 24 часа и рыночную капитализацию. Используйте это для конвертации комиссий в sat/vB в долларовые суммы.

Параметры

Без параметров.

get_chain_tips

Получает верхушки цепочек: активная цепочка, форки и устаревшие ветки. Полезно для обнаружения разделения цепочек.

Параметры

Без параметров.

get_chain_tx_stats

Получает статистику скорости транзакций за N блоков. Аргументы: nblocks: Количество блоков для усреднения (по умолчанию 2016 = ~2 недели)

Параметры

nblocksinteger

get_difficulty_adjustment

Вычисляет прогресс корректировки сложности: блоков в эпоху, оставшихся блоков, расчётное время и прогнозируемую корректировку.

Параметры

Без параметров.

get_fee_estimates

Получает оценки ставки комиссии для целей подтверждения блоков 1/3/6/25/144 в сат/вБ.

Параметры

Без параметров.

get_fee_recommendation

Получает рекомендацию по стоимости на простом английском языке на основе текущих оценок, вместе с сырыми данными о ставках.

Параметры

Без параметров.

get_halving_countdown

Получает точный обратный отсчёт до следующего халвинга Биткоина: оставшиеся блоки, предполагаемая дата и изменение субсидии.

Параметры

Без параметров.

get_indexed_transaction

Получает обогащённые детали транзакции из индексатора блокчейна. В отличие от analyze_transaction (которая использует raw RPC), этот возвращает разрешённые адреса входов, статус потрачен/не потрачен для каждого выхода и контекст блока. Переключается на mempool.space, когда индексатор недоступен. Аргументы: txid: идентификатор транзакции (64-символьная шестнадцатеричная строка)

Параметры

txidstringобязательный

get_indexer_status

Проверяет прогресс синхронизации индексатора блокчейна. Возвращает текущую проиндексированную высоту, вершину цепочки, процент синхронизации, блоков/с и ETA. Используйте это, чтобы проверить, работает ли индексатор и насколько продвинулась начальная синхронизация.

Параметры

Без параметров.

get_market_sentiment

Получает Bitcoin Fear & Greed Index: текущее значение (0-100), классификацию (Экстремальный Страх/Страх/Нейтрально/Жадность/Экстремальная Жадность) и 7-дневную историю. Используйте его для оценки настроений рынка вместе с данными о ценах.

Параметры

Без параметров.

get_mempool_ancestors

Получает все неподтверждённые транзакции-предки мемпульной транзакции. Полезен для анализа CPFP. Аргументы: txid: Хэш транзакции (64 шестнадцатеричных символа)

Параметры

txidstringобязательный

get_mempool_entry

Получает сведения о конкретной неподтверждённой транзакции в мемпуле. Args: txid: Хеш транзакции (64 шестнадцатеричных символа)

Параметры

txidstringобязательный

get_mempool_info

Получает краткую статистику mempool: количество транзакций, размер в байтах, минимальная комиссия ретрансляции.

Параметры

Без параметров.

get_mining_info

Получает информацию о майнинге: сложность, хешрейт сети, текущий размер блока.

Параметры

Без параметров.

get_mining_pool_rankings

Получает топ-10 майнинговых пулов Bitcoin по доле хешрейта за последнюю неделю. Возвращает название пула, процент от общего хешрейта и количество блоков. Используйте это, чтобы понять централизацию майнинга и доминирование пулов.

Параметры

Без параметров.

get_network_info

Получает информацию о сети: версию протокола, комиссию за ретрансляцию, подключения, предупреждения. В режиме хостинга API отражает представление сети сервера API.

Параметры

Без параметров.

get_node_status

Получает статус сети Bitcoin: цепочку, высоту, прогресс синхронизации, использование диска, соединения, версию. В хостинговом режиме API отражает узел сервера API.

Параметры

Без параметров.

get_peer_info

Получает детали подключенного пира: адреса, задержку, сервисы, версию. В режиме хостингового API показывает пиры API-сервера.

Параметры

Без параметров.

get_situation_summary

Получает краткую сводку по Bitcoin: цена, комиссии, мемпул и верхушка цепи за один вызов. Используйте это как первый вызов, чтобы понять текущие условия - заменяет вызов 5+ инструментов по отдельности.

Параметры

Без параметров.

get_supply_info

Получает данные о предложении Биткоина: циркулирующее предложение, максимальное предложение, уровень инфляции, субсидия на блок и оценка следующего халвинга.

Параметры

Без параметров.

get_utxo_set_info

Получает статистику набора UTXO: общее количество UTXO, общее предложение, размер на диске. Примечание: это медленная операция (1-2 минуты на локальных узлах, может отличаться на хостинговом API).

Параметры

Без параметров.

list_rpc_commands

Выведи список всех доступных RPC-команд, сгруппированных по категориям.

Параметры

Без параметров.

search_blockchain

Smart search: автоматически определяет, является ли запрос txid, block hash, block height или address, и возвращает правильные данные. Args: query: txid (64 hex), block hash (64 hex, начинающийся с 0000), block height (число) или Bitcoin address

Параметры

querystringобязательный

search_blocks

Получает статистику блоков для диапазона высот. Максимум 10 блоков. Args: start_height: Начальная высота блока (включительно) end_height: Конечная высота блока (включительно)

Параметры

end_heightintegerобязательный
start_heightintegerобязательный

send_raw_transaction

Отправляет подписанную сырую транзакцию в сеть Bitcoin. ПРЕДУПРЕЖДЕНИЕ: это отправляет НАСТОЯЩУЮ транзакцию. После отправки отменить её невозможно. Убедитесь, что транзакция правильно подписана и вы понимаете последствия по комиссии. В режиме хостинга API транзакция отправляется через узел Satoshi API. Аргументы: hex_string: подписанная сырая транзакция в hex-формате max_fee_rate: максимальная ставка комиссии в BTC/kvB, предотвращающая случайную переплату (по умолчанию 0.10)

Параметры

hex_stringstringобязательный
max_fee_ratenumber

validate_address

Проверяет Bitcoin-адрес и возвращает его тип (legacy/segwit/taproot), сеть и информацию о скрипте. Используйте этот инструмент, чтобы проверить, действителен ли адрес перед отправкой, или чтобы определить, какой это адрес. Args: address: Bitcoin-адрес для проверки (любой формат: P2PKH, P2SH, P2WPKH, P2WSH, P2TR)

Параметры

addressstringобязательный

`0.5.2`основная	07.09.2026
`0.5.1`	16.03.2026
`0.5.0`	15.03.2026
`0.4.2`	09.03.2026
`0.4.1`	09.03.2026
`0.4.0`	09.03.2026
`0.3.0`	08.03.2026
`0.2.2`	07.03.2026
`0.2.1`	07.03.2026

Выберите клиент, чтобы установить Bortlesboat/bitcoin-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "bortlesboat-bitcoin-mcp-2axtl1gyra": {
      "command": "uvx",
      "args": [
        "bitcoin-mcp"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "bortlesboat-bitcoin-mcp-2axtl1gyra": {
      "command": "uvx",
      "args": [
        "bitcoin-mcp"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "bortlesboat-bitcoin-mcp-2axtl1gyra": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "bitcoin-mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"bortlesboat-bitcoin-mcp-2axtl1gyra\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"bitcoin-mcp\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "bortlesboat-bitcoin-mcp-2axtl1gyra": {
      "command": "uvx",
      "args": [
        "bitcoin-mcp"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add bortlesboat-bitcoin-mcp-2axtl1gyra -- uvx bitcoin-mcp

Либо через JSON-конфиг:

claude mcp add-json bortlesboat-bitcoin-mcp-2axtl1gyra "{\"command\":\"uvx\",\"args\":[\"bitcoin-mcp\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add bortlesboat-bitcoin-mcp-2axtl1gyra -- uvx bitcoin-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.bortlesboat-bitcoin-mcp-2axtl1gyra]
command = "uvx"
args = ["bitcoin-mcp"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите Bortlesboat/bitcoin-mcp, а в поле команды запуска — строку ниже:

uvx bitcoin-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "bortlesboat-bitcoin-mcp-2axtl1gyra": {
      "command": "uvx",
      "args": [
        "bitcoin-mcp"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "bortlesboat-bitcoin-mcp-2axtl1gyra": {
      "command": "uvx",
      "args": [
        "bitcoin-mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например bortlesboat-bitcoin-mcp-2axtl1gyra.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: bortlesboat-bitcoin-mcp-2axtl1gyra
    command: uvx
    args:
      - "bitcoin-mcp"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "bortlesboat-bitcoin-mcp-2axtl1gyra": {
      "command": "uvx",
      "args": [
        "bitcoin-mcp"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "bitcoin-mcp"
  ]
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 4
Форков на Github: 5
Загрузок: 2 797
Язык реализации: Python
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.10 в 11:24
Идентификатор: MnL0PH5vcMPmzzbt
Категории: Блокчейн, Финансы

Bortlesboat/bitcoin-mcp

bitcoin-mcp

Install status

Quick Start

Claude Desktop

Похожие MCP-сервера

bolivian-peru/baozi-mcp

kukapay/pancakeswap-poolspy-mcp

debridge-finance/debridge-mcp

Hovsteder/powersun-tron-mcp

aaronjmars/web3-research-mcp

IndigoProtocol/indigo-mcp