basezap-mcp

Сервер MCP (Model Context Protocol), который предоставляет инструменты типпинг-агента BaseZap любому MCP-клиенту — Claude Desktop, Cursor, Claude Code и т.д.

Этот сервер только для чтения / некастодиальный по замыслу: он никогда не хранит закрытые ключи, ничего не подписывает и никогда не отправляет транзакции. Он только получает информацию о платформе, вычисляет комиссионные сборы и формирует неподписанные данные вызова ERC-20 перевода для отдельного клиента с подключенным кошельком, который подписывает и отправляет их.

Инструменты

• get_platform_info — цепочка, адрес USDC, комиссия платформы (bps), кошелек комиссии.

• get_tip_quote — по заданной сумме USDC возвращает точное распределение комиссии создателя/платформы.

• build_tip_calldata — по адресу получателя + сумме возвращает неподписанные данные вызова для обеих частей чаевых. Никогда не подписывает и не отправляет ничего.

• resolve_farcaster_username — преобразует имя пользователя Farcaster в его подтвержденный адрес кошелька (использует конечную точку /api/resolve-user BaseZap напрямую).

Related MCP server: x402-bazaar-mcp

Установка

npm install --ignore-scripts
npm run build

(--ignore-scripts позволяет избежать проблем со сборкой нативных модулей в некоторых средах, например, Termux/Android — безвредно использовать везде.)

Запуск отдельно (для тестирования)

npm start

Или протестируйте вызов одного инструмента напрямую через stdio без какого-либо MCP-клиента:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_tip_quote","arguments":{"amountUsdc":1}}}' | node build/index.js

Конфигурация Claude Desktop

Добавьте это в ваш claude_desktop_config.json (Настройки → Разработчик → Редактировать конфиг):

{
  "mcpServers": {
    "basezap": {
      "command": "node",
      "args": ["/absolute/path/to/basezap-mcp/build/index.js"],
      "env": {
        "BASEZAP_USE_X402": "false"
      }
    }
  }
}

Замените путь на реальный абсолютный путь к build/index.js на вашей машине. Перезапустите Claude Desktop после редактирования конфига.

Бесплатный vs. платный (x402) режим

По умолчанию (BASEZAP_USE_X402=false или не задано) сервер вызывает бесплатную конечную точку BaseZap (/api/agent). Установите BASEZAP_USE_X402=true, чтобы направлять вызовы через платную конечную точку x402 ($0.001 USDC за вызов).

Важно: установка BASEZAP_USE_X402=true сама по себе НЕ заставляет сервер платить автоматически — вы получите четкую ошибку HTTP 402 Payment Required при каждом вызове, если вы отдельно не настроили автоплатеж (см. ниже) или не используете MCP-клиент/шлюз, который уже обрабатывает платежи x402 за вас.

Опционально: автоплатеж x402

См. AUTOPAY.md для подробного руководства по настройке этого сервера на автоматическую оплату собственных комиссий x402 с использованием пополненного кошелька. Внимательно прочитайте его перед использованием — это включает размещение реального закрытого ключа в переменной окружения, и неправильно настроенный сервер автоплатежа может незаметно тратить реальные деньги при каждом вызове инструмента. Он НЕ подключен по умолчанию, и вы должны понимать, что именно он делает, прежде чем включать его.

Подтвержденный контракт запроса

Точная форма запроса/ответа, на которую полагается этот сервер, была подтверждена вживую против реальной конечной точки /api/agent (не предполагалась из документации):

{ "tool": "get_tip_quote", "args": { "amount_usdc": 1 } }

возвращает:

{ "total_usdc": 1, "creator_receives_usdc": 0.95, "platform_fee_usdc": 0.05, "platform_fee_bps": 500 }

Обратите внимание, что сам API использует имена полей в snake_case внутри args — входные данные инструментов MCP этого сервера используют удобный camelCase (amountUsdc) и переводятся внутренне, так что это актуально только если вы модифицируете сам сервер.