라이브 도구
15종
읽기 8, 쓰기 7
피클이 쓰는 MCP 도구와 주문 API를 ChatGPT, Claude 같은 AI 비서에도 엽니다.
라이브 도구
15종
읽기 8, 쓰기 7
읽기 비중
53%
인증 없이 읽는 도구
MCP 왕복
27ms
지금 이 화면이 tools/list 를 읽은 시간
주문 멱등
1건
같은 키로 두 번 보내도 주문은 하나
이름은 모두 pepper_ 로 시작합니다. 목록은 api 가 돌려주는 값입니다.
pepper_search_storesPepper 에 등록된 공개 매장을 찾는다(search stores). 이름 일부(query)와 이행 방식(fulfillment: delivery·pickup·reservation)으로 거른다. 위치 반경 검색은 아직 지원하지 않는다.읽기pepper_get_store매장 프로필(store profile): 영업 상태, 영업시간, 배달·픽업·예약 설정, 최소 주문 금액, 배달비. 금액은 정수 원, 시각은 +09:00.읽기pepper_get_menu구조화 메뉴(menu): 카테고리·메뉴·옵션 그룹(필수 여부·최소/최대)·품절. 주문에는 menu_id·group_id·option_id 를 그대로 쓴다.읽기pepper_quote_delivery주소로 배달 가능 여부·배달비·예상 시간을 계산한다(delivery quote). quote_id 는 배달 주문에 넣는다.읽기pepper_get_pickup_slots픽업 가능한 시각(pickup slots). 불가 슬롯은 reason 이 있다. 고른 슬롯은 pepper_hold_pickup_slot 으로 120초 잡는다.읽기pepper_get_availability날짜·인원으로 예약 가능한 시각(availability)을 조회한다. 불가 시각은 reason 이 있다.읽기pepper_validate_order부작용 없이 주문 초안을 검증하고 서버 금액을 계산한다(validate order). 사람에게 보여 줄 합계는 이 결과의 금액만 쓴다.읽기pepper_create_delivery_order배달 주문을 만든다(create delivery order). 사람의 최종 확인 뒤 호출하고 human_confirmation 을 넣는다. 전화는 phone_token 만. 온라인 결제는 응답의 결제 링크에서 사람이 승인한다.쓰기pepper_create_pickup_order픽업 주문을 만든다(create pickup order). 먼저 pepper_hold_pickup_slot 으로 받은 slot_hold_id 가 필요하다. 사람의 최종 확인 뒤 호출한다.쓰기pepper_hold_pickup_slot픽업 슬롯을 120초 동안 잡는다(hold pickup slot). 그 안에 pepper_create_pickup_order 를 호출한다.쓰기pepper_get_order주문 상태·타임라인·가능한 다음 행동(get order). 이 키로 만든 주문만 볼 수 있다.읽기pepper_cancel_order주문을 취소한다(cancel order). 매장이 접수한 뒤에는 거절될 수 있다(CANCEL_NOT_ALLOWED). 선결제는 자동 환불된다.쓰기pepper_create_reservation매장의 잔여석을 점유해 방문 예약을 만든다(create reservation). 사람의 최종 확인을 받은 뒤 호출한다. 결과는 confirmed·pending_store 또는 waitlisted, 만석이면 CAPACITY_FULL(대안 시각 recovery 포함).쓰기pepper_modify_reservation예약 인원·시각을 바꾼다(modify reservation). 늘어난 좌석을 못 받으면 기존 예약이 그대로 유지된다.쓰기pepper_cancel_reservation예약을 취소한다(cancel reservation). 반환된 좌석은 대기 손님에게 자동으로 넘어간다.쓰기도구 하나가 REST 엔드포인트 하나와 같은 서비스 함수를 붙니다.
키를 만들면 모양과 스코프를 그대로 확인할 수 있습니다.
이 키는 화면 안에서만 쓰는 데모입니다. 실제 발급은 운영 CLI(`agent:issue`)가 하고, 발급한 키는 저장소·브라우저에 남기지 않습니다.
읽기 요청만 보냅니다. 주문 만들기 같은 쓰기는 여기서 보내지 않습니다(매번 주문이 쌓입니다).
201201409 IDEMPOTENCY_KEY_REUSED409 IDEMPOTENCY_IN_PROGRESS쓰기 요청에는 `Idempotency-Key` 헤더가 필요합니다. 오류 응답에는 `code`, `retryable`, `recovery` 가 함께 오므로 그 값으로 다음 행동을 정합니다.
모든 응답은 금액이 원 단위 정수, 시각이 ISO 8601 +09:00 이고 개인정보는 마스킹된 값만 돌려줍니다.