MCP-Pay

Algorand 상의 HTTP x402 수익화 레이어로, AI 에이전트가 MCP 도구를 1센트 미만의 건별 과금(pay-per-call) 기준으로 결제할 수 있게 합니다.

Problem

Model Context Protocol(MCP)을 사용하는 자율 AI 에이전트는 유료 도구에 접근할 수 없습니다. 신용카드, API 키, 구독은 인간의 워크플로우이기 때문입니다. 도구 제작자는 호출별로 요금을 부과할 방법이 없으며, 기존 체인은 기계 간 마이크로결제에 너무 느리거나 비쌉니다.

Related MCP server: Agent Commerce Gateway

Solution

MCP-Pay는 모든 MCP 도구를 Algorand에서 즉시 수익화되는 x402 엔드포인트로 변환합니다.

1. 에이전트는 GET /mcp/v1/tools에서 도구를 발견합니다(무료, JSON 스키마 및 가격 포함).

2. 에이전트는 결제 없이 POST /mcp/v1/tools/:name/execute를 호출합니다.

3. 서버는 결제 메타데이터(USDC 가격, 수신자 주소, 네트워크)와 함께 402 Payment Required로 응답합니다.

4. 에이전트의 로컬 미들웨어가 Algorand USDC 전송(ASA 31566704)을 자동 서명하고 재시도합니다.

5. GoPlausible facilitator가 온체인에서 검증 및 정산하고(<3.3초 최종성), 도구가 실행되며, 결과가 한 번의 왕복(round-trip)으로 반환됩니다.

계정 없음. 키 없음. 인간 없음.

USP

Paid Tools Included

Architecture

┌────────────────────────┐
│   AI AGENT (client/)   │  1. GET /mcp/v1/tools      (discovery)
│  auto-paying MCP agent │  2. POST .../execute       → 402 challenge
└───────────┬────────────┘  3. sign USDC txn locally
            │               4. retry + X-PAYMENT header
            ▼
┌────────────────────────┐
│  MCP-PAY SERVER (Hono) │  x402 paymentMiddleware protects each tool route
│  registry + tools/*    │  executes tool only after verified settlement
└───────────┬────────────┘
            ▼
┌────────────────────────┐
│ GOPLAUSIBLE FACILITATOR│  /verify + /settle on Algorand TestNet
│  https://facilitator.  │  USDC (ASA 31566704) transfer
│  goplausible.xyz       │
└────────────────────────┘

Tech Stack

• TypeScript, Hono

• @x402/core, @x402/avm, @x402/hono, @x402/fetch

• @x402-avm/extensions (Bazaar 디스커버리)

• GoPlausible facilitator, Algorand TestNet USDC

Run Locally

1. 사전 요구 사항

• Node.js 18+, pnpm (npm i -g pnpm)

• 자금이 충전된 Algorand TestNet 계정 2개:

  • 서버 지갑(수신자): 주소만

  • 에이전트 지갑(지불자): 니모닉, 로컬에 보관 — 절대 커밋하지 않음

Lora 파우셋을 통해 자금을 충전하고, Lora에서 두 계정 모두 USDC에 옵트인한 다음, Circle 파우셋에서 TestNet USDC를 받으세요(Algorand Testnet 선택).

2. 구성

pnpm install
cp .env.example .env

.env를 작성하세요:

AVM_ADDRESS=<server wallet address>          # receiver
AVM_MNEMONIC="<agent 25-word mnemonic>"      # payer, LOCAL ONLY
SERVER_URL=http://localhost:4021

3. 서버 시작 + 에이전트 실행

pnpm server        # terminal 1
pnpm agent         # terminal 2: discovery → 402 → auto-pay → result

온체인 검증

모든 성공적인 호출은 실제 TestNet 트랜잭션으로 정산됩니다:

• Facilitator 대시보드: https://facilitator.goplausible.xyz/dashboard

• Lora 탐색기: https://lora.algokit.io/testnet

정산 트랜잭션 예시(데모 실행에서):

TODO: paste Lora transaction link after first live run

API

Roadmap

• 지출 정책 가드: 미들웨어가 에이전트별 예산을 강제 적용

• 크리에이터 대시보드: 몇 분 안에 자신의 MCP 도구와 가격을 등록

• GoPlausible의 Bazaar 등록을 통해 모든 타사 에이전트가 MCP-Pay 도구를 발견할 수 있음