xenarch-mcp

npm License: MIT

Xenarch 결제 네트워크를 위한 MCP 서버입니다. AI 에이전트가 Base 네트워크의 USDC 소액 결제를 통해 서비스를 발견하고 비용을 지불할 수 있게 합니다.

작동 방식

1. Discover    xenarch_check_gate("example.com")
               → { gated: true, price_usd: "0.003", protocol: "x402" }

2. Pay         xenarch_pay("example.com")
               → USDC sent on Base via splitter contract
               → { access_token: "eyJ...", expires_at: "..." }

3. Access      Re-request the URL with Authorization: Bearer <token>
               → Full content returned

API 키나 가입 절차가 필요 없습니다. 에이전트가 온체인에서 직접 결제하며, Xenarch는 자금을 보관하지 않습니다.

에이전트 MCP 서버

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

도구	설명
`xenarch_check_gate`	URL/도메인에 결제 게이트가 있는지 확인합니다. 가격 및 결제 세부 정보를 반환합니다.
`xenarch_pay`	제한된 콘텐츠에 대해 결제합니다. 분할 계약(splitter contract)을 통해 Base에서 USDC 결제를 실행합니다.
`xenarch_get_history`	이 지갑으로 수행된 과거 결제 내역을 조회합니다.

응답 예시

{
  "gated": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "price_usd": "0.003",
  "splitter": "0xC6D3a6B6fcCD6319432CDB72819cf317E88662ae",
  "collector": "0xabc123...publisher_wallet",
  "network": "base",
  "asset": "USDC",
  "protocol": "x402"
}

{
  "success": true,
  "tx_hash": "0xdef456...abc789",
  "block_number": 28451023,
  "amount_usd": "0.003",
  "url": "example.com",
  "access_token": "eyJhbGciOiJIUzI1NiJ9...",
  "expires_at": "2026-04-10T15:05:00Z",
  "wallet": "0x123...your_wallet"
}

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

설정

지갑 구성:

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

Claude Code에 추가:

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

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

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

환경 변수

변수	기본값	설명
`XENARCH_PRIVATE_KEY`	—	지갑 개인 키 (설정 파일보다 우선)
`XENARCH_RPC_URL`	`https://mainnet.base.org`	Base RPC 엔드포인트
`XENARCH_API_BASE`	`https://api.xenarch.dev`	Xenarch 플랫폼 API
`XENARCH_NETWORK`	`base`	네트워크 (`base` 또는 `base-sepolia`)
`XENARCH_AUTO_APPROVE_MAX`	—	프롬프트 없이 자동 승인할 최대 USD 금액

예시

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

개발

npm install
npm run build

구조

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

라이선스

MIT

Xenarch Agent MCP

xenarch-mcp

작동 방식

에이전트 MCP 서버

응답 예시

설정

환경 변수

예시

개발

구조

라이선스

Resources

Latest Blog Posts

MCP directory API