x402engine

chính thức

Hơn 50 API trả phí theo cuộc gọi cho các tác nhân AI thông qua thanh toán vi mô crypto HTTP 402. $0.001–$0.12 mỗi cuộc gọi với USDC và USDm.

GitHub

Bạn có thể làm gì với x402engine MCP?

Khám phá các API trả phí có sẵn — duyệt qua danh mục cổng trực tiếp với discover_services để tìm các điểm cuối LLM, hình ảnh, tiền điện tử, du lịch và các điểm cuối trả phí theo yêu cầu khác.
Kiểm tra tình trạng dịch vụ trước khi thanh toán — sử dụng service_health để xác minh điểm cuối có thể truy cập được và xem giá hiện tại mà không tốn phí.
Tạo hình ảnh theo yêu cầu — gọi generate_image để tạo hình ảnh do AI tạo ra, với thanh toán USDC tự động trên Base hoặc Solana.
Thực thi mã trong môi trường sandbox — chạy các đoạn mã qua execute_code và thanh toán theo mỗi lần thực thi thông qua giao thức x402.
Lấy giá tiền điện tử và dữ liệu thị trường — truy vấn get_crypto_price, get_crypto_markets hoặc get_trending_crypto để có thông tin token và thị trường theo thời gian thực.
Tìm kiếm chuyến bay và khách sạn — sử dụng search_flights, search_hotels hoặc search_locations để tra cứu các lựa chọn du lịch với tính phí theo mỗi yêu cầu.

Tài liệu

x402engine-mcp

Máy chủ MCP thân thiện với tác nhân dành cho x402engine. Nó cho phép các tác nhân khám phá và gọi các API trả phí theo yêu cầu thông qua HTTP 402, với thanh toán USDC tự động trên Base hoặc Solana.

Cổng trực tiếp bao gồm LLM, tạo hình ảnh và video, tìm kiếm và thu thập dữ liệu web, thực thi mã, dữ liệu tiền điện tử và ví, mô phỏng giao dịch, âm thanh, du lịch và IPFS. MCP này cung cấp một bộ công cụ được tuyển chọn và khám phá trực tiếp cho toàn bộ danh mục.

Bắt Đầu Nhanh

Sử dụng ví thanh toán chuyên dụng, có số dư thấp. MCP ký các khoản thanh toán x402 cục bộ và không bao giờ gửi khóa riêng tư đến x402engine.

Base

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "x402engine-mcp@1.1.0"],
      "env": {
        "X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",
        "X402_PAYMENT_NETWORK": "base",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

Nạp USDC trên Base vào ví. Bên hỗ trợ x402 thanh toán phí gas giao dịch; ví ký ủy quyền USDC EIP-3009.

Solana

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "x402engine-mcp@1.1.0"],
      "env": {
        "X402_SOLANA_PRIVATE_KEY": "YOUR_BASE58_OR_JSON_PRIVATE_KEY",
        "X402_PAYMENT_NETWORK": "solana",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

Nạp USDC trên Solana và đủ SOL cho phí giao dịch vào ví.

Khám Phá Không Cần Ví

Máy chủ khởi động mà không cần ví, và các công cụ miễn phí như discover_services và service_health vẫn hoạt động. Các công cụ trả phí trả về yêu cầu thanh toán x402 của chúng cho đến khi ví được cấu hình.

claude mcp add x402engine -- npx -y x402engine-mcp@1.1.0

Kiểm Soát Thanh Toán

Biến	Mặc định	Mô tả
`X402_EVM_PRIVATE_KEY`	chưa đặt	Khóa thanh toán chuyên dụng cho USDC trên Base
`X402_SOLANA_PRIVATE_KEY`	chưa đặt	Khóa thanh toán Base58 hoặc JSON cho USDC trên Solana
`X402_PAYMENT_NETWORK`	`auto`	`auto`, `base`, hoặc `solana`
`X402_MAX_PAYMENT_USD`	`1.00`	Giới hạn chi tiêu cứng cho mỗi yêu cầu
`X402_BASE_URL`	cổng sản xuất	Ghi đè URL cổng
`X402_PAYMENT_HEADER`	chưa đặt	Header x402 được ký sẵn kế thừa
`X402_DEV_BYPASS`	chưa đặt	Bí mật bỏ qua phát triển

Trong chế độ auto, Base được ưu tiên khi cả hai khóa được cấu hình. Thanh toán tự động chỉ chấp nhận các hợp đồng USDC chính tắc trên Base và Solana. Nó từ chối các tài sản không xác định, mạng không được hỗ trợ và số tiền vượt quá giới hạn đã cấu hình trước khi ký.

MegaETH vẫn khả dụng cho các máy khách tự cung cấp header thanh toán tương thích của riêng họ.

Công Cụ MCP

Danh mục	Công cụ
Khám phá	`discover_services`, `service_health`
Hình ảnh và mã	`generate_image`, `execute_code`
Âm thanh	`transcribe_audio`
Tiền điện tử	`get_crypto_price`, `get_crypto_markets`, `get_crypto_history`, `get_trending_crypto`, `search_crypto`, `get_crypto_categories`
Ví và token	`get_wallet_balances`, `get_wallet_transactions`, `get_wallet_pnl`, `get_token_prices`, `get_token_metadata`
IPFS	`pin_to_ipfs`, `get_from_ipfs`
Du lịch	`search_flights`, `search_locations`, `search_hotels`, `search_cheapest_dates`

Giá được bao gồm trong mỗi mô tả công cụ và trong khám phá trực tiếp. Danh mục cổng có thể thay đổi độc lập với gói này.

Khám Phá

Khám phá cổng: /.well-known/x402.json
Thẻ tác nhân: /.well-known/agent.json
Tệp kê khai điểm cuối: /.well-known/agent-manifest.v1.json
API dịch vụ: /api/services
Siêu dữ liệu gói: server.json

Phát Triển

npm install
npm test
npm run build

Liên Kết

Trang web: x402engine.app
npm: x402engine-mcp
GitHub: agentc22/x402engine-mcp
Giao thức: x402.org