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로 변경하세요. 지갑 키를 채팅에 절대 넣지 마세요. 상한선은 요청당 적용됩니다. 각 작업에 대해 별도의 총 예산을 승인하세요.
결제 제어
| 변수 | 기본값 | 설명 |
|---|---|---|
X402_EVM_PRIVATE_KEY | 설정 안 됨 | Base USDC용 전용 결제자 키 |
X402_SOLANA_PRIVATE_KEY | 설정 안 됨 | Solana USDC용 Base58 또는 JSON 결제자 키 |
X402_PAYMENT_NETWORK | auto | auto, base 또는 solana |
X402_MAX_PAYMENT_USD | 1.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 |
| IPFS | pin_to_ipfs, get_from_ipfs |
| 여행 | search_flights, search_locations, search_hotels, search_cheapest_dates |
가격은 각 도구 설명과 실시간 발견에 포함됩니다. 게이트웨이 카탈로그는 이 패키지와 독립적으로 변경될 수 있습니다.
발견
- 게이트웨이 발견: /.well-known/x402.json
- 에이전트 카드: /.well-known/agent.json
- 엔드포인트 매니페스트: /.well-known/agent-manifest.v1.json
- 서비스 API: /api/services
- 패키지 메타데이터: server.json
개발
npm install
npm test
npm run build
링크
- 웹사이트: x402engine.app
- npm: x402engine-mcp
- GitHub: agentc22/x402engine-mcp
- 프로토콜: x402.org