botwallet-co/mcp

botwallet-co/mcp

от botwallet-co
MCP сервер для AI-агентов с финансовой автономией: выставление счетов, оплата API и управление USDC-кошельком. Владелец задаёт лимиты и одобряет крупные транзакции. Использует FROST-подписи — без единого приватного ключа.

Botwallet MCP Server

Let your AI agent send invoices to earn, pay for APIs and manage money, while you stay in control.

npm License GitHub stars

Give your AI agent financial autonomy without giving up control. Your agent can create invoices to get paid, spend on other agents and paid APIs, and manage its own USDC wallet. You set the spending limits, approve large transactions, and see everything it does. Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP-compatible client.

Website · Dashboard · Docs · CLI · npm


Add one JSON block to your MCP client config. That's it.

{
  "mcpServers": {
    "botwallet": {
      "command": "npx",
      "args": ["-y", "@botwallet/mcp"]
    }
  }
}

Then tell your agent: "Create a Botwallet for yourself."

It runs botwallet_register, generates a cryptographic key share locally, and comes back with a deposit address. No setup, no API keys to configure beforehand.

From there:

"Send $5 to @acme-bot for the data report"

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

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

Параметры
  • approval_idstringобязательный

    Approval ID to check

botwallet_balance

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

Параметры

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

botwallet_cancel_paylink

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

Параметры
  • request_idstringобязательный

    Payment request ID to cancel

botwallet_cancel_payment

Отменяет ожидающий или предварительно одобренный платёж, который ещё не подписан.

Параметры
  • transaction_idstringобязательный

    Transaction ID of the payment to cancel

botwallet_can_i_afford

Выполняет предварительную проверку перед оплатой. Возвращает два отдельных ответа: (1) can_afford - достаточно ли у вас средств? (2) will_auto_approve - пройдёт ли оплата без одобрения владельца? Также показывает комиссию, общую стоимость и ваш баланс после оплаты. Комиссия: минимум $0.01 или 1% от суммы транзакции, в зависимости от того, что больше. Всегда вызывайте эту проверку перед botwallet_pay, если не уверены в своём балансе.

Параметры
  • amountnumberобязательный

    Amount in USD

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

    Recipient username

botwallet_confirm_payment

Завершает платеж, который был ранее одобрен владельцем. Вызывайте эту функцию после того, как владелец одобрит через botwallet_events или URL одобрения. Выполняет пороговое подписание FROST для авторизации ончейн-транзакции.

Параметры
  • transaction_idstringобязательный

    Transaction ID from the original payment or approval event

botwallet_confirm_withdrawal

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

Параметры
  • transaction_idstringобязательный

    Transaction ID from the withdrawal or approval event

botwallet_create_paylink

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

Параметры
  • amountnumber

    Amount to request in USD (optional if items are provided — total calculated from items)

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

    What this payment is for

  • expires_instring

    Expiration time (e.g. "1h", "24h", "7d"). Default: 24h

  • itemsobject[]

    Itemized invoice line items. Total is auto-calculated from items.

  • referencestring

    Your internal reference for tracking

  • reveal_ownerboolean

    Show owner email on payment page (default: true)

botwallet_events

Получает уведомления/события кошелька. Типы событий включают: approval_resolved, deposit_received, payment_completed, fund_requested, guard_rails_updated. Установите mark_read в true, чтобы отметить возвращенные события как прочитанные.

Параметры
  • limitinteger

    Max events to return

  • mark_readboolean

    Mark returned events as read

  • sincestring

    Only return events after this ISO 8601 timestamp

  • typesstring[]

    Filter by event types

  • unread_onlyboolean

    Only return unread events

botwallet_get_deposit_address

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

Параметры

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

botwallet_get_paylink

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

Параметры
  • referencestring

    Your internal reference

  • request_idstring

    Payment request ID

botwallet_get_withdrawal

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

Параметры
  • withdrawal_idstringобязательный

    Withdrawal ID to look up

botwallet_info

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

Параметры

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

botwallet_list_fund_requests

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

Параметры
  • limitinteger

    Max results to return (1-100, default 20)

  • offsetinteger

    Number of results to skip (for pagination)

  • statusenum

    Filter by status (default: all)

botwallet_list_paylinks

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

Параметры
  • limitinteger

    Max results to return (1-100, default 20)

  • offsetinteger

    Number of results to skip (for pagination)

  • statusenum

    Filter by status (default: all)

botwallet_list_payments

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

Параметры
  • limitinteger

    Max results to return (1-100, default 20)

  • offsetinteger

    Number of results to skip (for pagination)

  • statusenum

    Filter by payment status (default: actionable — pending, pre_approved, approved)

  • transaction_idstring

    Filter by specific transaction ID

botwallet_lookup

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

Параметры
  • usernamestringобязательный

    Username to look up (e.g. "@clever-byte-1234")

botwallet_my_limits

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

Параметры

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

botwallet_pay

Осуществляет платеж продавцу или боту. Укажите to + amount для прямых платежей или payment_request_id для оплаты конкретной ссылки. Если платеж соответствует вашим ограничениям, он выполняется немедленно через пороговую подпись FROST и возвращает paid: true с вашим новым балансом. Если требуется одобрение владельца, возвращает needs_approval: true с transaction_id и approval_url. Процесс одобрения: (1) Сохраните transaction_id, (2) Опрашивайте botwallet_approval_status или botwallet_events, пока статус не станет "approved", (3) Вызовите botwallet_confirm_payment с transaction_id. Комиссия: минимум $0.01 или 1% от суммы транзакции, в зависимости от того, что больше. Всегда сначала вызывайте botwallet_can_i_afford, если не уверены в своем балансе.

Параметры
  • amountnumber

    Amount in USD (required unless using payment_request_id)

  • idempotency_keystring

    Unique key to prevent duplicate payments on retry. Auto-generated if omitted.

  • notestring

    Note visible to recipient

  • payment_request_idstring

    Pay a specific paylink by ID (alternative to to+amount)

  • referencestring

    Your internal reference for tracking

  • tostring

    Recipient username (required unless using payment_request_id)

botwallet_pending_approvals

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

Параметры

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

botwallet_ping

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

Параметры

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

botwallet_register

Регистрирует новый кошелёк бота с использованием FROST Distributed Key Generation. Создаёт кошелёк с пороговым ключом 2-из-2: бот хранит одну долю ключа локально, а сервер - другую. Ни одна из долей по отдельности не может подписывать транзакции. Возвращает API-ключ и код подтверждения для владельца-человека. Локальная доля ключа автоматически сохраняется в ~/.botwallet/seeds/.

Параметры
  • agent_modelstring

    Agent model identifier (e.g. "claude-sonnet-4", "gpt-4")

  • descriptionstring

    Purpose of this wallet (helps the owner identify it)

  • metadataobject

    Key-value metadata (e.g. {"platform": "cursor", "project": "my-app"})

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

    Display name for the bot (e.g. "my-trading-bot")

  • owner_emailstring

    Owner email — wallet will appear in their portal when they sign up

botwallet_rename

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

Параметры
  • namestringобязательный

    New display name

botwallet_request_funds

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

Параметры
  • amountnumberобязательный

    Amount to request in USD

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

    Why you need the funds (shown to owner)

botwallet_send_paylink

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

Параметры
  • messagestring

    Optional message to include

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

    Payment request ID to send

  • to_emailstring

    Send to this email address

  • to_walletstring

    Send to this bot wallet username

botwallet_transactions

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

Параметры
  • limitinteger

    Max results to return (1-100, default 20)

  • offsetinteger

    Number of results to skip (for pagination)

  • typeenum

    Transaction direction filter (default: all)

botwallet_update_owner

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

Параметры
  • owner_emailstringобязательный

    Email address of the human owner

botwallet_wallet_backup

⚠️ КОНФИДЕНЦИАЛЬНО: Раскрывает 12-словную мнемоническую резервную фразу для текущего кошелька. Это локальная доля ключа (S1) порогового ключа FROST 2-из-2. Любой, у кого есть эта мнемоническая фраза И доля серверного ключа, может подписывать транзакции. Используйте только когда пользователь явно запросит для целей резервного копирования.

Параметры

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

botwallet_wallet_export

Экспортирует текущий кошелёк в файл .bwlt для переноса на другую машину. Файл шифруется с помощью AES-256-GCM — ключ дешифрования хранится на сервере и извлекается при импорте. Сам по себе файл .bwlt не может разблокировать кошелёк.

Параметры
  • output_pathstringобязательный

    File path for the .bwlt export (e.g. "./my-wallet.bwlt")

botwallet_wallet_import

Импортирует кошелёк из файла .bwlt. Получает ключ дешифрования с сервера, расшифровывает данные кошелька и локально сохраняет долю ключа и конфигурацию.

Параметры
  • file_pathstringобязательный

    Path to the .bwlt file to import

botwallet_wallet_list

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

Параметры

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

botwallet_wallet_use

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

Параметры
  • namestringобязательный

    Name of the wallet to switch to

botwallet_withdraw

Выводит USDC на внешний адрес Solana. Если вывод предварительно одобрен, он выполняется немедленно через FROST threshold signing и возвращает withdrawn: true. Если требуется одобрение владельца, возвращает needs_approval: true с transaction_id и approval_url. Порядок одобрения: (1) Сохраните transaction_id, (2) Опрашивайте botwallet_approval_status или botwallet_events, пока статус не станет "approved", (3) Вызовите botwallet_confirm_withdrawal с transaction_id. Комиссия: минимум $0.01 или 1% от суммы транзакции, что больше.

Параметры
  • amountnumberобязательный

    Amount to withdraw in USD

  • idempotency_keystring

    Unique key to prevent duplicate withdrawals on retry. Auto-generated if omitted.

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

    Why you are withdrawing (shown to owner for approval)

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

    Solana wallet address to send USDC to

botwallet_x402_discover

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

Параметры
  • querystring

    Search query (e.g. "weather", "translation", "image generation")

botwallet_x402_fetch

Проверяет URL, чтобы определить, требует ли он оплаты x402. Если URL возвращает 200, содержимое возвращается напрямую (бесплатно). Если возвращает 402, разбирает требования к оплате и подготавливает платёжный интент: возвращает цену и fetch_id для использования с botwallet_x402_pay_and_fetch. Деньги не тратятся: это «витринный просмотр». Вы можете протестировать несколько API, чтобы сравнить цены перед совершением платежа.

Параметры
  • bodystring

    Request body (for POST/PUT)

  • headersobject

    Additional HTTP headers

  • methodenum

    HTTP method (default: GET)

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

    URL to probe (must be HTTPS)

botwallet_x402_pay_and_fetch

Оплачивает и извлекает содержимое из API x402. Использует fetch_id из botwallet_x402_fetch. Выполняет FROST threshold signing, строит заголовок платежа, запрашивает API и проводит расчёт. Возвращает содержимое ответа API и детали платежа.

Параметры
  • bodystring

    Request body for POST/PUT requests

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

    Fetch ID from a previous botwallet_x402_fetch call

  • headersobject

    Additional HTTP headers for the API request

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

hypeprinter007-stack/anchor-x402-mcp

hypeprinter007-stack/anchor-x402-mcp

MCP-сервер с 14 инструментами для блокчейн-агентов: хеширование, проверка кошельков, декодирование транзакций и анализ. Оплата за вызов через USDC по протоколу x402 — без подписок и API-ключей. Иде...

JavaScript1
refined-element/lightning-enable-mcp

refined-element/lightning-enable-mcp

MCP сервер для интеграции Lightning Network в AI-агентов: оплата счетов, работа с L402 API, управление кошельком и агентная коммерция через Nostr (ASA). Включает 23 инструмента — от платежей до про...

C#9
paracetamol951/P-Link-MCP

paracetamol951/P-Link-MCP

MCP сервер для интеграции Solana-кошелька с AI-ассистентами: оплата 402-ссылок, отправка денег на email или телефон, управление балансом. Полезен разработчикам и пользователям, автоматизирующим пла...

TypeScript2
kinance/circle-agent-stack-mcp

kinance/circle-agent-stack-mcp

MCP сервер для Circle Agent Stack: создавайте кошельки, задавайте политики трат, отправляйте USDC и платите за x402-эндпоинты одним вызовом инструмента. Полезен разработчикам агентов, которым нужны встроенные криптоплатежи с контролем расходов.

TypeScript1
blockrunai/blockrun-mcp

blockrunai/blockrun-mcp

официальный

BlockRun MCP — сервер реал-тайм данных для Claude: рынки, исследования, X/Twitter и крипто без API ключей. Оплата за вызов из USDC-кошелька, подходит трейдерам и аналитикам.

TypeScript395
up2itnow0822/clawpay-mcp

up2itnow0822/clawpay-mcp

AgentPay MCP — слой доверия и политик для AI-агентов: жёсткие лимиты трат, человеческое одобрение крупных платежей и аудит на блокчейне. Работает поверх x402 и Stripe MPP — идеально для FinOps, пла...

TypeScript5
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин