Xenarch — AI 에이전트 결제를 위한 x402 MCP 서버

Xenarch는 AI 에이전트가 Base L2의 USDC 소액 결제를 통해 HTTP 402로 제한된 API 및 콘텐츠에 비용을 지불할 수 있게 해주는 비수탁형 x402 MCP 서버입니다. Claude, Cursor, LangChain, CrewAI 에이전트는 HTTP 402 ("Payment Required") 응답을 자동으로 해결합니다. API 키, 구독, 등록된 신용카드가 필요 없습니다. 결제는 모든 x402 촉진자(facilitator)를 통해 게시자의 지갑으로 직접 온체인에서 정산됩니다. 촉진자 중립적이며, 수수료 0%, 중개 계약이 없습니다.

Xenarch의 차별점

Related MCP server: pay-mcp

작동 방식

1. Discover    xenarch_check_gate("example.com")
               → { gated: true, accepts: [...], facilitators: [...] }

2. Pay         xenarch_pay("example.com")
               → x402-fetch signs an EIP-3009 USDC transferWithAuthorization
               → Submits via the chosen facilitator on Base
               → Re-fetches the resource with proof of payment
               → { tx_hash, facilitator, content }

API 키가 필요 없습니다. 가입도 필요 없습니다. 에이전트가 온체인에서 직접 결제합니다. Xenarch는 자금을 보유하지 않으며 에이전트와 게시자 사이에 중개 계약이 없습니다.

MCP 도구

AI 에이전트를 위한 세 가지 도구:

응답 예시

{
  "gated": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "maxAmountRequired": "3000",
      "resource": "https://example.com/article",
      "payTo": "0xabc123...publisher_wallet",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "maxTimeoutSeconds": 60
    }
  ],
  "facilitators": [
    { "name": "PayAI", "url": "https://facilitator.payai.network", "priority": 1, "spec_version": "v1" },
    { "name": "xpay", "url": "https://facilitator.xpay.dev", "priority": 2, "spec_version": "v2" }
  ],
  "seller_wallet": "0xabc123...publisher_wallet",
  "network": "base",
  "asset": "USDC"
}

{
  "success": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "tx_hash": "0xdef456...abc789",
  "facilitator": "PayAI",
  "seller_wallet": "0xabc123...publisher_wallet",
  "url": "https://example.com/article",
  "wallet": "0x123...your_wallet",
  "content": "...gated content here..."
}

{
  "payments": [
    {
      "domain": "example.com",
      "amount_usd": "0.003",
      "tx_hash": "0xdef456...abc789",
      "paid_at": "2026-04-10T14:35:00Z"
    }
  ],
  "total_spent_usd": "0.003000",
  "count": 1,
  "wallet": "0x123...your_wallet"
}

HTTP 402 — x402가 마침내 활성화한 미사용 상태 코드

HTTP 402 Payment Required는 1997년부터 기계 간 결제를 위해 HTTP 사양에 예약된 상태 코드입니다. 클라이언트가 402 응답에 대해 어떻게 결제해야 하는지에 대한 개방형 프로토콜이 없었기 때문에 수십 년 동안 사용되지 않았습니다.

x402는 바로 그 프로토콜입니다. 서버가 서명된 가격과 결제 세부 정보가 포함된 HTTP 402를 반환하면, 클라이언트는 Base L2에서 USDC 소액 결제에 서명하고 결제 증명과 함께 요청을 재시도합니다. Xenarch의 MCP 서버는 AI 에이전트를 위해 이 두 과정을 모두 자동화합니다. 402 챌린지를 읽고, x402-fetch를 통해 결제에 서명하며, 요청을 재실행하여 온체인 트랜잭션 해시와 제한된 콘텐츠를 반환합니다.

더 알아보기: x402 사양은 결제 핸드셰이크를 정의합니다. pay.json(Xenarch 제작)은 /.well-known/pay.json에서 제공되는 기계 판독 가능한 가격 책정을 위한 동반 개방형 표준입니다. 결제를 위한 robots.txt라고 생각하면 됩니다.

HTTP 402를 이용한 API 수익화

Xenarch는 HTTP 402 사양을 기반으로 구축된 API 수익화 기본 요소입니다. 구독, 대시보드, API 키가 필요한 API 게이트웨이 수익화 플랫폼(Apigee, Kong, AWS API Gateway)과 달리, Xenarch는 계정 생성이나 키 프로비저닝 없이 모든 API가 요청당 요금을 부과할 수 있게 합니다. 호출자가 Base L2에서 USDC를 지불하면 API가 온체인 트랜잭션을 확인하고 액세스 권한을 부여합니다.

게시자에게 이는 다음을 의미합니다:

• Stripe/카드 결제 처리업체와 통합 불필요

• 구독 플랜, 가격 등급, 할당량 대시보드 불필요

• 플랫폼이 보유하는 수탁 잔액 없음

• 인간 사용자, 봇, AI 에이전트 모두에게 동일하게 작동하는 요청당 가격 책정

• 실시간으로 온체인에서 정산되는 API 수익화

Python SDK에는 데코레이터 하나로 작동하는 FastAPI 미들웨어가 포함되어 있습니다. 게시자 통합은 xenarch-sdks/python을 참조하세요.

설정

1. 지갑 구성:

mkdir -p ~/.xenarch
cat > ~/.xenarch/wallet.json << 'EOF'
{
  "privateKey": "0xYOUR_PRIVATE_KEY"
}
EOF
chmod 600 ~/.xenarch/wallet.json

2. Claude Code에 추가:

claude mcp add xenarch -- npx @xenarch/agent-mcp

또는 Claude Desktop / Cursor / 기타 MCP 클라이언트에 추가:

{
  "mcpServers": {
    "xenarch": {
      "command": "npx",
      "args": ["@xenarch/agent-mcp"],
      "env": {
        "XENARCH_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

환경 변수

예시

작동하는 통합 예시는 xenarch-examples를 참조하세요. Python 에이전트, LangChain, CrewAI, Claude Desktop 설정 및 게시자 미들웨어가 포함되어 있습니다.

개발

npm install
npm run build

구조

packages/
  shared/    — Payment logic, types, config (reused across servers)
  agent/     — MCP server for AI agents

FAQ

Claude는 Xenarch로 어떻게 API 비용을 지불하나요? Xenarch MCP 서버(claude mcp add xenarch -- npx @xenarch/agent-mcp)를 설치하고 지갑을 제공하면, Claude가 Base L2의 USDC 소액 결제를 통해 모든 HTTP 402 응답을 자동으로 해결합니다.

Xenarch는 Cursor, LangChain, CrewAI와 작동하나요? 네. Xenarch는 MCP 호환 클라이언트(Claude Code, Claude Desktop, Cursor, Cline, LangChain, CrewAI 및 Model Context Protocol을 지원하는 모든 클라이언트)가 사용할 수 있는 MCP 서버를 제공합니다.

게시자를 위한 FastAPI가 지원되나요? 네, Python SDK(pip install xenarch[fastapi])를 통해 지원됩니다. 데코레이터 하나로 구성된 미들웨어가 가격과 함께 HTTP 402를 반환하고 온체인 결제를 확인합니다. xenarch-sdks/python을 참조하세요.

Xenarch는 수탁형인가요? 아니요. 결제는 에이전트 지갑에서 게시자 지갑으로 직접 USDC를 전송하는 온체인 방식으로 정산됩니다. 자금은 Xenarch 인프라를 거치지 않으며 중개 계약도 없습니다.

수수료는 얼마인가요? 구조적으로 0%입니다. Xenarch는 자금 흐름에 관여하지 않습니다. 에이전트가 모든 x402 촉진자를 통해 게시자에게 직접 온체인으로 지불합니다.

호출당 최대 결제 금액은 얼마인가요? 1달러(USD)입니다.

x402란 무엇인가요? x402는 HTTP 402 Payment Required를 위한 개방형 프로토콜입니다. 서버가 가격과 함께 402를 반환하면, 클라이언트는 Base L2(또는 기타 지원되는 체인)에서 USDC 소액 결제에 서명하고 결제 증명과 함께 요청을 재시도합니다.

HTTP 402란 무엇인가요? HTTP 402 Payment Required는 1997년부터 기계 간 결제를 위해 HTTP 사양에 예약된 상태 코드입니다. x402는 이를 실제로 사용하는 개방형 프로토콜입니다.

Xenarch와 Cloudflare Pay-Per-Crawl은 어떻게 다른가요? Cloudflare Pay-Per-Crawl은 Cloudflare 뒤에 있는 사이트에서만 작동하며 수탁형입니다. Xenarch는 모든 호스트에서 작동하며 비수탁형입니다. 게시자는 온체인에서 직접 대금을 받습니다.

Xenarch와 TollBit은 어떻게 다른가요? TollBit은 엔터프라이즈 라이선스에 중점을 둡니다. Xenarch는 셀프 서비스 방식의 비수탁형이며, 엔터프라이즈 계약 없이도 수많은 게시자와 모든 AI 에이전트가 사용할 수 있습니다.

링크

• 웹사이트: https://xenarch.com

• npm: https://www.npmjs.com/package/@xenarch/agent-mcp

• PyPI: https://pypi.org/project/xenarch/

• Smithery: https://smithery.ai/servers/xenarch/xenarch-mcp

• GitHub: https://github.com/xenarch-ai/xenarch-mcp

라이선스

MIT