跳转到主要内容
MCP SERVER

适用于任何 MCP 客户端的 Agent 钱包工具。

官方 Blockchain0x MCP server 赋予支持 MCP 的 agent 读取 wallets、在 Base 上发送 USDC 以及结算 invoices 的能力。你可以连接托管端点,也可以用一条命令在本地运行。

https://mcp.blockchain0x.com/mcp
这是什么

一个 server。五个工具。适用于每个 MCP client。

Model Context Protocol 是 AI clients - Claude Desktop、Cursor、Cline 以及其他工具 - 调用外部 tools 的标准方式。Blockchain0x MCP server 通过这一标准暴露你的 agent wallets,因此任何 MCP client 都可以转移资金,而无需你编写自定义集成。

该 server 是位于 Blockchain0x API 之上的轻量无状态代理。它不持有资金,也不使用数据库;它会使用你提供的 key 将每次 tool 调用转发到 API,并且每个 agent 的 spend permission 仍然会限制 tool 能做什么。

这些工具

agent 可以调用的内容。

get_wallet

读取一个 agent 的 wallet:地址、Base 上的 USDC 余额以及 metadata。

list_wallets

列出你 workspace 中的 agent wallets。

get_transaction

通过交易 id 查询并读取其链上状态。

send_payment

在 agent 的 spend permission 范围内,从其 Base wallet 发送 USDC。

settle_payment_request

结算你在 dashboard 中创建的 payment request,并提供链上证明。

如何使用

两种连接方式。

1. 托管版(Streamable HTTP)

将你的 MCP client 指向托管端点,并将你的 API key 作为 Bearer header 传入。无需安装任何东西。

MCP CLIENT CONFIG(托管版)
{
  "mcpServers": {
    "blockchain0x": {
      "url": "https://mcp.blockchain0x.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

2. 本地版(stdio,通过 npx)

使用 npx @blockchain0x/mcp 在你自己的机器上运行 server。你的 key 会保留在你的环境中,绝不会离开你的设备。

MCP CLIENT CONFIG(STDIO)
{
  "mcpServers": {
    "blockchain0x": {
      "command": "npx",
      "args": ["@blockchain0x/mcp"],
      "env": { "BLOCKCHAIN0X_API_KEY": "sk_live_..." }
    }
  }
}

先使用 Base Sepolia 上的 sk_test_ 密钥开始,然后切换到 sk_live_。完整设置请见 the docs;如果要为你自己的 MCP tools 定价,请查看 MCP integration recipe

安全

spend permission 仍然适用。

  • 该 server 从不持有你的资金或你的 keys;它会将每次调用转发到 Blockchain0x API。
  • send_payment 在结算前会根据 agent 的单笔交易上限和周期额度进行检查,与其他任何 API 调用相同。
  • 为只需读取钱包和交易的 agent 使用只读密钥(无支付权限)。
  • 在 stdio 模式下,key 保留在你的本地环境中。在托管版中,它会通过 TLS 以 Bearer header 传输,并且不会被存储。
常见问题

三个 MCP server 问题。

MCP server 运行在哪里?你会看到我的密钥吗?

两种运行方式。托管版:将你的 MCP client 连接到 Streamable HTTP 端点,并在每次请求中将你的 API key 作为 Bearer header 发送;该 server 是一个无状态代理,会将调用转发到 Blockchain0x API。本地版(stdio):在你自己的机器上运行 npx @blockchain0x/mcp,你的 key 会保留在你的环境中,绝不会离开你的设备。如果你不想将 key 发送到托管端点,请选择 stdio。

我应该使用哪个 API key?

sk_test_ 密钥会在 Base Sepolia(testnet)上运行,因此你可以在不动用真实资金的情况下接入这些工具;切换到 sk_live_ 密钥即可用于 mainnet。密钥的 scopes 决定工具能做什么 - 只读密钥可以调用 get_wallet、list_wallets 和 get_transaction,但不能调用 send_payment。

这和 requirePayment helper 是同一个东西吗?

不是。这一页介绍的是 Blockchain0x MCP server,它为 MCP client 提供 agent wallet 工具(读取钱包、发送 USDC、结算发票)。requirePayment 是 @blockchain0x/mcp 中的一个独立 helper,你可以通过返回一个 x402 402 challenge 来为你自己的 MCP tools 定价。具体请参见 MCP integration recipe。

给你的 MCP client 一个 wallet。

创建一个 agent wallet,获取一个 key,然后将你的 client 指向该 server。可免费开始。