x402engine

x402engine-mcp

MCP server thân thiện với agent cho x402engine. Nó cho phép các agent 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 kết nối trực tiếp bao gồm LLM, tạo hình ảnh và video, tìm kiếm web và thu thập dữ liệu, 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 một 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.1"],
      "env": {
        "X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",
        "X402_PAYMENT_NETWORK": "base",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

Nạp tiền vào ví bằng USDC trên Base. Trình điều phối x402 trả phí gas giao dịch; ví ký ủy quyền USDC EIP-3009.

Solana

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

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

Khám phá mà 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ề các 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.1

Hermes Agent

Cài đặt kỹ năng x402engine và hợp nhất máy chủ này vào config.yaml của hồ sơ Hermes đang hoạt động:

mcp_servers:
  x402engine:
    command: npx
    args: ["-y", "x402engine-mcp@1.1.1"]
    env:
      X402_BASE_URL: "https://x402engine.app"
      X402_PAYMENT_NETWORK: "auto"
      X402_MAX_PAYMENT_USD: "0.10"

Bắt đầu một phiên mới và gọi discover_services hoặc service_health; cả hai đều miễn phí. Giữ mạng trên auto cho đến khi ví được cấu hình. Đối với thanh toán Base, lưu trữ X402_EVM_PRIVATE_KEY trong .env cục bộ của hồ sơ, thêm X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" vào env của máy chủ và thay đổi mạng thành base. Không bao giờ đặt khóa ví trong cuộc trò chuyện. Giới hạn áp dụng cho mỗi yêu cầu; ủy quyền một tổng ngân sách riêng cho mỗi nhiệm vụ.

Hướng dẫn thiết lập Hermes đầy đủ · Kỹ năng có thể cài đặt

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 Base USDC
X402_SOLANA_PRIVATE_KEY	chưa đặt	Khóa thanh toán Base58 hoặc JSON cho Solana USDC
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 kết nối sản xuất	Ghi đè URL cổng kết nối
X402_PAYMENT_HEADER	chưa đặt	Tiêu đề x402 ký trước 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 chuẩn 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 trên 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 tiêu đề 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ô tả của từng công cụ và trong khám phá trực tiếp. Danh mục cổng kết nối có thể thay đổi độc lập với gói này.

Khám phá

• Khám phá cổng kết nối: /.well-known/x402.json
• Thẻ agent: /.well-known/agent.json
• Bảng kê đ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