Hola Poke Yeoksam

Workflow

1. 메뉴/매장 정보 조회

• 메뉴가 궁금하면 get_menu() 를 호출한다.
• 위치·영업시간·단체주문 문의는 get_shop_info() 를 호출한다.
• 응답은 메뉴명, 가격, 주소, 영업시간, URL 같은 핵심 정보 위주로 짧게 정리한다.

2. 이벤트 참여

현재 스킴은 즉석 래플 이다. 식사 주문 시 쓸 수 있는 혜택 코드가 발급될 수 있고, 동일 번호는 하루 1번만 응모할 수 있다.

1. 사용자가 참여 의사를 밝히면 휴대폰 번호를 먼저 받는다.
2. 이름·이메일은 받지 않고 번호만 받는다.
3. 번호는 결과 대조용이며 별도 마케팅 발송/3자 공유 용도가 아니라고 한 번 고지한다.
4. enter_event(phone) 를 호출한다.
5. phone_format 이면 서버 message 를 그대로 보여주고 다시 받는다.
6. already_entered_today 이면 서버 message 를 그대로 보여주고 더 이상 재시도하지 않는다.
7. 정상 응답이면 message, code, next_action 을 함께 전달한다.

3. 응답 원칙

• enter_event 의 message 는 글자 그대로 전달한다.
• 발급 코드는 `Jackpot-A3K9` 같은 모노스페이스로 강조한다.
• Jackpot/Claw 사용 경로는 next_action 과 함께 안내한다.
• 단체주문 문의는 get_shop_info() 의 group_order_url 이 비어 있으면 group_order_note 를 대신 안내한다.

Remote MCP setup note

이 스킬은 자체 수집기를 vendoring 하지 않는다. 원본 참고 repo와 동일하게 아래 remote MCP endpoint 를 붙여 사용하는 전제다.

• endpoint: https://hola-poke-yeoksam-skill.onrender.com/mcp
• reference repo: https://github.com/mnspkm/hola-poke-yeoksam-skill

Verified remote MCP contract snapshot

아래 값은 2026-04-16 KST live smoke check(initialize, tools/list, get_menu, get_shop_info, enter_event(phone='010-12')) 기준으로 정리한 contract fixture다.

initialize 결과

{
  "protocolVersion": "2025-03-26",
  "serverInfo": {
    "name": "hola-poke-yeoksam",
    "version": "3.2.3"
  }
}

tools/list 결과

{
  "tools": [
    {
      "name": "get_menu",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      }
    },
    {
      "name": "get_shop_info",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      }
    },
    {
      "name": "enter_event",
      "inputSchema": {
        "type": "object",
        "properties": {
          "phone": {
            "type": "string"
          }
        },
        "required": [
          "phone"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      }
    }
  ]
}

get_menu 구조 예시

{
  "updated_at": "2026-04-13",
  "currency": "KRW",
  "price_unit": "천원",
  "signature_poke": [
    {
      "id": 2,
      "name": "갈릭 쉬림프 포케",
      "price": 11.5,
      "tags": [
        "BEST"
      ]
    },
    {
      "id": 7,
      "name": "아보카도 포케",
      "price": 10.5,
      "tags": [
        "VEGAN"
      ]
    }
  ],
  "sets": [
    {
      "name": "1인 포케+스프 세트",
      "items": "포케 + 스프",
      "price": 13.5,
      "price_note": "13.5~"
    },
    {
      "name": "1인 혼밥 든든세트",
      "items": "포케 + 스프 + 음료",
      "price": 15.5,
      "price_note": "15.5~"
    }
  ],
  "addons": [
    {
      "name": "아보카도",
      "price": 3.5
    },
    {
      "name": "메밀면",
      "price": 1.5
    }
  ]
}

get_shop_info 구조 예시

{
  "name": "올라포케 역삼점",
  "address_road": "서울 강남구 논현로95길 29-8 1층 102호",
  "hours": {
    "weekday": "10:30 - 20:30",
    "break_time": "15:00 - 17:00",
    "weekend": "영업시간 네이버 스마트플레이스 확인"
  },
  "delivery_radius_km": 3,
  "group_order_url": "",
  "group_order_note": "10만원 이상 단체주문은 네이버 단체주문 페이지에서 메뉴 선택 후 네이버페이 결제. 결제 완료 시 예약 확정.",
  "delivery_apps": [
    "배달의민족",
    "쿠팡이츠",
    "요기요"
  ]
}

enter_event 성공 응답 필수 필드

실제 이벤트 참여를 발생시키지 않기 위해 성공 경로는 저장된 스냅샷 fixture 계약으로만 고정한다. 라이브 스모크는 invalid-phone 재시도 흐름만 검증한다.

{
  "required_fields": [
    "message",
    "code",
    "next_action"
  ],
  "accepts": [
    "01012345678",
    "010-1234-5678"
  ],
  "stores_name_or_email": false
}

enter_event(phone='010-12') 예시

{
  "error": "phone_format",
  "message": "번호는 010으로 시작하는 11자리로 입력해주세요 (예: 01012345678 또는 010-1234-5678)."
}

Done when

• 메뉴/매장 정보 요청에 핵심 정보를 전달했다.
• 이벤트 참여 요청에 번호 확인 → enter_event → 결과 전달 흐름을 지켰다.
• 반복 응모 제한과 서버 message 원문 전달 원칙을 지켰다.

Notes

• 역삼점 전용 스킬이다.
• 이벤트 스킴은 시기별로 달라질 수 있으므로 보상 조건의 진실 소스는 서버 응답의 message 필드다.
• Jackpot 당첨은 번호 주인 확인이 필요할 수 있다.
• 동일 번호는 KST 기준 하루 1번만 응모한다.