Bỏ qua nội dung chính
MCP SERVER

Công cụ ví agent cho bất kỳ MCP client nào.

Server MCP chính thức của Blockchain0x cho một agent hiểu MCP khả năng đọc ví, gửi USDC trên Base, và thanh toán hóa đơn. Kết nối tới hosted endpoint, hoặc chạy cục bộ chỉ với một lệnh.

https://mcp.blockchain0x.com/mcp
NÓ LÀ GÌ

Một server. Năm công cụ. Mọi MCP client.

Model Context Protocol là cách tiêu chuẩn để các AI client - Claude Desktop, Cursor, Cline, và các công cụ khác - gọi các công cụ bên ngoài. Server MCP của Blockchain0x cung cấp ví agent của bạn thông qua chuẩn đó, nên bất kỳ MCP client nào cũng có thể chuyển tiền mà không cần bạn viết một tích hợp tùy chỉnh.

Server là một proxy mỏng, không trạng thái, nằm trên Blockchain0x API. Nó không giữ tiền và không có cơ sở dữ liệu; nó chuyển tiếp từng lệnh gọi công cụ tới API bằng khóa bạn cung cấp, và quyền chi tiêu trên mỗi agent vẫn giới hạn những gì công cụ có thể làm.

CÁC CÔNG CỤ

Những gì agent có thể gọi.

get_wallet

Đọc ví của một agent: địa chỉ, số dư USDC trên Base, và metadata.

list_wallets

Liệt kê các ví agent trong workspace của bạn.

get_transaction

Tra cứu một giao dịch theo id và xem trạng thái on-chain của nó.

send_payment

Gửi USDC từ ví của một agent trên Base, trong phạm vi quyền chi tiêu của nó.

settle_payment_request

Thanh toán một yêu cầu thanh toán bạn đã tạo trong dashboard, với bằng chứng on-chain.

CÁCH SỬ DỤNG

Hai cách để kết nối.

1. Hosted (Streamable HTTP)

Trỏ MCP client của bạn tới hosted endpoint và truyền API key của bạn dưới dạng Bearer header. Không cần cài đặt gì cả.

CẤU HÌNH MCP CLIENT (HOSTED)
{
  "mcpServers": {
    "blockchain0x": {
      "url": "https://mcp.blockchain0x.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

2. Local (stdio, qua npx)

Chạy server trên máy của bạn với npx @blockchain0x/mcp. Khóa của bạn vẫn nằm trong môi trường của bạn và không bao giờ rời khỏi thiết bị.

CẤU HÌNH MCP CLIENT (STDIO)
{
  "mcpServers": {
    "blockchain0x": {
      "command": "npx",
      "args": ["@blockchain0x/mcp"],
      "env": { "BLOCKCHAIN0X_API_KEY": "sk_live_..." }
    }
  }
}

Bắt đầu với một khóa sk_test_ trên Base Sepolia, sau đó chuyển sang sk_live_. Thiết lập đầy đủ có trong the docs; để định giá các công cụ MCP của riêng bạn, xem công thức tích hợp MCP.

AN NINH

Quyền chi tiêu vẫn được áp dụng.

  • Server không bao giờ giữ tiền hoặc khóa của bạn; nó chuyển tiếp từng lệnh gọi tới Blockchain0x API.
  • send_payment được kiểm tra theo hạn mức mỗi giao dịch và hạn mức theo kỳ của agent trước khi được thanh toán, tương tự như bất kỳ API call nào khác.
  • Dùng một khóa chỉ đọc (không có phạm vi pay) cho một agent chỉ nên đọc ví và giao dịch.
  • Trên stdio, key ở lại trong môi trường local của bạn. Trên hosted, key được truyền dưới dạng Bearer header qua TLS và không được lưu trữ.
CÂU HỎI THƯỜNG GẶP

Ba câu hỏi về MCP server.

MCP server chạy ở đâu, và bạn có thấy khóa của tôi không?

Hai cách để chạy nó. Hosted: kết nối MCP client của bạn tới Streamable HTTP endpoint và gửi API key của bạn dưới dạng Bearer header trong mỗi request; server là một proxy không trạng thái chuyển tiếp các lệnh gọi tới Blockchain0x API. Local (stdio): chạy npx @blockchain0x/mcp trên máy của bạn và khóa của bạn sẽ ở trong môi trường của bạn, không bao giờ rời khỏi thiết bị. Chọn stdio nếu bạn không muốn gửi khóa tới một hosted endpoint.

Tôi nên dùng API key nào?

Một sk_test_ key chạy trên Base Sepolia (testnet) để bạn có thể tích hợp công cụ mà không cần chuyển tiền thật; hãy chuyển sang sk_live_ key cho mainnet. Phạm vi của key quyết định các công cụ có thể làm gì - một read-only key có thể gọi get_wallet, list_wallets và get_transaction nhưng không thể send_payment.

Đây có phải là cùng một helper requirePayment không?

Không. Trang này nói về Blockchain0x MCP server, cung cấp cho MCP client các công cụ ví agent (đọc ví, gửi USDC, thanh toán hóa đơn). requirePayment là một helper riêng trong @blockchain0x/mcp mà bạn dùng để đặt giá cho các công cụ MCP CỦA CHÍNH BẠN bằng cách trả về một x402 402 challenge. Xem MCP integration recipe để biết chi tiết.

Cấp cho MCP client của bạn một ví.

Tạo một ví agent, lấy một key và trỏ client của bạn tới server. Bắt đầu miễn phí.