io.github.tuanone123/hotlikeshop-mcp

Est-ce que io.github.tuanone123/hotlikeshop-mcp est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.github.tuanone123/hotlikeshop-mcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 32 outils

• best_sellers≈ 242 tokens

  List best-selling in-stock public products (most sold first), public fields only (price VND + units sold). Read-only, no api_key required. WHEN TO USE: the user wants "popular / hot / most bought" items. PREFER INSTEAD: latest_products for "new arrivals", search_products for a keyword, recommend_products for a budget, list_category_products for a full category. Optionally scope with category_id (from list_categories) or a keyword. Danh sách sản phẩm BÁN CHẠY còn hàng (đã bán nhiều nhất trước); chỉ trả field công khai (giá VND + số đã bán).

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Max results (default 10, max 20).
  • keyword · string · optionnel
    Keyword in product name (optional). Từ khóa trong tên SP (tùy chọn).
  • category_id · integer · optionnel
    Limit to a category id (optional). Giới hạn theo danh mục (tùy chọn).

  Exemple d'appel

  {"name": "best_sellers", "arguments": {"limit": 1, "keyword": "texte", "category_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• buy_product≈ 256 tokens

  STEP 2 of buying: place the order using the confirm_token from quote_order. IRREVERSIBLE — this SPENDS real balance and delivers the product; returns order_code + the delivered content. PREREQUISITE: a fresh confirm_token from quote_order (same api_key). WHEN TO USE: only AFTER the user has explicitly approved the exact total shown by quote_order. Do NOT call speculatively or to re-price. AFTERWARDS: check_order_status for delivery (set refresh=true if it looks stuck), get_mail_code for OTP, submit_complaint if faulty. Bước 2: đặt mua thật bằng confirm_token (TRỪ TIỀN THẬT & giao hàng); chỉ gọi sau khi người dùng đã đồng ý giá đã báo.

  Paramètres, retour & exemple (2)

  Paramètres

  • api_key · string · requis
    Your shop account API key (must match the one used in quote_order).
  • confirm_token · string · requis
    The confirm_token returned by quote_order (valid ~5 minutes, single use).

  Exemple d'appel

  {"name": "buy_product", "arguments": {"api_key": "texte", "confirm_token": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• check_health_bulk≈ 361 tokens

  Bulk live/dead check for MANY accounts at once (max 20 per call): Facebook UID (numeric) or Instagram/Telegram/TikTok usernames. Returns per-item status + a summary. Read-only, free, no api_key required. IG/FB items that cannot be verified (datacenter IP blocked) are moved to "skipped" — pass your own "proxy" to check them reliably. WHEN TO USE: a list of 2-20 accounts, or any non-Facebook platform. PREFER INSTEAD: check_live_facebook for a single Facebook UID, deep_inspect for one detailed profile. Kiểm tra sống/chết HÀNG LOẠT (tối đa 20/lần): UID Facebook hoặc username IG/TG/TikTok; mục IG/FB không check được bị đưa vào "skipped" — truyền "proxy" riêng để check chuẩn.

  Paramètres, retour & exemple (3)

  Paramètres

  • items · array · requis
    List of UIDs (Facebook) or usernames (IG/TG/TikTok). Danh sách UID/username (tối đa 20). Cũng chấp nhận 1 chuỗi ngăn cách bởi dấu phẩy/xuống dòng.
  • proxy · string · optionnel
    Optional (recommended for IG/FB): YOUR own proxy, this request only, never shared. http(s)://user:pass@host:port or socks5://host:port. Tùy chọn (nên có cho IG/FB): proxy CỦA BẠN, chỉ request này.
  • platform · string · optionnel · facebook | instagram | telegram | tiktok
    Platform to check. Nền tảng cần kiểm tra (mặc định facebook).

  Exemple d'appel

  {"name": "check_health_bulk", "arguments": {"items": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• check_live_facebook≈ 284 tokens

  Check whether ONE Facebook UID (numeric) is live or dead via the public profile-picture endpoint (server-side). Read-only, free, no api_key required. Facebook blocks datacenter IPs, so if it cannot verify it returns status "needs_proxy" — pass your own "proxy" to check reliably. WHEN TO USE: a single Facebook UID. PREFER INSTEAD: check_health_bulk for many accounts at once or for Instagram/Telegram/TikTok, deep_inspect for a detailed profile (followers, bio, media). Kiểm tra 1 UID Facebook (số) sống/chết; FB chặn IP máy chủ nên nếu không check được sẽ trả "needs_proxy" — truyền "proxy" riêng để check chuẩn.

  Paramètres, retour & exemple (2)

  Paramètres

  • uid · string · requis
    Facebook numeric UID. UID Facebook (chỉ gồm chữ số).
  • proxy · string · optionnel
    Optional: YOUR own proxy for this request only (never shared). Format: http(s)://user:pass@host:port or socks5://host:port. Tùy chọn: proxy CỦA BẠN, chỉ áp cho request này (không chia sẻ). Dạng http(s)://user:pass@host:port hoặc socks5://host:port.

  Exemple d'appel

  {"name": "check_live_facebook", "arguments": {"uid": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• check_order_status≈ 350 tokens

  Check the status and delivered content (account credentials) of ONE of your orders by order_code (requires your api_key). Read-only by default — spends nothing. OPTIONAL refresh=true: if the order looks stuck/undelivered (pending/failed), re-triggers delivery from the system (async, safe — never charges money, never touches a completed/refunded order) then returns the current status; poll again after ~5-10s. PREREQUISITE: an order_code (from buy_product or list_orders). WHEN TO USE: the user wants the current state or the delivered data of a specific order; set refresh=true only to nudge a stuck order. PREFER INSTEAD: list_orders to find the order_code first, get_mail_code for the email OTP, submit_complaint if the delivered item is faulty. Kiểm tra trạng thái & nội dung đã giao của 1 đơn theo order_code (cần api_key); truyền refresh=true để ép giao lại nếu đơn treo — không tính phí.

  Paramètres, retour & exemple (3)

  Paramètres

  • api_key · string · requis
    Your shop account API key.
  • refresh · boolean · optionnel
    Set true to re-trigger delivery when the order looks stuck/undelivered (async; safe, never charges). Default false = plain read-only status check.
  • order_code · string · requis
    The order code returned by buy_product.

  Exemple d'appel

  {"name": "check_order_status", "arguments": {"api_key": "texte", "order_code": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• claim_quest≈ 229 tokens

  Claim the reward for ONE completed quest. Server verifies completion from real data; idempotent — one claim per quest per period (a second call will not double-credit). Reward credits the SHOPPING balance (not withdrawable). PREREQUISITE: a quest_key that is complete-but-unclaimed, from list_quests or gamefi_status. WHEN TO USE: collect a finished quest. PREFER INSTEAD: list_quests to find which quest_key is claimable, daily_checkin / spin_wheel for those specific rewards. Requires api_key. Nhận thưởng 1 nhiệm vụ đã hoàn thành (dùng quest_key từ list_quests).

  Paramètres, retour & exemple (2)

  Paramètres

  • api_key · string · requis
    Your shop account API key.
  • quest_key · string · requis
    The quest key to claim (from list_quests), e.g. daily_checkin, daily_buy1, weekly_spend50k.

  Exemple d'appel

  {"name": "claim_quest", "arguments": {"api_key": "texte", "quest_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• compare_products≈ 208 tokens

  Compare 2–5 public products side by side (price, stock, min/max, sold, category) with a quick summary (cheapest / most stock / best seller). Read-only, no api_key required, public fields only (price VND). PREREQUISITE: you already have 2-5 product ids. WHEN TO USE: help the user pick between specific candidates. PREFER INSTEAD: get_product for one id in depth, similar_products to first discover comparable items, search_products / list_category_products to find ids. So sánh 2–5 sản phẩm cạnh nhau để khách chốt nhanh; chỉ field công khai (giá VND).

  Paramètres, retour & exemple (1)

  Paramètres

  • ids · array · requis
    Danh sách 2–5 product id cần so sánh, vd [943, 1004]. Cũng chấp nhận chuỗi "943,1004".

  Exemple d'appel

  {"name": "compare_products", "arguments": {"ids": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_binance_deposit≈ 229 tokens

  Create a Binance Pay deposit order to top up your balance. The SERVER returns the shop receive Pay ID (and QR) plus a unique USDT amount (with cents) — relay them VERBATIM, never invent them. PREREQUISITE: api_key AND Binance Pay must be enabled (check topup_guide first). WHEN TO USE: the user will pay inside the official Binance app. AFTERWARDS: call verify_binance_deposit with merchant_trade_no. PREFER INSTEAD: create_usdt_deposit for on-chain USDT transfers. Tạo đơn nạp Binance Pay — hệ thống trả Pay ID nhận tiền + số USDT kèm số lẻ; chuyển lại NGUYÊN VĂN.

  Paramètres, retour & exemple (2)

  Paramètres

  • api_key · string · requis
    Your shop account API key.
  • amount_usd · number · requis
    Whole-number USD amount to deposit (the system assigns a unique cents suffix).

  Exemple d'appel

  {"name": "create_binance_deposit", "arguments": {"api_key": "texte", "amount_usd": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_usdt_deposit≈ 328 tokens

  Create a USDT deposit order to top up your balance. The SERVER generates the real receiving wallet address and a unique amount (with cents) — relay them to the user VERBATIM, never invent or edit a wallet address. Supports TRC20 / BEP20 / Polygon / Arbitrum / Base. PREREQUISITE: api_key; call topup_guide FIRST to see which networks are active + min/max. WHEN TO USE: the user wants to deposit on-chain USDT. AFTERWARDS: once they send, call verify_usdt_deposit with order_code + claim_token. PREFER INSTEAD: create_binance_deposit for users paying inside the Binance app. Tạo đơn nạp USDT — hệ thống tự sinh ĐỊA CHỈ VÍ và SỐ TIỀN kèm số lẻ độc nhất; chuyển lại NGUYÊN VĂN, KHÔNG tự chế/sửa ví.

  Paramètres, retour & exemple (3)

  Paramètres

  • api_key · string · requis
    Your shop account API key.
  • network · string · optionnel · trc20 | bep20 | polygon | arbitrum | base
    USDT network: trc20 | bep20 | polygon | arbitrum | base (default trc20). Only networks with a configured wallet work — check topup_guide.
  • amount_usd · number · requis
    Whole-number USD amount to deposit (decimals are ignored — the system assigns a unique cents suffix).

  Exemple d'appel

  {"name": "create_usdt_deposit", "arguments": {"api_key": "texte", "amount_usd": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• daily_checkin≈ 193 tokens

  Perform the once-a-day check-in and collect the reward (random 200-1,000đ base + streak milestone bonuses at 7/30 days, sometimes x2 combo). Idempotent — if already checked in today it just says so (no double credit). Each check-in also grants +1 lucky-wheel spin. Reward credits the SHOPPING balance (not withdrawable). WHEN TO USE: the user wants to claim today's free check-in. PREFER INSTEAD: gamefi_status to first see if it is available, spin_wheel to use the earned spin, claim_quest for quest rewards. Requires api_key. Điểm danh hằng ngày nhận thưởng (mỗi ngày 1 lần).

  Paramètres, retour & exemple (1)

  Paramètres

  • api_key · string · requis
    Your shop account API key.

  Exemple d'appel

  {"name": "daily_checkin", "arguments": {"api_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• deep_inspect≈ 350 tokens

  Deep profile lookup for ONE social account (server-side, best-effort, public data only): Instagram/TikTok → followers, bio, verified, media; Telegram → title, members; Facebook UID → live/dead + avatar. Read-only, free, no api_key required. IG/FB block datacenter IPs → if it cannot read it returns status "needs_proxy"; pass your own "proxy" to read reliably. WHEN TO USE: you want rich detail about one profile. PREFER INSTEAD: check_health_bulk to sweep many accounts for live/dead only, check_live_facebook for a quick single-UID liveness check. Xem SÂU 1 tài khoản MXH (chỉ đọc công khai); IG/FB chặn IP máy chủ → nếu không xem được trả "needs_proxy", truyền "proxy" riêng để xem chuẩn.

  Paramètres, retour & exemple (3)

  Paramètres

  • proxy · string · optionnel
    Optional (recommended for IG/FB): YOUR own proxy, this request only, never shared. http(s)://user:pass@host:port or socks5://host:port. Tùy chọn (nên có cho IG/FB): proxy CỦA BẠN, chỉ request này.
  • handle · string · requis
    Username/handle (IG/TG/TikTok) or numeric UID (Facebook). Also accepts a full profile URL. Username hoặc UID (FB); chấp nhận cả link profile.
  • platform · string · requis · facebook | instagram | telegram | tiktok
    Platform. Nền tảng cần xem.

  Exemple d'appel

  {"name": "deep_inspect", "arguments": {"handle": "texte", "platform": "facebook"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• gamefi_status≈ 228 tokens

  One-shot overview of all FREE balance rewards the account can grab right now: daily check-in (available today? streak, reward range), lucky-wheel spins available, and the quest board (how many quests are complete & claimable). Read-only. WHEN TO USE: call this FIRST whenever the user asks about rewards/free balance, then use daily_checkin / spin_wheel / list_quests + claim_quest to collect. Note: all rewards credit the SHOPPING balance (spendable in-shop, NOT withdrawable). Requires api_key. Tổng quan phần thưởng miễn phí: điểm danh, vòng quay, nhiệm vụ có thể nhận (thưởng vào số dư mua hàng, không rút được).

  Paramètres, retour & exemple (2)

  Paramètres

  • lang · string · optionnel
    Language for labels: "vi" or "en" (default en).
  • api_key · string · requis
    Your shop account API key.

  Exemple d'appel

  {"name": "gamefi_status", "arguments": {"api_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_2fa≈ 196 tokens

  Generate the current 2FA/TOTP code (6 digits) from a Base32 secret key (Google Authenticator style). Computed on the server in-memory only, never stored or logged. Free, no api_key required. WHEN TO USE: the user has an authenticator secret key (from an account they bought or own) and needs the live TOTP code now. PREFER INSTEAD: get_mail_code for email OTP/verification codes delivered to a mail-bundled order. Requires a valid Base32 secret. Sinh mã 2FA/TOTP hiện tại (6 số) từ khóa bí mật Base32; tính cục bộ, không lưu, không gửi đi đâu.

  Paramètres, retour & exemple (1)

  Paramètres

  • secret · string · requis
    Base32 secret key (spaces allowed). Khóa bí mật Base32 (cho phép có dấu cách).

  Exemple d'appel

  {"name": "get_2fa", "arguments": {"secret": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_mail_code≈ 235 tokens

  Get the latest email OTP / verification code for a purchased mail-bundled account order. Supports Hotmail/Outlook via OAuth (refresh_token) and mail.tm (email + password). Read-only. PREREQUISITE: api_key + an order_code whose delivered account includes an inbox. WHEN TO USE: the user needs the verification code sent to the email that came with their order. PREFER INSTEAD: get_2fa for authenticator (TOTP) codes, check_order_status to see the delivered credentials themselves. Lấy mã OTP/xác minh mới nhất cho đơn tài khoản có kèm mail (Hotmail/Outlook qua refresh_token, mail.tm qua email+mật khẩu); cần api_key + order_code.

  Paramètres, retour & exemple (2)

  Paramètres

  • api_key · string · requis
    Your shop account API key.
  • order_code · string · requis
    The order code of the mail-bundled account order.

  Exemple d'appel

  {"name": "get_mail_code", "arguments": {"api_key": "texte", "order_code": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_my_balance≈ 179 tokens

  Get your account balance, level and discount (requires your shop api_key). Read-only, spends nothing. WHEN TO USE: the user asks "how much do I have" or you need to confirm funds before quote_order / buy_product. PREFER INSTEAD: wallet_history for the full ledger of top-ups/spends/refunds, topup_guide to add funds, quote_order to price a specific purchase. Requires a valid api_key. Xem số dư & hạng tài khoản (cần api_key); trả balance (VND), level, discount.

  Paramètres, retour & exemple (1)

  Paramètres

  • api_key · string · requis
    Your shop account API key. Khóa API tài khoản shop của bạn (Trang cá nhân → API).

  Exemple d'appel

  {"name": "get_my_balance", "arguments": {"api_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_product≈ 186 tokens

  Get the full public detail of ONE product by its numeric id: name, price (VND), stock, category, long description and url. Read-only, no api_key required. WHEN TO USE: after search_products / list_category_products / best_sellers gave you an id and the user wants the full description of that single item. PREFER INSTEAD: compare_products to evaluate 2-5 ids at once, similar_products to find alternatives. Requires a known product id (not a name). Not for buying — pass the id to quote_order. Xem chi tiết 1 sản phẩm công khai theo id (kèm mô tả); chỉ đọc, không cần api_key.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · integer · requis
    Product id.

  Exemple d'appel

  {"name": "get_product", "arguments": {"id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• how_to_start≈ 212 tokens

  Onboarding guide for NEW users: how to start buying on hotlikeshop through this MCP (create account -> get api_key -> top up -> search & buy). Read-only, no api_key required. WHEN TO USE: the very FIRST call for a new / international user, or whenever someone lacks an api_key or asks "how does this work". Lists which tools are free vs. which need an api_key. PREFER INSTEAD: topup_guide for deposit specifics, quote_order + buy_product to actually purchase, search_products to browse. Pass lang="en" (default) or lang="vi". Hướng dẫn bắt đầu cho người mới: tạo tài khoản -> lấy api_key -> nạp tiền -> tìm & mua.

  Paramètres, retour & exemple (1)

  Paramètres

  • lang · string · optionnel
    Optional: "en" (default) or "vi". Ngôn ngữ hướng dẫn: "en" (mặc định) hoặc "vi".

  Exemple d'appel

  {"name": "how_to_start", "arguments": {"lang": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• latest_products≈ 231 tokens

  List newest in-stock public products (recently added first), public fields only (price VND). Read-only, no api_key required. WHEN TO USE: the user wants "new arrivals / just added". PREFER INSTEAD: best_sellers for "popular", search_products for a keyword, recommend_products for a budget, list_category_products for a full category. Optionally scope with category_id (from list_categories) or a keyword. Danh sách sản phẩm MỚI còn hàng (thêm gần đây nhất trước); chỉ trả field công khai (giá VND).

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Max results (default 10, max 20).
  • keyword · string · optionnel
    Keyword in product name (optional). Từ khóa trong tên SP (tùy chọn).
  • category_id · integer · optionnel
    Limit to a category id (optional). Giới hạn theo danh mục (tùy chọn).

  Exemple d'appel

  {"name": "latest_products", "arguments": {"limit": 1, "keyword": "texte", "category_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_categories≈ 162 tokens

  List every public category with its id, name and in-stock product count. Read-only, takes no parameters, no api_key required. WHEN TO USE: call this FIRST to discover the category taxonomy and get the category_id values required by list_category_products, best_sellers, latest_products and recommend_products. PREFER INSTEAD: search_products when the user already has a keyword, or how_to_start for onboarding. This only lists categories — it does not return individual products. Liệt kê danh mục công khai kèm số sản phẩm; dùng để lấy category_id.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_categories", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_category_products≈ 204 tokens

  List in-stock public products inside ONE category by category_id: id, name, price (VND), stock. Read-only, no api_key required. PREREQUISITE: get category_id from list_categories first. WHEN TO USE: browse everything in a chosen category. PREFER INSTEAD: search_products for keyword search across all categories, best_sellers to rank a category by sales, recommend_products to filter by budget, latest_products for newest. Not for buying — pass a chosen id to quote_order. Liệt kê sản phẩm công khai trong 1 danh mục theo category_id.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Max results (default 30, max 100).
  • category_id · integer · requis
    Category id.

  Exemple d'appel

  {"name": "list_category_products", "arguments": {"category_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_orders≈ 244 tokens

  List your recent orders (order history), paginated, with order_code, product, quantity, total paid, status and date (requires your api_key). Read-only, spends nothing. WHEN TO USE: the user wants their purchase history or you need to find an order_code. AFTERWARDS: check_order_status (with refresh=true to nudge a stuck order) / get_mail_code for a specific order_code. PREFER INSTEAD: wallet_history for money movements (top-ups/refunds), not order details. Liệt kê lịch sử đơn (order_code, sản phẩm, số lượng, tổng tiền, trạng thái, ngày) — cần api_key; dùng để tìm order_code rồi gọi check_order_status / get_mail_code.

  Paramètres, retour & exemple (3)

  Paramètres

  • page · integer · optionnel
    Page number (default 1).
  • limit · integer · optionnel
    Orders per page (default 20, max 100).
  • api_key · string · requis
    Your shop account API key.

  Exemple d'appel

  {"name": "list_orders", "arguments": {"api_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_quests≈ 198 tokens

  List the daily & weekly quest board with progress: each quest key, title, reward, current/target progress, whether it is complete and whether it is already claimed. Read-only, spends nothing. WHEN TO USE: the user wants to see quests or you need a quest_key. AFTERWARDS: call claim_quest on any quest that is complete but not yet claimed. PREFER INSTEAD: gamefi_status for a combined rewards summary (check-in + wheel + quests). Requires api_key. Danh sách nhiệm vụ ngày/tuần kèm tiến độ + phần thưởng.

  Paramètres, retour & exemple (2)

  Paramètres

  • lang · string · optionnel
    Language for titles: "vi" or "en" (default en).
  • api_key · string · requis
    Your shop account API key.

  Exemple d'appel

  {"name": "list_quests", "arguments": {"api_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• quote_order≈ 250 tokens

  STEP 1 of buying: get a price quote for a product BEFORE purchasing. Returns unit price, discount, total to pay (VND), your balance, stock, and a confirm_token (single-use, valid ~5 min). SPENDS NOTHING. Requires api_key + product_id. WHEN TO USE: always call this first, then show the total to the user and get explicit approval before buy_product. PREFER INSTEAD: get_my_balance to only check funds, check_order_status for an order that already exists (not for pricing a new one). Bước 1 khi mua: báo giá TRƯỚC khi mua, trả confirm_token; KHÔNG trừ tiền. Luôn hỏi người dùng xác nhận rồi mới gọi buy_product.

  Paramètres, retour & exemple (3)

  Paramètres

  • api_key · string · requis
    Your shop account API key.
  • quantity · integer · optionnel
    Quantity to buy (default 1).
  • product_id · integer · requis
    Product id (from search_products / get_product).

  Exemple d'appel

  {"name": "quote_order", "arguments": {"api_key": "texte", "product_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• recommend_products≈ 291 tokens

  Recommend in-stock public products by budget and/or keyword/category, cheapest first, with a simple combo suggestion. Read-only, no api_key required, public fields only (price VND). WHEN TO USE: the user has a budget or a vague need ("something under 50k for Facebook"). PREFER INSTEAD: search_products for an exact keyword, best_sellers for popularity, latest_products for newest, list_category_products to see a whole category. Optionally scope with category_id from list_categories. Gợi ý sản phẩm CÒN HÀNG theo ngân sách và/hoặc từ khóa/danh mục (rẻ trước) kèm gợi ý combo; chỉ trả field công khai (giá VND).

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Max results (default 8, max 20).
  • budget · integer · optionnel
    Max unit price in VND (optional). Ngân sách/giá tối đa mỗi SP (VND, tùy chọn).
  • keyword · string · optionnel
    Keyword in product name (optional). Từ khóa trong tên SP (tùy chọn).
  • category_id · integer · optionnel
    Limit to a category id (optional). Giới hạn theo danh mục (tùy chọn).

  Exemple d'appel

  {"name": "recommend_products", "arguments": {"limit": 1, "budget": 1, "keyword": "texte", "category_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_products≈ 198 tokens

  Search the public catalog by keyword in the product name; returns id, name, price (VND), stock, category and url. Read-only, no api_key required. WHEN TO USE: the user already has a search term or product name. PREFER INSTEAD: list_categories + list_category_products to browse without a keyword, best_sellers for "popular", latest_products for "new", get_product for the full detail of one id. Not for buying — pass a found id to quote_order. Tìm sản phẩm công khai theo tên; chỉ đọc, không cần api_key.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Max results (default 20, max 50).
  • query · string · requis
    Keyword / từ khóa (product name).

  Exemple d'appel

  {"name": "search_products", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• similar_products≈ 230 tokens

  Given ONE product id, list similar in-stock public products (same category, best-selling first; fills with newest from other categories if few). Read-only, no api_key required, public fields only (price VND + units sold). PREREQUISITE: a known product id. WHEN TO USE: suggest alternatives / cross-sell around an item the user is viewing, then optionally compare_products. PREFER INSTEAD: search_products for keyword search, recommend_products for budget-based picks, list_category_products to browse the whole category. Cho 1 product id, trả các SP TƯƠNG TỰ còn hàng (cùng danh mục, ưu tiên bán chạy; bù SP mới khác danh mục nếu ít).

  Paramètres, retour & exemple (2)

  Paramètres

  • id · integer · requis
    Product id gốc để tìm SP tương tự, vd 943.
  • limit · integer · optionnel
    Max results (default 8, max 20).

  Exemple d'appel

  {"name": "similar_products", "arguments": {"id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spin_wheel≈ 178 tokens

  Spin the lucky wheel once and return the prize won + new balance. Consumes exactly one spin server-side (NOT free to repeat — each call uses a spin). PREREQUISITE: available spins, earned from check-ins/deposits/purchases (see gamefi_status). WHEN TO USE: the user has spins and wants to use one. PREFER INSTEAD: daily_checkin to earn a spin first, gamefi_status to see how many spins remain. Winnings credit the SHOPPING balance (not withdrawable). Requires api_key. Quay vòng quay may mắn 1 lượt (cần còn lượt quay).

  Paramètres, retour & exemple (1)

  Paramètres

  • api_key · string · requis
    Your shop account API key.

  Exemple d'appel

  {"name": "spin_wheel", "arguments": {"api_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• submit_complaint≈ 351 tokens

  File a complaint / warranty-refund request for ONE delivered order (requires your api_key). Opens a support case; the shop reviews within 3 days and if unresolved in time the order is auto-refunded. NOT idempotent — one complaint per order, so confirm with the user before calling. PREREQUISITE: an order_code that was delivered and is genuinely faulty. WHEN TO USE: the bought item is wrong / dead / login-fails / short quantity. PREFER INSTEAD: check_order_status with refresh=true first if it merely looks stuck (undelivered), then check_order_status to track the case afterwards. Gửi khiếu nại/bảo hành-hoàn tiền cho 1 đơn (cần api_key); shop xử lý ≤3 ngày, quá hạn TỰ ĐỘNG HOÀN; mỗi đơn chỉ khiếu nại 1 lần; theo dõi bằng check_order_status.

  Paramètres, retour & exemple (4)

  Paramètres

  • reason · string · requis
    Short reason for the complaint, e.g. "Sai sản phẩm", "Không đăng nhập được", "Die/khóa", "Thiếu số lượng", "Khác".
  • api_key · string · requis
    Your shop account API key.
  • order_code · string · requis
    The order code you want to complain about (must belong to your account).
  • description · string · optionnel
    Optional details describing the problem (which items failed, error message, etc.).

  Exemple d'appel

  {"name": "submit_complaint", "arguments": {"reason": "texte", "api_key": "texte", "order_code": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• topup_guide≈ 307 tokens

  Explain how to add funds (deposit) to a hotlikeshop account and list the active deposit methods/networks + min/max. Info only — this tool never moves money. Read-only. WHEN TO USE: call this FIRST, before create_usdt_deposit or create_binance_deposit, to see which networks are enabled; pass api_key to also show current balance & the shortfall vs a target amount. PREFER INSTEAD: how_to_start for full new-user onboarding, get_my_balance if you only need the balance number. Pass lang="en" for an English guide. Hướng dẫn nạp tiền (chỉ thông tin, KHÔNG thanh toán); truyền api_key để kèm số dư & phần còn thiếu, kèm quy đổi USD.

  Paramètres, retour & exemple (3)

  Paramètres

  • lang · string · optionnel
    Optional: "en" for English guide, otherwise Vietnamese. Tùy chọn: "en" để nhận hướng dẫn tiếng Anh.
  • amount · integer · optionnel
    Optional: amount you want to spend (VND) to compute shortfall. Tùy chọn: số tiền cần (VND) để tính phần còn thiếu.
  • api_key · string · optionnel
    Optional: your shop api_key to also show current balance & shortfall (with USD conversion). Tùy chọn: api_key để hiện số dư & phần còn thiếu.

  Exemple d'appel

  {"name": "topup_guide", "arguments": {"lang": "texte", "amount": 1, "api_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• verify_binance_deposit≈ 229 tokens

  Check / confirm a Binance Pay deposit created by create_binance_deposit. Reads the shop Binance Pay history for a matching transfer and credits your balance when found. Idempotent — safe to poll every ~12s, credits only once. PREREQUISITE: merchant_trade_no from create_binance_deposit. WHEN TO USE: after the user has paid via Binance Pay, to confirm and credit it. PREFER INSTEAD: verify_usdt_deposit for on-chain USDT deposits, get_my_balance/wallet_history to inspect balance afterwards. Kiểm tra & xác nhận đơn nạp Binance Pay — khớp thì cộng tiền (an toàn khi gọi lại nhiều lần).

  Paramètres, retour & exemple (2)

  Paramètres

  • api_key · string · requis
    Your shop account API key.
  • merchant_trade_no · string · requis
    merchant_trade_no from create_binance_deposit.

  Exemple d'appel

  {"name": "verify_binance_deposit", "arguments": {"api_key": "texte", "merchant_trade_no": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• verify_usdt_deposit≈ 333 tokens

  Check / confirm a USDT deposit created by create_usdt_deposit. Scans the blockchain for a matching transfer and credits your balance when found. Idempotent — safe to poll every ~15s, credits only once. PREREQUISITE: order_code + claim_token from create_usdt_deposit. WHEN TO USE: after the user has sent the USDT, to confirm and credit it; optionally pass method="hash" + tx_hash to verify by a specific transaction. PREFER INSTEAD: verify_binance_deposit for Binance Pay deposits, get_my_balance/wallet_history to inspect balance afterwards. Kiểm tra & xác nhận đơn nạp USDT — quét blockchain, khớp thì cộng tiền (an toàn khi gọi lại nhiều lần).

  Paramètres, retour & exemple (5)

  Paramètres

  • method · string · optionnel · amount | hash
    Verification mode: "amount" (default, auto-scan by unique amount) or "hash".
  • api_key · string · requis
    Your shop account API key.
  • tx_hash · string · optionnel
    Transaction hash (only when method="hash").
  • order_code · string · requis
    order_code from create_usdt_deposit.
  • claim_token · string · requis
    claim_token from create_usdt_deposit (single-order secret).

  Exemple d'appel

  {"name": "verify_usdt_deposit", "arguments": {"api_key": "texte", "order_code": "texte", "claim_token": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• wallet_history≈ 222 tokens

  Get the balance ledger for the account: every top-up (bank/USDT/Binance Pay + bonuses, check-in, missions, wheel, reviews, affiliate) and every spend (purchases) / refund, with the running balance after each entry, plus totals in/out. Paginated (20/page, newest first). Read-only, spends nothing. WHEN TO USE: the user wants a history of money movements or to audit where funds went. PREFER INSTEAD: get_my_balance for just the current number, list_orders for purchase/order details rather than money entries. Requires api_key. Xem lịch sử biến động số dư (nạp/tiêu/hoàn) kèm số dư sau mỗi giao dịch.

  Paramètres, retour & exemple (2)

  Paramètres

  • page · integer · optionnel
    Page number (default 1, 20 rows per page).
  • api_key · string · requis
    Your shop account API key.

  Exemple d'appel

  {"name": "wallet_history", "arguments": {"api_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://hotlikeshop.com/api/mcp