AgentPay MCP

x402 V1/V2 + Stripe MPP 호환 — 프로토콜 중립적 지출 통제.

agentpay-mcp는 상품화된 실행 레일(x402, ACP, UCP) 위에 놓이는 인간 우선 신뢰 및 정책 레이어입니다. OWS 호환 신뢰 레이어 — MoonPay Open Wallet Standard 위에서 작동합니다. 프로토콜 중립적 신뢰 레이어 — x402 및 Stripe MPP와 함께 작동합니다. x402가 연간 6억 달러 규모를 결제하고 — AI 에이전트가 프로토콜 활동의 40%를 주도하는(2026년 3월) 상황에서 — 빠진 조각은 결제 실행이 아닙니다. 바로 거버넌스입니다: 누가 승인했는지, 얼마를 쓸 수 있는지, 에이전트가 예산을 초과하려 할 때 어떤 일이 일어나는지. 이것이 agentpay-mcp가 제공하는 것입니다.

ACP는 에이전트가 판매하는 것을 처리합니다. agentpay-mcp는 에이전트가 구매하는 것을 처리합니다. ACP(Agent Commerce Protocol)는 에이전트가 서비스를 등록하고, 협상하고, 결제를 수신할 수 있게 합니다. agentpay-mcp는 보완 레이어입니다 — 에이전트가 유료 API, 도구, 서비스를 소비할 때 지출을 통제합니다. 다른 문제, 호환 가능한 솔루션.

에이전트가 HTTP 402 Payment Required를 만나면, 결제하고 재시도해야 합니다 — 여러분의 승인 아래, 여러분이 설정한 한도 내에서. AgentPay MCP는 Claude, Cursor 및 모든 MCP 호환 에이전트에게 엄격한 지출 상한, 인간 승인 모드, 완전한 온체인 감사 추적을 갖춘 결제 지갑을 제공하는 Model Context Protocol 서버입니다.

MCP 생태계는 이제 월 9,700만 회 이상 다운로드와 10,000개 이상의 활성 서버를 보유하고 있습니다 — agentpay-mcp는 유일한 MCP 네이티브 완전 결제 실행 레이어입니다.

✅ **NVIDIA/NeMo-Agent-Toolkit-Examples**에 통합됨 (PR #17 병합됨) — NVIDIA 공식 에이전트 툴킷을 위한 결제 인프라.

📌 AgentIndex 플래그십 제안 및 샌드박스 결제 데모: 에이전트가 API 호출을 안전하게 구매하는 방법 및 AgentPay MCP 신뢰 결과.

📌 x402 생태계 등재 맥락은 docs/x402-ecosystem-submission.md에서 추적됩니다.

누가 agentpay-mcp를 사용하나요?

agentpay-mcp는 모두 동일한 문제, 즉 통제 없이 돈을 지출하는 자율 에이전트를 가진 세 가지 구매자 페르소나를 위해 설계되었습니다.

FinOps 팀: agentpay-mcp는 개발자만이 아니라 여러분의 워크플로를 위해 설계된 최초의 거버넌스 레이어입니다. 기존 FinOps 도구에 맞춰 들어가는 예산 상한, 승인 임계값, 비용 귀속을 제공합니다.

Related MCP server: 402-mcp

신뢰가 중요한 이유

McKinsey의 2026 AI 신뢰 성숙도 조사는 빌더들이 이미 느끼고 있던 것을 수치로 보여줍니다: 에이전트 역량이 에이전트 거버넌스를 앞질렀습니다.

신뢰 격차는 배포 격차입니다. 기업들은 에이전트가 작동하지 않는다고 말하는 것이 아니라, 감독 인프라(승인 워크플로, 지출 가드레일, 신원 확인, 감사 추적)가 속도를 따라오지 못하고 있다고 말합니다.

AgentPay MCP는 이 문제를 직접 해결합니다:

• 인간 승인 모드 — 임계값을 초과하는 거래는 실행 전에 명시적인 인간 확인을 요구합니다

• 온체인 지출 상한 — 지갑 소유자가 계약에 설정한 경우 애플리케이션 코드가 재정의할 수 없는 AgentAccountV2 스마트 계약 한도. set_spend_policy 도구는 별도의 프로세스 내 정책을 설정합니다 (정확한 통제 경계는 docs/security-posture.md 참조)

• 감사 추적 — get_transaction_history를 통한 불변의 온체인 AgentAccountV2 이벤트 기록 (수신자, 금액, 블록 번호). 체인에 도달하기 전에 거부된 결제 시도는 기록되지 않습니다

• Fail-closed — 정책 엔진 오류는 승인이 아닌 거부를 생성합니다

• 비수탁형 — 개인 키는 로컬 머신을 벗어나지 않습니다

기업의 88%가 에이전트 보안 사고를 겪은 상황에서, "기본 신뢰"는 실현 가능한 아키텍처가 아닙니다. AgentPay MCP는 "검증 후 신뢰"를 위해 설계되었습니다 — 이것이 확장 가능한 유일한 모델입니다.

MCP 에이전트에게 비용 거버넌스가 중요한 이유

Model Context Protocol은 에이전트에게 강력한 도구에 대한 접근을 제공하지만, 프로토콜 자체에는 그러한 도구의 비용을 통제하는 내장 메커니즘이 없습니다. 이는 이론적 격차가 아닙니다. WorkOS의 2026 MCP 보안 가이드는 속도 제한, 비용 귀속, 호출별 지출 상한을 MCP 프로토콜 수준에서 해결되지 않은 문제로 명시합니다. 모든 MCP 서버는 비용을 청구할 수 있습니다. 어떤 MCP 클라이언트도 예산을 강제하지 않습니다.

결과적으로, 10개의 MCP 서버에 접근할 수 있는 에이전트는 세션에 걸쳐 무제한 비용을 누적할 수 있으며, 도구별 지출을 귀속시키거나 호출별 노출을 상한으로 제한하거나 지갑을 고갈시키기 전에 폭주 루프를 중단할 표준 방법이 없습니다.

AgentPay MCP는 이 격차를 인프라 레이어에서 해소합니다:

유료 API와 상호작용하는 에이전트를 구축하고 있다면, MCP 지출 한도와 MCP 비용 거버넌스는 선택 사항이 아닙니다 — 데모와 프로덕션 배포의 차이입니다. AgentPay MCP는 프로토콜의 경계에서 이 문제를 해결하는 오픈소스 레퍼런스 구현입니다.

보안 및 의존성

AgentPay MCP는 공급망 보안이 중요한 엔터프라이즈 MCP 배포를 위해 설계되었습니다.

• LiteLLM 의존성 제로. LiteLLM 또는 무거운 LLM 라우팅 계층에 대한 직접적이거나 전이적인 의존성이 없습니다. LiteLLM 1.82.7-1.82.8 버전이 PyPI에서 손상(2026년 3월)되었을 때, AgentPay MCP 사용자는 영향을 받지 않았습니다.

• 감사 가능한 최소한의 의존성 트리. 서버는 viem, @modelcontextprotocol/sdk 및 소수의 감사 가능한 npm 패키지에서 실행됩니다. PyPI가 없고 Python 런타임도 필요하지 않습니다.

• 엔터프라이즈 신뢰 신호. NVIDIA 공식 NeMo Agent Toolkit 예제(PR #17, 병합됨)에 통합되었습니다. NVIDIA의 검토 프로세스는 병합 전에 보안 태세를 검증했습니다.

• 비수탁(Non-custodial) 아키텍처. 개인 키는 로컬 머신을 절대 벗어나지 않습니다. 온체인 지출 한도는 에이전트나 해당 키가 손상되더라도 제한을 강제합니다.

• Vercel 배포 강화. Vercel에 AI 에이전트를 배포하는 경우, OAuth, 대시보드, CI 또는 환경 변수 노출 후 유료 도구를 다시 연결하기 전에 Vercel 배포 강화 체크리스트를 검토하세요.

• x402 스캐너 대비. 스캐너가 읽을 수 있는 x402 지원이 필요한 유료 API 데모의 경우 x402 스캐너 대비 레시피를 사용하세요.

• x402 Bazaar 관찰 가능성. 검색 가능한 Bazaar 카탈로그에 진입하는 유료 MCP 도구의 경우 x402 Bazaar 관찰 가능성 레시피를 사용하여 WithBazaar 검색 메타데이터, 통합 인증 및 EXTENSION-RESPONSES 읽기 저장을 다루세요.

• x402 일괄 결제 채널. 입금, 바우처, 환불 및 청구 흐름을 사용하는 반복 유료 MCP 호출의 경우 x402 일괄 결제 채널 레시피를 사용하여 채널 저장소, 바우처 한도, 복구 및 오프체인 결제 감사 추적을 프로덕션에 안전하게 유지하세요.

• x402 멀티 SDK 일괄 결제 패리티. x402 TypeScript 및 Go 일괄 결제 클라이언트를 테스트하는 제공업체의 경우 멀티 SDK 일괄 결제 패리티 레시피를 사용하여 공유 채널 상태, 단계별 e2e 결과, 서명자 분리, 환불/복구 가시성 및 증명 번들 형태를 입증하세요.

• x402 TVM 대비. 새로운 x402 예제의 TVM/TON 정확한 지불 제안의 경우 x402 TVM 대비 노트를 사용하여 의도적인 서명, 가스, 제트톤 및 결제 지원이 존재할 때까지 지원되지 않는 TVM 요구 사항이 안전하게 실패하는지 확인하세요.

• x402 MCP 자금 조달 UX. 호스팅 자금 링크 및 관리형 지갑 비교의 경우 x402 MCP 자금 조달 UX 벤치마크를 사용하여 온보딩 속도를 승인 게이트, 일일 한도, 감사 가능성 및 비수탁 제어와 분리하세요.

• 디렉토리 인트로스펙션 대비. Glama, Smithery 및 기타 MCP 카탈로그의 경우 디렉토리 인트로스펙션 대비 노트를 사용하여 검증된 npx, Docker, MCP 이름 및 비수탁 메타데이터 경로를 확인하세요.

• x402 v2.11 유료 MCP 호환성. Payment-Signature, payment-response, mcp-session-id, CORS 노출 헤더, Streamable HTTP 초기화 순서, 영수증 링크 및 Base Sepolia에서 Base 메인넷 전환에 대해서는 호환성 증명을 사용하세요.

• 디렉토리 등급 메타데이터 증명. 카탈로그 크롤러 및 구매자 에이전트를 위해 레지스트리/목록 증명, docs/mcp-registry-listing.json, glama.json, smithery.yaml 및 llms.txt를 사용하세요.

• 체인 중립적 x402 게이트웨이 프로필. 비-EVM 검색에 Base 전용 가정을 노출하지 않고 지원되는 네트워크, 파시리테이터/결제 메타데이터, 평가판/환불 정책 및 디렉토리 매니페스트를 문서화하려면 체인 중립적 게이트웨이 프로필 증명, 스키마 및 픽스처를 사용하세요.

• 멀티 원장 x402 영수증 정규화. 서명 전에 원장 레이블, 자산, 결제 대상, Payment-Signature, payment-response, 확인 상태, 비수탁 경계 및 지원되지 않는 원장 거부를 정규화하려면 멀티 원장 영수증 정규화 증명, 스키마 및 XRPL 픽스처를 사용하세요.

• 지갑 작업 사전 비행 프로필. 되돌릴 수 없는 전송, 스왑 또는 리소스 구매 전에 시뮬레이션, 체인/리소스 한도, 허용 목록, 수신자 및 금액 확인, 논스 안내 및 승인 사본을 요구하려면 지갑 작업 사전 비행 프로필 및 TRON 픽스처를 사용하세요.

• 기계 지불 디렉토리 목록 팩. 지원되지 않는 비 EVM 서명을 주장하지 않고 MPP 및 유료 MCP 디렉토리를 위해 디렉토리 목록 팩 및 목록 JSON을 사용하세요.

• 5가지 도구 x402 패리티 증명. 검색, 확인, 가져오기, 지갑 및 지불 흐름을 AgentPay의 로컬 서명자, 승인 게이트 제어에 매핑하려면 5가지 도구 패리티 증명 및 기계 판독 가능 맵을 사용하세요.

• 에스크로 및 평판 경계. x402 지불 승인을 작업 에스크로, 신원, 평판 및 작업 증명과 분리하려면 에스크로/평판 경계 증명을 사용하세요.

• 유료 MCP 프록시 및 검색 대비. Toolstem/Cinderwright 스타일 프록시 및 디렉토리 제출을 위해 유료 프록시 및 검색 대비 팩과 목록 JSON을 사용하세요.

• 동적 유료 MCP 매니페스트 드리프트. 구매자 에이전트가 서명하기 전에 새로운 .well-known/x402 스냅샷, 오래된 메타데이터 경고, 평가판/가격 명확성, 지원되는 네트워크 및 디렉토리 엔드포인트 최신성을 검증하려면 동적 매니페스트 드리프트 증명, 스키마 및 Rug Munch 픽스처를 사용하세요.

• Smithery 유료 MCP 설치. Smithery CLI, Vercel AI SDK MCP, @smithery/api, 승인 게이트, 지출 한도 기본값 및 새로운 x402 매니페스트 검사를 위해 Smithery 설치 증명 및 examples/smithery-paid-mcp-installation을 사용하세요. 목록이 확인될 때까지 라이브 Smithery 검증을 주장하지 마십시오.

• x402 네이티브 대 Stripe 프록시 MCP. AgentPay MCP를 새로운 Stripe 프록시 MCP 저장소와 비교하는 빌더의 경우 x402 네이티브 대 Stripe 프록시 노트를 사용하여 승인 게이트, 지출 한도, 감사 행 및 비수탁 서명을 프록시 청구 주장과 분리하세요.

• 호스팅 x402 프록시 확인. 에이전트가 호스팅 x402 MCP 게이트웨이에 비용을 지불하기 전에 호스팅 x402 프록시 구매자 체크리스트를 사용하여 payment-required 헤더, 0이 아닌 payTo, 네트워크 및 자산 허용 목록, 승인 상태, 지출 한도, 감사 상관 관계 및 풀링된 토큰 잠금을 확인하세요.

• 유료 MCP 검색 및 예산 대응. SettleGrid 스타일 검색, 계량 및 예산 플랫폼 비교를 위해 유료 MCP 검색 및 예산 대응을 사용하여 디렉토리 검색을 x402 구매자 승인과 분리하세요.

• 원클릭 x402 도구에 대한 구매자 흐름 패리티. AgentScore Pay 스타일 구매자 CLI 비교를 위해 AgentPay 구매자 흐름 패리티 체크리스트를 사용하여 서명 전에 검색, 확인, 드라이런, 지불, 지출 한도, 유형화된 지불 오류, 할당량 봉투, 무료 실패, 멱등성, MCP 노출 및 감사를 입증하세요.

• 유료 MCP 게이트웨이 강화. create-mcpay 스타일 Worker 스캐폴드의 경우 유료 MCP 게이트웨이 강화 체크리스트를 사용하여 가입, 챌린지 구문 분석, 키 발급, 원자적 청구, 범위 기본값, 무료 검증 실패 및 구매자 감사 행을 테스트하세요.

• 유료 제공업체 상태 증명. Voidly 스타일 공용 제공업체 상태 피드의 경우 유료 제공업체 상태 증명 체크리스트를 사용하여 서명 전에 제공업체 성공률, 부실 기간, 영수증 상태, x402 네트워크, 자산, payTo 및 실패-폐쇄 라우팅을 확인하세요.

• 유료 도구 품질 임계값. Strale 스타일 점수 카탈로그의 경우 유료 도구 품질 임계값 증명을 사용하여 x402 서명 전에 새로운 점수 필드, 오래된 점수 경고, 제공업체 상태 스냅샷, 최소 품질 거부 및 승인 게이트를 확인하세요.

• 공인된 사이버 보안 검사. AgentAegis 스타일 유료 보안 도구의 경우 공인된 사이버 보안 검사 지불 프로필을 사용하여 대상 권한 부여, 허용 도메인 바인딩, 대상별 지출 한도, 검사 속도 정책, 승인 프롬프트 및 감사 영수증 언어를 요구하세요.

• 양자 내성 지출 봉투 호환성. PQSafe 스타일 구매자 질문의 경우 양자 내성 지출 봉투 호환성 평가를 사용하여 ML-DSA 구현을 주장하지 않고 지출 한도, 허용 목록, x402 영수증, 승인 게이트 및 감사 메타데이터를 매핑하세요.

• 지불 중요 의존성 고정. x402 검증기 및 서명 경로의 경우 AgentPay는 viem을 정확히 2.52.2로 고정하고 동일한 루트 재정의를 적용하며 릴리스 전에 클린 설치 스모크 검사를 실행합니다. 의존성 고정 정책을 참조하세요.

• WhatsApp 및 SMB 에이전트 제어. 채널 기본 유료 에이전트의 경우 WhatsApp 및 SMB 유료 에이전트 제어 레시피를 사용하세요.

• 채널 에이전트 제휴 지불금 제어. Axon 스타일 제휴 및 추천 수익 공유의 경우 채널 에이전트 제휴 제어 사양을 사용하여 지불 한도, 연락처별 승인, 감사 행 및 선택적 x402 결제를 유료 도구 지출 승인과 분리하세요.

• x402 체인 드리프트. AgentPay MCP는 x402 재단 페이월 템플릿 기준을 viem 2.52.2로 정확히 추적하고 매핑되지 않은 체인에 대해서는 안전하게 실패합니다. PaymentWrapper 및 페이월 템플릿 변경 사항은 x402 체인 드리프트 호환성 노트를 따르세요.

보안 팀이 LiteLLM 사고 이후 MCP 서버 의존성을 감사하는 경우, agentpay-mcp에서 npm ls를 실행하면 Python 공급망 노출이 전혀 없는 짧고 검토 가능한 트리를 얻을 수 있습니다.

신뢰 및 거버넌스 — A2A 프로토콜 정렬

Google의 Agent2Agent(A2A) 프로토콜(v1.0.0)은 에이전트가 조직 경계를 넘어 서로를 발견하고 인증하며 협업하는 방법을 정의합니다. 이 사양은 에이전트 카드, 보안 체계 및 인간 개입 작업 관리를 중심으로 구축되었지만 프로토콜 수준에서 지출 거버넌스를 정의하지는 않습니다.

agentpay-mcp는 이를 보완하는 거버넌스 계층으로서 그 격차를 메웁니다. 당사의 제어가 A2A 아키텍처에 매핑되는 방식은 다음과 같습니다.

실제 의미

유료 API 호출을 수반하는 작업에서 두 A2A 호환 에이전트가 협업하는 경우:

1. 검색(Discovery) — 호출 에이전트가 원격 에이전트의 에이전트 카드(A2A 사양)를 읽음

2. 인증(Authentication) — 선언된 보안 체계를 통한 상호 인증(A2A 사양)

3. 지출 거버넌스(Spend governance) — agentpay-mcp가 예산 상한을 적용하고, 거래를 기록하며, 고액 결제는 인간 승인에 따라 게이트(agentpay-mcp 레이어)

4. 감사(Audit) — 완전한 온체인 거래 추적을 통해 어느 에이전트의 내부 상태와 무관하게 규정 준수 증거 제공

이를 통해 agentpay-mcp는 A2A 호환 에이전트 생태계를 위한 지출 거버넌스 레이어로 자리매김합니다. — 프로토콜의 신원 및 작업 관리를 보완하여 기업이 자율 에이전트를 배포하기 전에 요구하는 재무 통제를 제공합니다.

참고: A2A v1.0.0 사양은 프로토콜 수준에서 신뢰 점수 또는 신뢰 신호 메커니즘을 정의하지 않습니다. agentpay-mcp의 거버넌스 제어(지출 상한, 인간 승인, 온체인 감사 추적)는 A2A 생태계가 발전함에 따라 향후 신뢰 관련 확장과 호환되도록 설계되었습니다.

AI 에이전트 검색

AgentPay MCP는 AI 에이전트가 검색하고 사용할 수 있도록 설계되었습니다. 호환 대상:

• claude-mem - 결제 상태(거래 내역, 예산, 세션 토큰)가 claude-mem의 관찰 레이어를 통해 세션 간 에이전트 메모리로 유지됨

• AgentSkills - AgentSkills 호환 하니스(Claude Code, Cursor, Gemini CLI, Antigravity)에 크로스 프레임워크 스킬로 설치 가능

• Chrome DevTools MCP - 브라우저 네이티브 에이전트를 위한 결제 레이어로 페어링

스킬로 설치

MCP 호환 하니스 구성에 추가:

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["agentpay-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0x...",
        "AGENT_WALLET_ADDRESS": "0x..."
      }
    }
  }
}

Claude Code, Cursor, Gemini CLI, OpenClaw, Windsurf 및 모든 MCP 클라이언트에서 작동합니다.

402 흐름 — 실제로 수행하는 작업

Agent calls a paid API
        │
        ▼
   HTTP 402 ←── "Payment required: 0.50 USDC on Base"
        │
        ▼
AgentPay MCP evaluates your policy:
  • Is 0.50 USDC under your per-tx cap?  ($5 limit → ✅)
  • Is this recipient allowlisted?        (api.example.com → ✅)
  • Require human approval?              (under $1 threshold → auto)
        │
        ▼
  Payment sent → API retried with payment proof → 200 OK
        │
        ▼
Agent gets the data. Full tx on basescan.org.

agentpay-mcp vs x402-mcp — 차이점

두 프로젝트 모두 에이전트 결제를 지원합니다. 서로 다른 계층의 서로 다른 문제를 해결합니다.

x402-mcp를 사용해야 하는 경우: 거버넌스 요구 사항 없이 가장 간단한 x402 결제 통합을 원하는 경우. 에이전트가 무제한 예산 권한으로 작동합니다.

agentpay-mcp를 사용해야 하는 경우: 지출 통제, 예산 강제, 인간 승인 워크플로 또는 멀티 프로토콜 지원이 필요한 경우. 에이전트가 실제 기업 예산으로 작동하며 통제되지 않은 지출이 배포를 막는 상황입니다.

x402-mcp는 에이전트에 결제를 추가합니다. agentpay-mcp는 통제된 결제를 추가합니다 — 기업이 프로덕션 예산에 에이전트를 배포하기 전에 요구하는 지출 상한, 세션 한도, 인간 승인, 감사 추적을 제공합니다.

FAQ: x402 네이티브 AgentPay MCP vs Stripe 프록시 MCP

공개 MCP 결제 저장소에서 검색을 위해 x402 + Stripe Agent라는 표현을 사용하기 시작했습니다. 이를 모든 프록시가 완전한 지출 통제를 제공한다는 증거가 아닌 시장 신호로 간주하십시오.

주요 차이점은 무엇인가요?

AgentPay MCP는 결제 결정을 에이전트의 정책 경계 내에서 유지합니다. 에이전트가 x402_pay를 요청하면 AgentPay는 서명 전에 승인 상태와 지출 정책을 확인하고, 감사 추적에는 도구, 금액, 판매자, 영수증, 정책 결과가 기록됩니다. Stripe 프록시 패턴은 일반적으로 다운스트림 서비스 앞에 결제 또는 청구 프록시를 둡니다.

모든 유료 MCP 호출에 프록시를 사용하지 않는 이유는 무엇인가요?

프록시는 청구 및 계정 집계에 도움이 될 수 있습니다. 그러나 누가 지출을 승인했는지, 에이전트가 작업 예산 내에 머물렀는지, 정책 승인 전에 서명이 차단되었는지 여부를 자동으로 알려주지는 않습니다. AgentPay MCP는 결제 실행 전에 이러한 통제를 처리합니다.

디렉토리나 구매자가 오늘 확인할 수 있는 증거는 무엇인가요?

• npm: agentpay-mcp@4.1.9 이상

• Glama: https://glama.ai/mcp/servers/up2itnow0822/claw-pay-mcp

• 카탈로그 메타데이터: glama.json 및 smithery.yaml

• 설치 경로: npx 및 Docker

• 인트로스펙션: x402_pay, check_budget, set_spend_policy, otel_evaluate_spend를 포함한 27개의 MCP 도구

Lightning Wallet MCP와 어떻게 다른가요?

Lightning Wallet MCP는 Glama 배지 작업과 x402 폴백 포지셔닝을 갖춘 비트코인 지갑 MCP입니다. AgentPay MCP는 x402 결제 도구 거버넌스에 중점을 둡니다: 승인 게이트, 하드 지출 상한, 비수탁 로컬 서명, 디렉토리 메타데이터, 유료 도구 호출과 연결된 감사 행.

전체 체크리스트는 x402 네이티브 AgentPay MCP vs Stripe 프록시 MCP 패턴을 참조하십시오.

호스팅 유료 MCP 게이트웨이의 경우 서명 전에 호스팅 x402 프록시 구매자 검증 체크리스트를 사용하십시오. payment-required 헤더, payTo, 체인, 자산, 지출 상한, 승인 게이트, 감사 로그, 풀링 토큰 잠금을 확인합니다.

원커맨드 구매자 CLI 비교는 AgentPay 구매자 흐름 패리티 체크리스트를 사용하십시오. 검색, 확인, 드라이런, 결제, 지출 상한, 유형화된 결제 오류, 할당량 엔벨로프, 무료 실패, 멱등성, MCP 노출, 감사를 fail-closed 픽스처로 전환합니다. 유료 Worker 템플릿의 경우 스캐폴드를 프로덕션 준비 완료로 취급하기 전에 유료 MCP 게이트웨이 강화 체크리스트를 사용하십시오.

빠른 시작

1. 설치

npm install -g agentpay-mcp

2. Claude Desktop 구성

~/Library/Application Support/Claude/claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["agentpay-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0x...",
        "AGENT_WALLET_ADDRESS": "0x...",
        "CHAIN_ID": "8453"
      }
    }
  }
}

3. Cursor 구성

.cursor/mcp.json 또는 ~/.cursor/mcp.json에 추가:

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["agentpay-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0x...",
        "AGENT_WALLET_ADDRESS": "0x...",
        "CHAIN_ID": "8453"
      }
    }
  }
}

4. 지출 상한 설정

실행 중이면 에이전트에게 지시:

Set my spend policy: $1 per transaction, $10 per day, only send to allowlisted addresses.

또는 set_spend_policy를 직접 호출:

{
  "tool": "set_spend_policy",
  "arguments": {
    "perTxCapEth": "0.0004",
    "dailyLimitEth": "0.004",
    "allowedRecipients": ["0xapi-provider-address..."]
  }
}

이제 에이전트가 API 비용을 지불할 수 있으며, 지시 사항과 관계없이 한 번에 $1, 하루에 $10 이상 지출할 수 없습니다.

인간 승인 모드(기본값)

기본적으로 자동 승인 임계값을 초과하는 거래는 인간 검토를 위해 대기합니다. 에이전트는 이를 우회할 수 없습니다.

$0.50 USDC request → under $1 threshold → auto-approved → paid → result returned
$5.00 USDC request → over $1 threshold → queued → you get notified → approve or reject

대기 중인 결제를 승인하려면:

{
  "tool": "queue_approval",
  "arguments": {
    "action": "approve",
    "tx_id": "0x..."
  }
}

거부하려면:

{
  "tool": "queue_approval",
  "arguments": {
    "action": "cancel",
    "tx_id": "0x..."
  }
}

에이전트는 결과를 확인하고 다음에 수행할 작업(캐시된 데이터 사용, 사용자에게 문의, 중단)을 결정합니다.

가치 팩 — 세 가지 프로덕션 워크플로 패턴

1. 유료 API 에이전트

기능: 데이터 요구에 맞는 유료 API를 찾아 한 번 결제하고 결과를 캐시합니다.

사용 시기: 에이전트가 데이터(시장 데이터, 인리치먼트, 지오코딩)가 필요하고 402 오류로 실패하는 대신 결제를 자동으로 처리하도록 하려는 경우.

Agent: "I need current options flow data for AAPL"
  │
  ├─ Tries free sources → insufficient data
  ├─ Finds paid API → gets 402 for $0.25 USDC
  ├─ Checks: $0.25 < $1 cap → auto-approved
  ├─ Pays with x402_pay → gets data
  ├─ Caches result at ~/.clawpowers/state/market:AAPL:options
  └─ Returns data + payment receipt

사용 도구: x402_pay, check_spend_limit, get_transaction_history

예시 교환:

User: Get me the options flow for AAPL for the last 7 days.

Agent: Checking free sources... insufficient. Found paid API at data.example.com.
Cost: $0.25 USDC (under your $1 auto-approve cap). Paying now.
[x402_pay → 200 OK, paid 0.25 USDC, tx: 0xabc...]
Here's the options flow data: [results]
Total cost today: $0.25 of your $10 daily budget.

2. 리서치 에이전트

기능: 먼저 무료 소스에서 수집하고, 유료 데이터로 공백을 채우고, 구조화된 출력을 컴파일합니다.

사용 시기: 포괄적인 리서치 보고서가 필요하고 무료 데이터가 정말 부족한 경우에만 에이전트가 비용을 지출하도록 하려는 경우.

Agent: "Research competitive landscape for real-time flight tracking APIs"
  │
  ├─ Scrapes free sources (GitHub, HN, docs) → baseline data
  ├─ Identifies gaps: pricing data, SLA guarantees, enterprise contacts
  ├─ Proposes paid lookups totaling $2.75 USDC → presents for approval
  ├─ Human approves
  ├─ Pays for Apollo contact enrichment ($1.50) + Crunchbase data ($1.25)
  └─ Compiles: free data + paid data → structured report

사용 도구: x402_pay, x402_session_start, x402_session_fetch, check_budget

예시 교환:

User: Research the real-time flight tracking API market. Budget up to $5.

Agent: Starting with free sources... [scrapes 12 sources, builds baseline]
Gaps identified:
  - Vendor pricing (not public for 3 of 5 vendors)
  - Contact info for enterprise sales at FlightAware
  - Recent funding data for two startups

To fill these I'd spend ~$2.75 USDC:
  - Apollo contact enrichment: $1.50
  - Crunchbase firmographics: $1.25

Approve? (y/n)

User: y

Agent: [pays, fetches, compiles]
Report ready. Spent $2.75 of your $5 budget. [structured report attached]

3. 자동화 에이전트

기능: 필요한 서비스 비용을 지불하면서 실제 작업을 종단 간 완료합니다.

사용 시기: 에이전트가 실제로 작업을 완료(통화 예약, 인리치먼트 파이프라인 실행, 배포)하도록 하려는 경우 — 리서치만이 아닌.

Agent: "Enrich this list of 50 leads and add to CRM"
  │
  ├─ Processes first 10 free (from existing data)
  ├─ Remaining 40 need enrichment → $0.10/contact = $4.00 USDC
  ├─ Presents plan: 40 contacts × $0.10 = $4.00 total → user approves
  ├─ Runs enrichment in batches of 10 (staying under per-tx cap)
  ├─ Writes enriched data to CRM via API
  └─ Reports: 50 leads enriched, $4.00 spent, 47 successful

사용 도구: x402_pay, x402_session_start, set_spend_policy, get_transaction_history

엔터프라이즈 FinOps — 예산 상한 템플릿

프로덕션 에이전트 배포에는 엔터프라이즈 FinOps 요구 사항을 충족하는 지출 거버넌스가 필요합니다. 이 템플릿은 인프라 계층에서 에이전트 지출을 제어하는 일반적인 패턴을 보여줍니다.

에이전트별 부서 예산

// Marketing agent — $50/day cap, restricted to approved data vendors
{
  "tool": "set_spend_policy",
  "arguments": {
    "perTxCapEth": "0.02",
    "dailyLimitEth": "0.02",
    "allowedRecipients": ["0xmarketingVendor1...", "0xmarketingVendor2..."]
  }
}

// Engineering agent — $200/day cap, broader vendor access
{
  "tool": "set_spend_policy",
  "arguments": {
    "perTxCapEth": "0.04",
    "dailyLimitEth": "0.08",
    "allowedRecipients": ["0xcloudProvider...", "0xapiVendor...", "0xdataSource..."]
  }
}

계층형 승인 임계값

조직의 승인 매트릭스를 에이전트 지출 등급에 매핑하세요:

$0 - $1      -> auto-approved (routine API calls)
$1 - $25     -> auto-approved with logging (standard tool usage)
$25 - $100   -> queued for team lead approval via queue_approval
$100+        -> queued for finance team approval

set_spend_policy로 자동 승인 상한을 설정하세요(MCP 서버에서 적용되는 프로세스 내 상한). 온체인 AgentAccountV2 한도(계약에서 지갑 소유자가 구성)를 초과하는 거래는 스마트 계약 자체를 통해 인간 검토 대기열에 들어갑니다.

FinOps 대시보드를 위한 예산 모니터링

FinOps 도구를 위한 실시간 지출 데이터를 가져오세요:

// Check remaining budget before starting expensive workflows
{ "tool": "check_budget", "arguments": {} }
// Returns: { "remaining": "142.50 USDC", "spent": "57.50 USDC", "limit": "200.00 USDC" }

// Pull transaction history for cost attribution
{ "tool": "get_transaction_history", "arguments": { "limit": 100 } }
// Each entry includes: merchant, amount, timestamp, tool context — ready for FinOps import

이 패턴은 모든 FinOps 플랫폼(CloudHealth, Kubecost, Apptio)과 함께 작동합니다. MCP 도구를 통해 거래 내역을 내보내고 기존 비용 귀속 파이프라인에 공급하세요.

환경 변수

# Required
AGENT_PRIVATE_KEY=0x...          # Agent hot wallet key (0x-prefixed hex)
AGENT_WALLET_ADDRESS=0x...       # Deployed AgentAccountV2 contract address

# Optional
CHAIN_ID=8453                    # 8453 = Base Mainnet (default, recommended)
RPC_URL=https://mainnet.base.org # Custom RPC (Alchemy/Infura recommended for production)
SESSION_TTL_SECONDS=3600         # x402 session lifetime (default: 1 hour)
FACTORY_ADDRESS=0x...            # For deploy_wallet and create_escrow
NFT_CONTRACT_ADDRESS=0x...       # For deploy_wallet

# Optional — otel_register_budget_policy circuit breaker
# Comma-separated hosts whose private/loopback/link-local kill-callback URL is
# explicitly permitted. Empty by default: a killCallbackUrl pointing into
# private space is dropped (with a warning) and never POSTed to, though the
# budget policy's spend cap is always registered and enforced regardless.
# Set this only if your circuit-breaker webhook genuinely lives in-VPC.
AGENTPAY_KILL_CALLBACK_ALLOWED_HOSTS=orchestrator.svc.internal

Kill-callback SSRF 제한. killCallbackUrl은 http(s)여야 하며, 자격 증명을 포함해서는 안 되고, 사설, 루프백, 링크-로컬 또는 기타 전역 라우팅 불가 주소(RFC1918, CGNAT, 멀티캐스트, 예약, IETF 프로토콜 할당, 벤치마킹 및 문서 범위, IPv6 등가물 및 모든 IPv4-in-IPv6 전환 형태)를 지정해서는 안 됩니다. 호스트 이름은 콜백이 실행되기 직전에 동일한 규칙에 대해 확인되고 다시 검사됩니다. DNS 확인과 POST를 함께 포함하는 단일 고정 10초 데드라인이 있으므로 응답하지 않는 리졸버는 스팬 평가를 열어둘 수 없습니다.

하나의 간격은 닫히지 않았습니다: 연결은 검증된 주소에 고정되지 않으므로, 확인 시 공용 주소로 응답하고 연결 시 사설 주소로 응답하는 리졸버(DNS 리바인딩)에 여전히 도달할 수 있습니다. 이를 닫으려면 이 호출을 전역 fetch에서 고정된 lookup을 사용하는 node:http/node:https로 이동해야 하며, 이는 별도로 추적됩니다. 오늘 하드 보장이 필요하다면 웹훅 앞에 네트워크 수준의 이그레스 허용 목록을 두세요. 전달되지 않은 콜백은 단일 일반 이유와 함께 ok=false만 보고합니다. HTTP 상태와 특정 실패는 호출자에게 반환되지 않으며, 서버 측에서만 기록됩니다(출처만, 콜백 경로나 쿼리는 기록하지 않음).

전체 23개 도구

결제 및 402 흐름

지갑 및 지출 제어

토큰 작업

DeFi

신원 및 신뢰

주요 도구 예시

x402_pay — 핵심 도구

// Request
{
  "tool": "x402_pay",
  "arguments": {
    "url": "https://api.example.com/premium-data",
    "max_payment_eth": "0.0002"
  }
}

// Response
{ "status": 200, "body": "{ ... }" }

비용이 max_payment_eth를 초과하면 도구는 지불 전에 오류를 반환합니다 — 예상치 못한 요금 없음.

x402_session_start — 여러 호출에 대해 한 번 지불

// Request
{
  "tool": "x402_session_start",
  "arguments": {
    "endpoint": "https://api.example.com/",
    "ttl_seconds": 3600,
    "label": "market-data-session"
  }
}

// Response
{ "session_id": "sess_abc123", "token": "eyJ...", "expires_at": 1741000000 }

// Subsequent calls — no new payment
{
  "tool": "x402_session_fetch",
  "arguments": {
    "url": "https://api.example.com/stocks/AAPL",
    "session_id": "sess_abc123"
  }
}

check_budget — 루프 전에 알기

// Request — check before starting an expensive loop
{ "tool": "check_budget", "arguments": {} }

// Response
{
  "remaining": "7.50 USDC",
  "spent": "2.50 USDC",
  "limit": "10.00 USDC",
  "periodEnds": "2026-03-24T00:00:00Z"
}

지원 체인

보안 모델

비수탁: 에이전트는 개인 키로 모든 거래를 로컬에서 서명합니다. 제3자가 키를 보유하거나 검증하지 않습니다.

온체인 강제 (AgentAccountV2 한도, 계약에서 지갑 소유자가 구성):

• 거래당 상한 — 상한 초과 거래는 queue_approval을 통해 인간 승인 대기열에 들어감

• 일일 기간 한도 — AgentAccountV2 스마트 계약에 의해 집계 지출 강제

프로세스 내 정책 (set_spend_policy — MCP 서버에서 적용, 온체인 아님):

• 수신자 허용 목록, 거래당 상한, 일일 한도 — 편의 가드레일, 손상된 서버 프로세스에 의해 우회 가능. 정확한 제어 경계는 docs/security-posture.md 참조.

역할 분리:
에이전트의 서명 키(AGENT_PRIVATE_KEY)는 지갑 소유자가 설정한 한도 내에서만 거래할 수 있습니다. 에이전트의 키가 유출되거나 에이전트가 손상되어도 공격자는 다음 재설정 전까지 구성된 상한까지만 지출할 수 있습니다.

x402 세션:
세션 토큰은 ECDSA 서명된 클레임입니다. 모든 x402 V2 서버는 중앙 세션 저장소 없이 독립적으로 검증할 수 있습니다.

최소 종속성 풋프린트:
AgentPay MCP는 LiteLLM 종속성이 전혀 없습니다. 전체 서버는 viem(이더리움 클라이언트), @modelcontextprotocol/sdk, 그리고 감사 가능한 몇 개의 패키지로 실행됩니다 — 종속성 트리에 무거운 LLM 라우팅 계층이 없습니다. 이것은 중요합니다: 2026년 3월 24일, PyPI의 LiteLLM 버전 1.82.7 및 1.82.8이 AI 에이전트 인프라를 대상으로 한 공급망 공격에서 확인된 손상되었습니다. LiteLLM에 (직접 또는 간접적으로) 의존하는 모든 MCP 서버는 노출되었습니다. AgentPay MCP는 그렇지 않았습니다 — 결제 인프라는 가능한 가장 작은 공격 표면을 가져야 하기 때문입니다.

agentpay-mcp는 이미 여러 결제 레일을 지원합니다

에이전트 결제 환경은 방금 분할되었습니다: Coinbase의 x402(개방형, 무허가, 온체인) vs Stripe의 MPP(허가형, Tempo 기반, USDC). 프로덕션 에이전트를 구축하는 개발자는 선택에 직면합니다 — 또는 이미 둘 위에 있는 agentpay-mcp를 사용합니다.

agentpay-mcp는 설계상 프로토콜에 구애받지 않습니다:

이것이 중요한 이유: x402도 MPP도 지출 거버넌스를 제공하지 않습니다. x402 지갑은 기본적으로 무제한입니다. MPP는 인간이 설정한 대시보드 한도를 제공하지만 프로그래밍 방식의 세션별 또는 작업별 강제는 없습니다. agentpay-mcp는 거래를 결제하는 레일과 관계없이 둘 위에 예산 회로 차단기, 승인 워크플로 및 감사 추적을 제공합니다.

이것은 하나의 프로토콜을 감싸는 래퍼가 아닙니다. 정책(누가 승인했는지, 예산이 무엇인지, 인간이 검토해야 하는지)과 결제(어떤 블록체인 또는 결제 네트워크가 돈을 이동하는지) 사이에 의도적인 분리가 있는 거버넌스 계층입니다. 이 분리가 agentpay-mcp를 레일 중립적으로 만드는 것입니다 — 그리고 프로토콜 전쟁이 진행됨에 따라 거버넌스 표준으로 자리매김하게 합니다.

AWS AgentCore와 함께 작동

AWS AgentCore는 Cedar 기반 정책 적용을 통한 액세스 제어로 엔터프라이즈급 에이전트 호스팅을 제공합니다. Cedar 정책은 "이 에이전트가 이 API를 호출할 수 있는가?"와 "이 에이전트가 이 리소스에 액세스할 수 있는가?"에 답합니다.

Cedar가 제공하지 않는 것: 지출 한도. "이 에이전트가 세션당 최대 $50를 지출할 수 있다" 또는 "오늘 누적 지출이 $200를 초과하면 에이전트를 중지"에 대한 Cedar 기본 요소는 없습니다. 액세스 제어와 예산 거버넌스는 다른 문제입니다.

agentpay-mcp는 AgentCore 위에 예산 회로 차단기를 추가합니다:

배포 패턴: AgentCore는 Cedar 정책으로 도구 액세스를 제어하면서 에이전트를 실행합니다. agentpay-mcp는 에이전트의 도구 세트 내에서 MCP 서버로 실행되어 모든 결제 작업에 지출 상한을 적용합니다. Cedar는 "이 유료 API를 호출할 수 있습니다"라고 말합니다. agentpay-mcp는 "이 호출에 최대 $5를 지출할 수 있습니다"라고 말합니다.

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["agentpay-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0x...",
        "AGENT_WALLET_ADDRESS": "0x...",
        "MAX_TRANSACTION_USDC": "5.00",
        "DAILY_LIMIT_USDC": "50.00"
      }
    }
  }
}

AgentCore에서 에이전트를 실행하는 기업의 경우: Cedar는 "할 수 있는가?" 질문을 처리합니다. agentpay-mcp는 "이만큼 지출해야 하는가?" 질문을 처리합니다. 함께, 프로덕션 에이전트 배포에 필요한 액세스 + 예산 거버넌스 스택을 제공합니다.

경쟁 포지셔닝

가장 간단한 이해 방법: ACP(Stripe)는 에이전트가 판매하는 것을 처리하고, agentpay-mcp는 에이전트가 구매하는 것을 처리합니다.

Stripe MCP vs agentpay-mcp

개발자들은 자주 묻습니다: "Stripe MCP가 이미 에이전트 결제를 처리하지 않나요?" 답은 서로 다른 계층에서 서로 다른 문제를 해결한다는 것입니다.

Stripe MCP는 판매자 도구입니다. 기업이 에이전트 인터페이스를 통해 고객에게 청구할 수 있게 해줍니다. "이 제품 구매" 또는 "해당 플랜 구독"을 생각하면 됩니다.

agentpay-mcp는 에이전트 조달 도구입니다. 에이전트가 작업을 수행하는 데 필요한 API와 도구 비용을 지불할 수 있게 해줍니다. "프리미엄 데이터 엔드포인트에 액세스" 또는 "이 컴퓨팅 리소스 사용"을 생각하면 됩니다.

대부분의 프로덕션 에이전트는 두 계층이 모두 필요합니다. 사용자 대상 상거래에는 Stripe MCP, 에이전트 자체 도구 비용에는 agentpay-mcp입니다. 이 둘은 경쟁 관계가 아니라 보완 관계입니다.

MCP 2026 준수

AgentPay MCP는 CoSAI(Coalition for Secure AI) 위협 범주 및 OAuth 2.1 요구 사항을 포함하여 2026년에 부상하는 MCP 보안 표준에 부합합니다.

보안 태세 문서: 전체 준수 매트릭스는 docs/security-posture.md를 참조하세요. 포함 내용:

• CoSAI T9 (Financial Fraud) — 계층형 지출 통제: 인프로세스 지출 정책(set_spend_policy, MCP 서버 프로세스에서 적용 — 온체인 아님)과 지갑 소유자가 구성하는 온체인 AgentAccountV2 한도 및 승인 대기열

• CoSAI T10 (Identity Spoofing) — ERC-8004 에이전트 신원 검증 + 비수탁 키 관리를 통해 신원 기반 공격 방지

• OAuth 2.1 + PKCE — MCP 서버 인증은 엔터프라이즈 SSO 통합(Azure AD, Okta)을 위해 PKCE가 포함된 OAuth 2.1을 지원

• 감사 로깅 — get_transaction_history를 통한 온체인 AgentAccountV2 이벤트 기록(실행, 대기 중인 트랜잭션, 승인, 정책 업데이트). 도구 호출별 로그는 없음 — 정확히 무엇이 기록되고 기록되지 않는지는 보안 태세 문서 참조

MCP 서버를 평가하는 엔터프라이즈 보안 팀을 위해: 보안 태세 문서는 감사 프로세스에 필요한 산출물을 제공합니다.

아키텍처

┌─────────────────────────────────────────┐
│  AI Agent (Claude / Cursor / Windsurf)  │
└────────────────┬────────────────────────┘
                 │  MCP (stdio / SSE)
┌────────────────▼────────────────────────┐
│           AgentPay MCP Server           │
│  ┌────────────┐  ┌────────────────────┐ │
│  │  23 Tools  │  │  Session Manager   │ │
│  └─────┬──────┘  └────────────────────┘ │
│        │                                │
│  ┌─────▼──────────────────────────────┐ │
│  │       agentwallet-sdk v6.0.0       │ │
│  │  TokenRegistry  SwapModule         │ │
│  │  BridgeModule   ERC8004Client      │ │
│  └─────┬──────────────────────────────┘ │
└────────┼────────────────────────────────┘
         │  viem + RPC
┌────────▼────────────────────────────────┐
│  AgentAccountV2 Smart Contract          │
│  SpendingPolicy  ·  Tx Queue            │
│  (12 chains — Base, ETH, ARB, OP, ...)  │
└─────────────────────────────────────────┘

전송: 기본값은 stdio(Claude Desktop, Cursor, Windsurf). 원격 배포에는 SSE 사용 가능.

기여

git clone https://github.com/up2itnow0822/agentpay-mcp
cd agentpay-mcp
npm install
npm run build
npm test

특허 고지

특허 출원 중 — 2026년 3월 출원된 USPTO 가출원: "Non-Custodial Multi-Chain Financial Infrastructure System for Autonomous AI Agents."

우리는 개방형 x402 표준을 지원합니다. 이번 출원은 방어적 목적입니다. 개방형 결제 레일의 적대적 독점을 방지하기 위한 것이지, 개방형 표준을 사용하는 개발자를 제한하기 위한 것이 아닙니다.

Vercel x402-mcp 상호운용

agentpay-mcp는 Vercel의 x402-mcp 패키지와 완벽하게 호환됩니다. Vercel의 paidTool()을 사용하여 MCP 도구를 수익화하는 경우, agentpay-mcp는 클라이언트 측 결제 레이어로 작동합니다. 에이전트가 x402_pay를 통해 paidTool() 엔드포인트의 x402 인보이스를 자동으로 결제합니다.

agentpay-mcp가 x402-mcp 위에 추가하는 기능:

• 다중 레일 결제 — 판매자에 따라 x402(온체인 USDC) 또는 Stripe Machine Payments Protocol(법정화폐)을 통해 라우팅

• 지출 거버넌스 — paidTool() 엔드포인트가 클라이언트 측에서 강제하지 않는 트랜잭션별 상한, 일일 한도, 인간 승인 대기열

• 멀티체인 x402 v2 — Base, Solana 또는 Polygon에서 결제(x402 v2는 세 네트워크 모두 기본 지원)

서버 측에서는 Vercel x402-mcp를 사용하여 도구를 수익화하세요. 클라이언트 측에서는 agentpay-mcp를 사용하여 안전하게 도구 비용을 지불하세요.

Circle Nanopayments — 제로 가스 정산

agentpay-mcp는 x402 v2 결제의 정산 옵션으로 Circle Nanopayments를 지원합니다. Nanopayments는 소액 결제를 단일 온체인 정산으로 일괄 처리하여 가스 없는 1센트 미만 USDC 전송을 가능하게 합니다.

agentpay-mcp와 함께 작동하는 방식:

• 에이전트가 평소처럼 x402_pay를 통해 x402 결제를 수행합니다.

• x402 v2 서버가 Circle Nanopayments를 지원하면 정산이 가스 없이 이루어집니다.

• 1센트 미만 결제($0.001, $0.0001)는 API 호출별 과금에 경제적으로 viable해집니다.

• Circle의 Gateway를 통한 크로스체인 지원 — 모든 EVM 체인에서 작동합니다.

이는 가스 비용이 결제 금액을 초과할 수 있는 고빈도 에이전트 워크플로에서 특히 유용합니다. 프로토콜 세부 사항은 Circle의 발표를 참조하세요.

x402 생태계 — 7,500만+ 트랜잭션, Cloudflare 기본 지원

agentpay-mcp는 x402 HTTP 결제 표준을 기반으로 구축되었으며, 현재 Base 메인넷에서 7,500만 건 이상의 트랜잭션을 처리했습니다. 주로 Coinbase Agentic Wallets와 개발자 통합을 통해 이루어졌습니다.

Cloudflare는 Agents SDK 및 MCP 서버 런타임에 네이티브 x402 지원을 추가했습니다. 즉, Cloudflare Worker에서 호스팅되는 모든 에이전트가 이제 기본적으로 x402 결제를 수행할 수 있습니다. Google, Circle, Stripe는 모두 x402를 자사 에이전트 생태계에 적극적으로 통합하고 있습니다.

agentpay-mcp는 이 인프라 위에 위치한 오픈소스 거버넌스 레이어입니다. x402가 결제 프로토콜을 처리하는 동안, agentpay-mcp는 프로덕션 에이전트가 요구하는 신뢰 통제(HITL 승인 대기열, 지출 상한, 수신자 허용 목록, 온체인 감사 추적)를 추가합니다.

OpenAI Delegated Payment Spec 호환성

OpenAI는 AI 에이전트가 사용자를 대신하여 결제를 처리하는 방법을 정의하는 Delegated Payment Spec을 발표했습니다. 허용 한도가 있는 범위 제한 토큰(scoped token)으로, Stripe Scoped Payment Tokens(SPTs)와 호환됩니다. 이는 OpenAI Agents SDK의 네이티브 결제 도구의 전신 아키텍처입니다.

agentpay-mcp의 지출 상한 모델은 Delegated Payment Spec 패턴과 직접적으로 일치합니다:

핵심 패턴은 동일합니다: 인간이 예산을 승인 → 에이전트가 그 예산 내에서 실행 → 모든 활동이 감사 가능. 차이는 정산 레이어입니다. OpenAI의 스펙은 Stripe SPTs(법정화폐 레일)를 대상으로 하지만, agentpay-mcp는 온체인(Base, Arbitrum 및 기타 8개 EVM 체인의 USDC/ETH)으로 정산합니다.

온체인 정산이나 다중 레일 결제 실행이 필요한 OpenAI Agents SDK 워크플로를 구축하는 개발자에게 agentpay-mcp는 애플리케이션 수준의 신뢰가 아닌 온체인 강제력을 통해 Delegated Payment Spec 패턴을 구현하는 MCP 결제 도구 역할을 합니다.

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["agentpay-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0x...",
        "AGENT_WALLET_ADDRESS": "0x..."
      }
    }
  }
}

MCP 브리지를 통해 이 MCP 서버를 모든 OpenAI Agents SDK 워크플로에 추가하세요. 에이전트는 x402_pay, check_budget, set_spend_policy를 얻게 됩니다. 동일한 범위 제한 토큰 + 허용 한도 패턴입니다. set_spend_policy는 MCP 서버 프로세스에서 적용되며, 스마트 계약 강제력은 지갑 소유자가 계약에서 구성하는 온체인 AgentAccountV2 한도에서 비롯됩니다(docs/security-posture.md 참조).

Google AP2 호환성

agentpay-mcp는 Google의 Agent2Agent Payment(AP2) 프로토콜을 보완합니다. Visa, Mastercard, PayPal을 포함한 60개 이상의 조직이 지원하는 AP2는 에이전트 결제 *인가(authorization)*를 처리합니다. 즉, 결제 요청이 합법적인지 확인합니다. agentpay-mcp는 AP2 위의 거버넌스 레이어에서 작동하며, AP2가 의도적으로 범위 외(out-of-band)로 취급하는 에이전트별 예산 상한, 일일 지출 한도, 인간 승인 임계값을 추가합니다. 여러 결제 레일에서 에이전트를 배포하는 엔터프라이즈에게 agentpay-mcp는 어떤 개별 프로토콜도 제공하지 않는 통합 지출 거버넌스를 제공합니다.

EU AI Act 준수

시행 기한: 2026년 8월 2일. 금융 거래를 실행하거나 촉진하는 AI 시스템은 EU AI Act Annex III에 따라 **고위험(high-risk)**으로 분류됩니다. 고위험 분류에는 다음이 필요합니다:

• ✅ 인간 감독 메커니즘 — 의무적인 인간 검토 및 재정의(override) 기능

• ✅ 투명성 및 설명 가능성 — 감사 가능한 트랜잭션 기록

• ✅ 액세스 통제 — 에이전트가 우회할 수 없는 지출 한도

• ✅ 기술 문서 — 적합성 평가 지원

agentpay-mcp는 네 가지 요구 사항을 모두 기본으로 충족합니다:

결제와 관련된 에이전트 시스템을 배포하는 유럽 기업은 규정을 준수하는 인간 감독 및 감사 통제를 구현할 시간이 약 150일 남았습니다. agentpay-mcp는 MCP 호환 에이전트 배포를 위한 EU AI Act 준수의 가장 빠른 경로입니다.

미준수 시 벌금: 최대 €35M 또는 전 세계 연간 매출의 7%. 독일은 2026년 2월 국가 집행 법안을 공표했습니다.

라이선스

MIT © AI Agent Economy

AI Agent Economy 제작 — 프로덕션 에이전트 워크플로우를 위한 인프라.