MCP SERVER

Инструменты кошелька агента для любого MCP client.

Официальный Blockchain0x MCP server дает MCP-aware agent возможность читать кошельки, отправлять USDC в Base и оплачивать invoices. Подключите hosted endpoint или запустите его локально одной командой.

https://mcp.blockchain0x.com/mcp

ЧТО ЭТО ТАКОЕ

Один server. Пять tools. Каждый MCP client.

Model Context Protocol - это стандартный способ, которым AI clients - Claude Desktop, Cursor, Cline и другие - вызывают внешние tools. Blockchain0x MCP server предоставляет ваши agent wallets через этот стандарт, так что любой MCP client может перемещать деньги без необходимости писать custom integration.

Сервер - это тонкий, stateless proxy над Blockchain0x API. Он не хранит средства и не использует базу данных; он пересылает каждый вызов инструмента в API с использованием предоставленного вами ключа, а permission на spending для каждого агента по-прежнему ограничивает то, что может делать инструмент.

ИНСТРУМЕНТЫ

Что может вызывать агент.

get_wallet

Прочитайте кошелек одного агента: адрес, баланс USDC в Base и метаданные.

list_wallets

Перечислите кошельки агентов в вашем workspace.

get_transaction

Найдите транзакцию по ее id и прочитайте ее on-chain статус.

send_payment

Отправьте USDC из кошелька агента в Base в пределах его разрешения на расходы.

settle_payment_request

Проведите платежный запрос, созданный вами в dashboard, с on-chain proof.

КАК ИСПОЛЬЗОВАТЬ

Два способа подключиться.

1. Hosted (Streamable HTTP)

Направьте ваш MCP client на hosted endpoint и передайте API key как Bearer header. Ничего устанавливать не нужно.

MCP CLIENT CONFIG (HOSTED)

{
  "mcpServers": {
    "blockchain0x": {
      "url": "https://mcp.blockchain0x.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

2. Local (stdio, via npx)

Запустите сервер на своей машине с помощью npx @blockchain0x/mcp. Ваш ключ остается в вашей среде и никогда не покидает ваше устройство.

MCP CLIENT CONFIG (STDIO)

{
  "mcpServers": {
    "blockchain0x": {
      "command": "npx",
      "args": ["@blockchain0x/mcp"],
      "env": { "BLOCKCHAIN0X_API_KEY": "sk_live_..." }
    }
  }
}

Начните с ключа sk_test_ в Base Sepolia, затем переключитесь на sk_live_. Полная настройка описана в the docs; чтобы назначить цену своим MCP tools, см. MCP integration recipe.

БЕЗОПАСНОСТЬ

Permission на spending по-прежнему применяется.

Сервер никогда не хранит ваши средства или ваши ключи; он пересылает каждый вызов в Blockchain0x API.
send_payment проверяется на соответствие лимиту агента на одну транзакцию и периодическому allowance до завершения, как и любой другой API-вызов.
Используйте ключ только для чтения (без pay scope) для агента, который должен только читать кошельки и транзакции.
При stdio ключ остается в вашей локальной среде. В hosted он передается как Bearer header по TLS и не сохраняется.

ЧАСТО ЗАДАВАЕМЫЕ

Три вопроса о MCP-сервере.

Где работает MCP-сервер и видите ли вы мой ключ?

Два способа запуска. Hosted: подключите ваш MCP-клиент к Streamable HTTP endpoint и передавайте ваш API key как Bearer header в каждом запросе; сервер - это stateless proxy, который пересылает вызовы в Blockchain0x API. Local (stdio): запустите npx @blockchain0x/mcp на своей машине, и ваш ключ останется в вашей среде, не покидая устройство. Выберите stdio, если не хотите отправлять ключ на hosted endpoint.

Какой API key мне использовать?

Ключ sk_test_ работает в Base Sepolia (testnet), так что вы можете подключить инструменты без перемещения реальных денег; переключитесь на ключ sk_live_ для mainnet. Области действия ключа определяют, что могут делать инструменты - ключ только для чтения может вызывать get_wallet, list_wallets и get_transaction, но не send_payment.

Это то же самое, что и helper requirePayment?

Нет. Эта страница посвящена Blockchain0x MCP server, который предоставляет MCP client инструменты кошелька агента (чтение кошельков, отправка USDC, оплата счетов). requirePayment - это отдельный helper в @blockchain0x/mcp, который используется для назначения цены вашим СОБСТВЕННЫМ MCP tools путем возврата x402 402 challenge. См. MCP integration recipe для этого.

Дайте вашему MCP client кошелек.

Создайте кошелек агента, получите ключ и направьте клиент на сервер. Начать можно бесплатно.