x402engine

공식

50개 이상의 호출당 지불 API로, HTTP 402 암호화폐 소액결제를 통해 AI 에이전트에 제공됩니다. 호출당 $0.001–$0.12이며 USDC와 USDm을 사용합니다.

x402engine MCP(으)로 무엇을 할 수 있나요?

  • 유료 API 발견 — 어시스턴트에게 discover_services를 통해 사용 가능한 요청당 과금 서비스 목록을 요청하고, service_health로 상태를 확인하세요.
  • 이미지 생성 및 코드 실행 — generate_image로 이미지 생성을 요청하거나 execute_code로 코드 실행을 요청할 수 있으며, Base 또는 Solana에서 자동 USDC 결제가 이루어집니다.
  • 암호화폐 및 지갑 데이터 조회 — get_crypto_price 및 get_wallet_balances 같은 도구를 사용하여 가격, 시장 동향, 지갑 잔액, 거래 내역, 토큰 메타데이터를 확인하세요.
  • 오디오 및 IPFS 처리 — transcribe_audio로 오디오 파일을 텍스트로 변환하거나, pin_to_ipfs 및 get_from_ipfs를 사용하여 IPFS에서 콘텐츠를 고정하고 검색하세요.
  • 여행 옵션 검색 — search_flights 및 search_hotels 같은 도구로 항공편, 호텔, 위치, 가장 저렴한 여행 날짜를 찾아보세요.

문서

x402engine-mcp

에이전트 친화적인 MCP 서버로, x402engine용입니다. 에이전트가 HTTP 402를 통해 요청당 지불 API를 발견하고 호출할 수 있게 하며, Base 또는 Solana에서 자동 USDC 결제를 지원합니다.

라이브 게이트웨이는 LLM, 이미지 및 비디오 생성, 웹 검색 및 스크래핑, 코드 실행, 암호화폐 및 지갑 데이터, 트랜잭션 시뮬레이션, 오디오, 여행, IPFS를 다룹니다. 이 MCP는 전체 카탈로그에 대한 선별된 도구 세트와 실시간 발견 기능을 제공합니다.

빠른 시작

전용 저잔액 결제자 지갑을 사용하세요. MCP는 x402 결제를 로컬에서 서명하며 개인 키를 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"
      }
    }
  }
}

지갑에 Base의 USDC를 충전하세요. x402 파실리테이터가 트랜잭션 가스를 지불하며, 지갑은 EIP-3009 USDC 승인에 서명합니다.

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"
      }
    }
  }
}

지갑에 Solana의 USDC와 트랜잭션 수수료에 충분한 SOL을 충전하세요.

지갑 없이 발견

서버는 지갑 없이 시작되며, discover_services 및 service_health 같은 무료 도구는 여전히 작동합니다. 유료 도구는 지갑이 구성될 때까지 x402 결제 요구 사항을 반환합니다.

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

Hermes 에이전트

x402engine 스킬을 설치하고 이 서버를 활성 Hermes 프로필의 config.yaml에 병합하세요:

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"

새 세션을 시작하고 discover_services 또는 service_health를 호출하세요. 둘 다 무료입니다. 지갑이 구성될 때까지 네트워크를 auto로 유지하세요. Base 결제의 경우, 프로필의 로컬 .env에 X402_EVM_PRIVATE_KEY를 저장하고, 서버의 env에 X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}"를 추가하고, 네트워크를 base로 변경하세요. 지갑 키를 채팅에 절대 넣지 마세요. 상한선은 요청당 적용됩니다. 각 작업에 대해 별도의 총 예산을 승인하세요.

전체 Hermes 설정 가이드 · 설치 가능한 스킬

결제 제어

변수기본값설명
X402_EVM_PRIVATE_KEY설정 안 됨Base USDC용 전용 결제자 키
X402_SOLANA_PRIVATE_KEY설정 안 됨Solana USDC용 Base58 또는 JSON 결제자 키
X402_PAYMENT_NETWORKautoauto, base 또는 solana
X402_MAX_PAYMENT_USD1.00요청당 하드 지출 상한
X402_BASE_URL프로덕션 게이트웨이게이트웨이 URL 재정의
X402_PAYMENT_HEADER설정 안 됨레거시 사전 서명 x402 헤더
X402_DEV_BYPASS설정 안 됨개발 우회 비밀

auto 모드에서는 두 키가 모두 구성된 경우 Base가 선호됩니다. 자동 결제는 Base 및 Solana의 표준 USDC 계약만 허용합니다. 서명 전에 알 수 없는 자산, 지원되지 않는 네트워크 및 구성된 상한을 초과하는 금액을 거부합니다.

MegaETH는 자체 호환 결제 헤더를 제공하는 클라이언트에 계속 사용할 수 있습니다.

MCP 도구

카테고리도구
발견discover_services, service_health
이미지 및 코드generate_image, execute_code
오디오transcribe_audio
암호화폐get_crypto_price, get_crypto_markets, get_crypto_history, get_trending_crypto, search_crypto, get_crypto_categories
지갑 및 토큰get_wallet_balances, get_wallet_transactions, get_wallet_pnl, get_token_prices, get_token_metadata
IPFSpin_to_ipfs, get_from_ipfs
여행search_flights, search_locations, search_hotels, search_cheapest_dates

가격은 각 도구 설명과 실시간 발견에 포함됩니다. 게이트웨이 카탈로그는 이 패키지와 독립적으로 변경될 수 있습니다.

발견

개발

npm install
npm test
npm run build

링크