콘텐츠로 이동
요금문서EN

지갑 MCP 도구

호스팅 지갑 MCP와 로컬(stdio) 지갑이 같은 도구를 씁니다. 이 도구 목록에서 pay_intent는 서비스 결제 intent를 실행합니다. 서비스 서버는 이용자가 승인한 권한 안에서 별도로 청구할 수 있고, SDK 송금은 별도 흐름입니다.

도구 인자 설명
wallet_login - 지갑 가입 또는 로그인과 Pouchi 연결. 사용자가 승인 화면에서 직접 마칩니다.
wallet_status - 내 지갑 주소, OKRW 잔액, 사용자가 승인한 권한 현황.
pay_intent intent_url: string 등록된 서비스가 만든 결제 intent(intent_url)를 실행합니다. 처음이면 사용자가 그 권한(대상, 금액 한도, 기간)을 한 번 승인하고, 같은 권한 안의 다음 실행은 묻지 않고 처리됩니다. 잔액이 부족하면 충전 링크를 먼저 보냅니다.
change_mandate intent_url: string 서비스가 만든 권한 변경 intent(intent_url, 예: 구독 연장, 한도 증액)를 사용자 승인 후 적용합니다. 범위(대상 컨트랙트·함수)는 바뀌지 않습니다.
my_budget - 사용자가 승인한 권한(mandate) 목록: 서비스, 남은 한도·횟수, 기간, 실행 내역.
my_payments - 최근 결제 내역 (에이전트 실행과 서비스 청구, 영수증 포함).
revoke_mandate mandate_id?: string, mandate_key?: string 권한을 해지합니다. 에이전트와 서비스의 결제는 즉시 멈추고, 사용자가 링크에서 승인하면 체인에서도 꺼집니다. mandate_id는 my_budget에서 찾으세요.
wallet_disconnect - Pouchi 지갑 연결을 끊습니다. 연결이 해지되어 이 지갑으로 연결된 에이전트는 더 결제할 수 없습니다(같은 지갑으로 연결한 다른 에이전트도 함께 끊깁니다). 이미 승인한 결제 권한은 체인에 그대로 남으며(연결이 끊긴 동안은 쓰이지 않음), 사용자가 결제 내역과 권한에서 끕니다. 다시 쓰려면 다시 연결합니다.
payment_status job_id?: string, payment_id?: string 승인 대기 중인 작업(결제, 권한, 연결)의 결과를 기다립니다. 최대 50초 기다렸다가 답하며, 아직이면 다시 호출하세요.
상태 뜻 에이전트가 할 일
waiting_for_user 사용자 승인 대기. approval_url이 함께 옴 링크를 보여 주고 payment_status(job_id)로 기다림
paid 실행 완료. receipt 포함 결과를 알림
mandate_active 권한만 승인됨 (나중 청구) 서비스가 일정대로 청구함을 알림
rejected_by_user, expired 사용자가 거절했거나 시간이 지남 다시 묻지 않음