@pay-skill/mcp

Name: pay-mcp
Author: pay-skill

Pay를 위한 MCP 서버 — AI 에이전트를 위한 완벽한 x402 결제 스택입니다. Base 네트워크의 USDC를 사용합니다.

MCP 호환 클라이언트(Claude Desktop, Cursor, VS Code, 커스텀 프레임워크 등)에서 Pay의 모든 기능을 사용할 수 있게 합니다: 직접 결제, 탭(tabs), x402 페이월, 서비스 검색 및 지갑 관리. 별도의 CLI 바이너리가 필요하지 않습니다.

설정

Claude Desktop

claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

VS Code / Cursor

.vscode/mcp.json에 추가하세요:

{
  "servers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

Claude Code

claude mcp add pay -- npx -y @pay-skill/mcp

설정은 이것으로 끝입니다. 처음 실행 시 서버가 지갑을 생성하고 OS 키체인(Windows Hello, macOS Keychain, Linux Secret Service)에 저장합니다. 이후 실행 시에는 자동으로 로드됩니다.

구성

환경 변수	필수 여부	기본값	설명
`PAYSKILL_SIGNER_KEY`	아니오	—	선택적 재정의. 원시 16진수 키 또는 `.enc` 키스토어 비밀번호. 일반적인 사용 시에는 필요하지 않습니다.
`PAY_NETWORK`	아니오	`mainnet`	`mainnet` (Base) 또는 `testnet` (Base Sepolia)

키 확인 순서 (다음 순서대로 확인)

OS 키체인 (기본값) — keytar를 통해 OS 자격 증명 저장소에서 로드합니다. 처음 실행 시 새 키 쌍이 생성되어 자동으로 저장됩니다.
암호화된 키스토어 — ~/.pay/keys/default.enc가 존재하면 PAYSKILL_SIGNER_KEY를 복호화 비밀번호로 사용합니다.
원시 16진수 키 — PAYSKILL_SIGNER_KEY가 64자 16진수 문자열인 경우 직접 사용합니다. 개발/테스트 또는 기존 지갑을 가져올 때 사용합니다.
자동 생성 — 위 항목이 모두 없으면 새 키 쌍을 생성하여 OS 키체인에 저장합니다.

진단 확인

모든 설정이 올바른지 확인하세요:

npx @pay-skill/mcp --check

출력:

pay-mcp diagnostic check
  network: Base (chain 8453)
  api:     https://pay-skill.com/api/v1
  wallet:  0x1234...
  key:     keychain
  server:  OK (router: 0xABCD...)
  auth:    OK (balance: $50.00)

All checks passed. MCP server is ready.

도구 (15)

결제

도구	설명
`pay_send`	직접 USDC 결제 (최소 $1). 확인 임계값: $10 미만 자동, $10-100 계획 확인, $100 초과 명시적 확인.
`pay_request`	x402 자동 결제가 포함된 HTTP 요청. 402 감지, 직접/탭 결제, 가격 검증 처리.

탭 (계량형 계정)

도구	설명
`pay_tab_open`	선불 탭 열기 (최소 $5, $50 권장). 제공자가 호출당 요금을 청구합니다.
`pay_tab_close`	탭 닫기. 분배 내역 반환 (제공자 99%, 수수료 1%, 에이전트 잔액).
`pay_tab_charge`	열린 탭에 대해 요금 청구 (제공자 전용).
`pay_tab_topup`	열린 탭에 자금 추가 (에이전트 전용).
`pay_tab_list`	유휴/잔액 부족 상태인 탭 목록 확인.

지갑

도구	설명
`pay_status`	잔액, 잠김/사용 가능한 자금, 실행 가능한 제안.
`pay_fund`	1시간 유효한 자금 입금 링크 생성 (Coinbase Onramp 또는 직접 USDC).
`pay_withdraw`	1시간 유효한 출금 링크 생성.
`pay_mint`	테스트넷 USDC 발행 (Base Sepolia 전용).

검색 및 웹훅

도구	설명
`pay_discover`	키워드/카테고리별 유료 API 서비스 검색.
`pay_webhook_register`	결제 이벤트에 대한 웹훅 등록 (HMAC 서명).
`pay_webhook_list`	등록된 웹훅 목록 확인.
`pay_webhook_delete`	웹훅 삭제.

리소스 (5)

URI	설명
`pay://wallet/status`	잔액, 탭, 잠김/사용 가능한 자금
`pay://wallet/tabs`	모든 열린 탭
`pay://tab/{tab_id}`	단일 탭 상세 정보
`pay://wallet/address`	지갑 주소
`pay://network`	네트워크 구성 + 컨트랙트 주소

프롬프트 (3)

프롬프트	설명
`pay-for-service`	가이드: 서비스 검색, 가격 평가, 요청 수행
`review-tabs`	탭 검토, 유휴 상태 표시, 닫기/충전 제안
`fund-wallet`	자금 입금 링크 생성, 입금 절차 설명

개발

git clone https://github.com/pay-skill/pay-mcp.git
cd pay-mcp
npm install
npm run build
npm test                    # unit tests (mocked)
npm run test:acceptance     # testnet (requires PAYSKILL_SIGNER_KEY)

라이선스

MIT

Pay 소개

Pay는 AI 에이전트가 Base 네트워크에서 USDC로 API 비용을 지불할 수 있도록 하는 게이트웨이, 퍼실리테이터, SDK, CLI 및 MCP 서버를 포함한 완벽한 x402 결제 스택입니다.

문서
아키텍처
SDK -- Python + TypeScript
CLI -- 명령줄 도구
pay-gate -- x402 결제 게이트웨이
프로토콜 -- 스마트 컨트랙트

pay-mcp