botwallet-co/mcp

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

Проверяет ваш live on-chain USDC баланс, бюджет на расходы, сумму, потраченную за этот период, и оставшийся лимит. Также указывает, если баланс низкий, и предоставляет URL для пополнения. Для метаданных кошелька (статус, владелец, дата создания, информация о претензиях) используйте botwallet_info.

Отменяет ожидающий платежный запрос. Только ожидающие paylinks можно отменить - оплаченные или просроченные paylinks нельзя.

Отменяет платёж, который ещё не отправлен: предварительно одобренный, ожидающий одобрения владельца или одобренный. Платёж, который уже отправляется (статус "pending"), отменить нельзя.

Проверка перед оплатой. Возвращает два отдельных ответа: (1) can_afford - хватает ли вам баланса? (2) will_auto_approve - пройдёт ли платёж без одобрения владельца? Ещё показывает комиссию, итоговую стоимость и ваш баланс после оплаты. can_afford равен null, когда проверка останавливается, не дойдя до баланса: получатель не найден (recipient_found: false) или не может принимать платежи (recipient_can_receive: false), либо ограничения владельца блокируют этот платёж (blocked: true, с причиной и owner_message). Не просите у владельца средства, если только can_afford не равен false. Комиссии: минимум $0.01 или 1% от суммы транзакции, что больше, плюс разовый сбор $0.25 за настройку аккаунта, если на адресе получателя никогда не было USDC. Всегда вызывайте этот инструмент перед botwallet_pay, если не уверены в своём балансе.

Завершает платёж, ранее одобренный владельцем. Вызывайте этот инструмент после того, как владелец одобрит платёж через botwallet_events или по ссылке одобрения. Выполняет пороговую подпись FROST для авторизации транзакции в блокчейне, предварительно проверив, что она выплачивает согласованную сумму плюс не более указанной комиссии. Сумму и получателя сверяют с тем, что запрашивал агент, только если этот MCP-сервер сам запустил платёж и с тех пор не перезапускался; в остальных случаях - с тем, что записал Botwallet, при этом комиссия всё равно ограничена. Ошибка с кодом OUTCOME_UNKNOWN означает, что платёж мог пройти: прежде чем делать что-то ещё, проверьте инструмент, который указан в его check_tool (обычно botwallet_list_payments с transaction_id). Результат с status: "pending" и sent: true означает, что платёж отправлен, а Solana его ещё не подтвердила: не платите повторно; проверьте check_tool примерно через минуту.

Завершает вывод средств, который был ранее одобрен владельцем. Выполняет пороговую подпись FROST для авторизации транзакции в блокчейне, после проверки, что она отправляет одобренную сумму на одобренный адрес плюс не более указанной комиссии. Сумма и адрес сверяются с тем, что запросил агент, только если этот MCP-сервер инициировал вывод и с тех пор не перезапускался; иначе сверяются с теми, что записал Botwallet, при этом комиссия по-прежнему ограничена. Ошибка с кодом OUTCOME_UNKNOWN означает, что вывод мог пройти: проверьте инструмент, который указан в его check_tool (обычно botwallet_get_withdrawal), прежде чем делать что-либо ещё. Результат с status: "pending" и sent: true означает, что вывод был отправлен, и Solana ещё не подтвердила его: не запрашивайте его снова; проверьте check_tool примерно через минуту.

Создаёт платёжный запрос (ссылку для оплаты), который может оплатить любой пользователь. Возвращает URL для оплаты и короткий код, который можно отправить через botwallet_send_paylink или передать другим способом. Поддерживает детализированные счета через массив items — если переданы позиции, общая сумма рассчитывается автоматически. Необходимо передать amount, items или оба параметра.

Получает уведомления кошелька, сначала самые новые. По умолчанию возвращаются только непрочитанные события, по 10 за раз (максимум 25). Полезные типы: approval_resolved (владелец одобрил или отклонил платёж либо вывод средств), approval_required, deposit_received, payment_completed, withdrawal_completed, x402_payment_completed, x402_payment_failed, fund_request_funded, low_balance. Установите unread_only в false, чтобы включить уже прочитанные события. Установите mark_read в true, чтобы пометить события, возвращаемые этим вызовом, как прочитанные.

Получает ваш адрес для депозита USDC в сети Solana. Любой может отправить USDC на этот адрес для пополнения вашего кошелька. Также возвращает URL для пополнения на портале владельца.

Получает статус запроса на оплату по ID или ссылке. Показывает, был ли он оплачен.

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

Получает метаданные кошелька: статус, адрес для депозита, статус владельца/запроса, дату создания и тип кошелька. Для актуального баланса в сети, лимитов трат и оставшегося бюджета используйте botwallet_balance.

Перечисляет ваши запросы на финансирование с указанием статуса (ожидает, профинансирован, отклонен). Поддерживает пагинацию.

Выводит список ваших платежных запросов (paylinks) — это запросы, которые ВЫ создали для получения денег. Фильтруйте по статусу, чтобы найти ожидающие, завершённые или просроченные paylinks. Для платежей, которые ВЫ ОТПРАВИЛИ (исходящие), используйте botwallet_list_payments. Для всех движений средств используйте botwallet_transactions.

Выводит список исходящих платёжных намерений и их статусы жизненного цикла (ожидание, предодобрено, одобрено, завершено, отменено, истекло). Используйте это для отслеживания конкретных платежей, которые вы инициировали. Для полного реестра всех перемещений средств (входящих и исходящих) используйте botwallet_transactions.

Проверяет, существует ли получатель, перед оплатой. Возвращает его отображаемое имя и тип (merchant или bot) либо found: false, если ни у одного merchant или bot нет такого username.

Просматривает все защитные ограничения, установленные владельцем кошелька: лимиты трат (на транзакцию, дневные), ограничения получателей (белые/чёрные списки), лимиты заработка и правила вывода средств. Проверьте это перед попыткой выполнить операции, которые могут быть ограничены защитными ограничениями владельца.

Совершает платёж продавцу или боту. Указывает to + amount для прямых платежей либо payment_request_id, чтобы оплатить конкретную платёжную ссылку. Если платёж укладывается в ваши guard rails, он проходит сразу через пороговую подпись FROST и возвращает paid: true вместе с новым балансом. Если нужно одобрение владельца, возвращает needs_approval: true с transaction_id и approval_url. Порядок одобрения: (1) Отправьте approval_url своему владельцу-человеку (одно лишь одобрение платёж не отправляет) и сохраните transaction_id, (2) Опрашивайте botwallet_approval_status или botwallet_events, пока статус не станет "approved", (3) Вызовите botwallet_confirm_payment с transaction_id. Если платёж блокирует какой-то guard rail, возвращает ошибку с причиной. Перед тем как Key 1 подпишет, транзакцию проверяют: она должна выплатить согласованную сумму плюс максимум указанную комиссию. Каждый ответ содержит idempotency_key. Если вызов падает или отваливается по таймауту, следуйте его how_to_fix, а не вызывайте botwallet_pay снова: чтобы повторить тот же платёж, передайте тот же idempotency_key, и Botwallet вернёт этот платёж вместо повторной оплаты. Ошибка с кодом OUTCOME_UNKNOWN значит, что платёж мог пройти: сначала проверьте инструмент, названный в его check_tool (обычно botwallet_list_payments с его transaction_id). Результат со status: "pending" и sent: true значит, что платёж отправлен, а Solana его ещё не подтвердила: не платите снова; проверьте check_tool примерно через минуту. Комиссии: минимум $0.01 или 1% от суммы транзакции, что больше, плюс разовый сбор $0.25 за создание аккаунта, если адрес получателя никогда не держал USDC. Если не уверены в балансе, всегда сначала вызывайте botwallet_can_i_afford.

Выводит список действий, ожидающих одобрения владельца (платежи и выводы средств). Показывает URL-адреса для одобрения, чтобы владелец мог на них отреагировать.

Проверяет, доступен ли API BotWallet. Не требует аутентификации. Возвращает статус и версию API.

Регистрирует новый кошелёк бота с помощью FROST Distributed Key Generation. Вызывайте этот инструмент только тогда, когда ваш человек просит новый кошелёк. Если кошелёк уже настроен (botwallet_info работает или botwallet_wallet_list показывает один кошелёк), не регистрируйте новый: новый кошелёк отдельный и изначально пустой, и он не восполняет отсутствующий API-ключ или долю ключа. Создаёт кошелёк с пороговым ключом 2-of-2: бот хранит одну долю ключа локально, а сервер хранит другую. Ни одна доля по отдельности не может подписывать транзакции. Возвращает ссылку для получения + код получения, которые нужно отправить вашему владельцу-человеку, чтобы он мог получить кошелёк. Код получения истекает через 48 часов после регистрации. API-ключ кошелька и локальная доля ключа автоматически сохраняются в ~/.botwallet/ и не отображаются, и новый кошелёк становится кошельком по умолчанию.

Обновляет отображаемое имя кошелька, показываемое другим пользователям и в портале владельца. Используйте, когда хотите изменить бренд или уточнить назначение бота.

Запрашивает средства у своего владельца-человека. Отправляет уведомление с суммой и причиной. Используйте это, когда ваш баланс слишком низок для выполнения задачи.

Отправляет платежную ссылку конкретному получателю. Используйте после botwallet_create_paylink, чтобы доставить платежный запрос по электронной почте (для людей) или напрямую в почтовый ящик кошелька бота (для агентов). Получатель получает уведомление со ссылкой "Pay Now".

Просматривает полный реестр транзакций: все завершённые движения средств, включая отправленные платежи, полученные платежи, депозиты, выводы, комиссии и возвраты. Фильтрует по направлению (входящие/исходящие). Для отслеживания конкретных исходящих платежей по статусу используйте botwallet_list_payments.

Устанавливает или изменяет адрес электронной почты владельца для невостребованного кошелька. Владелец получит уведомление и сможет получить кошелек через портал.

⚠️ КОНФИДЕНЦИАЛЬНО: Раскрывает Key 1: 12 секретных слов локальной доли ключа этого кошелька, для резервной копии вашего человека-владельца. Вместе с Key 2 сервера Botwallet он может подписывать транзакции; владельцу он нужен, чтобы вывести средства из панели Botwallet и восстановить кошелёк. Используйте только когда ваш человек-владелец явно просит свой резервный ключ, и отправляйте слова только ему, приватно. Два шага, как в CLI: вызовите без code, чтобы получить одноразовый код (действует 30 секунд), затем вызовите снова с этим кодом, чтобы раскрыть слова.

Экспортирует текущий кошелёк в зашифрованный файл .bwlt, чтобы перенести его на другую машину (тот же формат, что и у Botwallet CLI). Файл хранит Key 1 этого кошелька и API-ключ, зашифрованные ключом, который сервер Botwallet выдаёт при импорте. Любой, у кого есть файл, может импортировать кошелёк в течение 24 часов (не более 5 импортов); после этого импортировать его уже нельзя, так что это не долгосрочная резервная копия. Обращайтесь с файлом как с 12 словами. Существующий файл никогда не перезаписывается.

Импортирует кошелёк из файла .bwlt, созданного botwallet_wallet_export или Botwallet CLI. Получает ключ расшифровки с сервера, сохраняет долю ключа и API-ключ локально под новым именем (существующий кошелёк никогда не заменяется) и назначает импортированный кошелёк кошельком по умолчанию.

Перечисляет все локально настроенные кошельки. Показывает, какой кошелек используется по умолчанию. Считывает из ~/.botwallet/config.json, реестра кошельков, общего с CLI.

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

Запрашивает вывод USDC на внешний адрес Solana. Каждый вывод требует одобрения вашего владельца-человека: возвращает needs_approval: true вместе с transaction_id и approval_url. Схема одобрения: (1) Отправьте approval_url вашему владельцу-человеку (одно лишь одобрение не переводит деньги) и сохраните transaction_id, (2) Опрашивайте botwallet_approval_status или botwallet_events, пока статус не станет "approved" (одобрения истекают через 24 часа), (3) Вызовите botwallet_confirm_withdrawal с transaction_id, чтобы поставить вторую подпись и отправить его. Если этот вызов завершается ошибкой или истекает по таймауту, следуйте его how_to_fix: чтобы повторить тот же запрос, передайте тот же idempotency_key. Комиссии: 3% от суммы (1% комиссия платформы, минимум $0.01, плюс 2% надбавка за вывод), плюс единоразовая комиссия $0.25 за настройку аккаунта, если на адресе назначения никогда не было USDC.

Ищет платные API, принимающие платежи x402. Выполняет поиск по курируемому каталогу API. Возвращает описания API, цены и конечные точки. Используйте его для поиска API перед вызовом botwallet_x402_fetch для их тестирования.

Проверяет URL на необходимость оплаты через x402. Если URL возвращает 200, содержимое отдаётся напрямую (бесплатно). Если возвращается 402, разбирает требования к оплате и готовит платёжное намерение: возвращает цену и fetch_id для использования с botwallet_x402_pay_and_fetch. Если платежу требуется одобрение владельца, возвращает needs_approval: true и approval_url, который нужно отправить вашему владельцу-человеку; вызывайте botwallet_x402_pay_and_fetch только после его одобрения. Деньги не тратятся - это просто «прогулка по витринам». Можно проверить несколько API и сравнить цены, прежде чем платить. Botwallet платит только API по HTTPS, которые принимают USDC в сети Solana.

Оплачивает и получает контент из x402 API. Использует fetch_id из botwallet_x402_fetch. Проверяет платёж (собственную цену и адрес API, плюс максимум заявленную комиссию и цент на округление), выполняет пороговую подпись FROST, собирает заголовок платежа, обращается к API и проводит расчёт. Цену и адрес сверяет с собственным ответом API только в том случае, если этот MCP-сервер запускал botwallet_x402_fetch и с тех пор не перезапускался; иначе - с теми, что записал Botwallet, при этом комиссия всё так же ограничена. Возвращает содержимое ответа API и детали платежа. Если он завершится ошибкой, следуйте его how_to_fix. Если ничего не оплачено, повторите с тем же fetch_id: повторное обращение к API через botwallet_x402_fetch запускает новый платёж.