BuyKing MCP Server
BuyKing MCP server finds real, currently-on-sale global shopping hot deals across Korean, US, and Japanese markets — returning actual product data rather than AI-invented answers.
search_buyking_semantic— Borders-free semantic search of worldwide hot deals; each result is tagged with its shipping country code (🇰🇷KR / 🇺🇸US / 🇯🇵JP). Best first call for a general shopping query.search_buyking_semantic_KR— Korea-only deals shippable within Korea, KRW(₩) pricing, Korean results (Coupang, 11st, Gmarket, Auction, AliExpress).search_buyking_semantic_US— US-deliverable deals only, USD($) pricing, English results (Amazon US, etc.).search_buyking_semantic_JP— Japan-deliverable deals only, JPY(¥) pricing, Japanese results (Amazon JP, etc.).get_server_info— Returns the server version and feature list.Shared search parameters —
keyword(required); optionalcategory,platform, andsort(newest,price_asc,price_desc,click_desc).Access options — HTTP JSON-RPC endpoint (
https://buyking.saleplaza.com/message, rate-limited per IP) or the stdionpx buyking-mcppackage; usable in Claude Desktop via config.Caveat — The README also documents a
result_detail_GLOBALtool for single-product detail and price history, but it is not present in this server schema.
Allows searching Saleplaza's curated hot deals and product listings from AliExpress, with keyword search, category filters, and sorting options.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BuyKing MCP ServerFind me a budget-friendly robot vacuum cleaner"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BuyKing MCP Server
Read this in other languages: English, 日本語, 한국어
An MCP (Model Context Protocol) server providing the persona of "BuyKing, the Shopping Conqueror of Saleplaza."
Roar! I am BuyKing, the Shopping Conqueror of Saleplaza! I will find you the best hot deals you desire!

🏆 Glama.ai Official MCP Registry Certified A certified MCP server that has achieved the highest rating (Triple A) in all three categories: License, Quality, and Maintenance!
🚀 Features
✨ [v1.2.5] Product detail (result_detail_GLOBAL)
Search results now include a product ID line so a follow-up call can load one product. Titles in every country use title only.
When to call
Call a search tool first (
search_buyking_semantic,search_buyking_semantic_KR,search_buyking_semantic_US, orsearch_buyking_semantic_JP).Each result contains
- 상품 ID: {id}(for example25023).Call
result_detail_GLOBALonly when the user wants more about that one product: price history, the store buy link, the image, or scores. Do not use it for a new keyword search.
How to call
Tool name: result_detail_GLOBAL. Argument id is required and must be a numeric string from 상품 ID.
curl -X POST https://buyking.saleplaza.com/message \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "result_detail_GLOBAL",
"arguments": { "id": "25023" }
}
}'Response rules
The body is Markdown in
result.content[0].text.The shippable country is a
PRODUCT_SHIPPING_REGIONSregion code derived fromcurrency:KRW→KR,USD→US,JPY→JP. Field labels follow that currency (Korean, English, Japanese).The title is always
title.title_enandtitle_jaare not returned.The image is always
origin_img_url, including for non-Amazon products. Theimagecolumn is never returned. Iforigin_img_urlis empty, the image line is the localized word for none.Saleplaza page:
KRW→https://saleplaza.com/{id},USD→https://saleplaza.com/en/{id},JPY→https://saleplaza.com/ja/{id}. The buy link is thelinkcolumn.Dealchelin stars are computed from
sp_score(85+ is 3, 70+ is 2, otherwise 1). It is not a database column.A non-numeric
idreturns an error sentence. An unknown id and a hidden product (is_visibleis not 1) return the same "not in the vault" sentence, with no title, price, link, or image.
Response fields, in order
Labels below are the Korean (KRW) names. USD uses the English names, JPY the Japanese names.
Field | KRW label | USD label | JPY label |
id | 상품 ID | Product ID | 商品ID |
title | 제목 | Title | タイトル |
shipping region code | 배송가능국가 | Ships to | 配送可能国 |
platform | 플랫폼 | Platform | プラットフォーム |
category | 카테고리 | Category | カテゴリ |
origin_img_url | 이미지 | Image | 画像 |
Saleplaza URL | 세일프라자 | Saleplaza | セールプラザ |
link | 구매 링크 | Buy link | 購入リンク |
original_price | 원래 가격 | Original | 元の価格 |
price | 지금 혜택가 | Deal Price | 特価 |
discount | 할인 | Discount | 割引 |
target_price | 목표가 | Target price | 目標価格 |
price_history | 가격 히스토리 | Price history | 価格履歴 |
lowest in history | 기간 내 최저가 | Lowest in range | 期間内最安値 |
highest in history | 기간 내 최고가 | Highest in range | 期間内最高値 |
current vs first history row | 첫 기록 대비 현재가 | Current vs first record | 最初の記録と比べた現在価格 |
deal_status | 딜 상태 | Deal status | ディール状態 |
deal_checked_at | 딜 확인 시각 | Deal checked at | ディール確認時刻 |
sp_score | SP Score | SP Score | SP Score |
computed stars | 딜슐랭 | Dealchelin | ディールシュラン |
customer_grade | 고객 등급 | Customer grade | 顧客グレード |
buyking_comment | 바이킹 曰 | BuyKing says | バイキング曰く |
recommend_reason | 추천 이유 | Recommend reason | おすすめ理由 |
click_count | 클릭 수 | Clicks | クリック数 |
likes_count | 좋아요 | Likes | いいね |
dislikes_count | 싫어요 | Dislikes | よくない |
opinion_cnt | 의견 수 | Opinions | 意見数 |
created_at | 등록 시각 | Listed at | 登録日時 |
price_history is a list of { date: "YYYY-MM-DD", price } rows, newest dates last, at most 10. When history exists, the three summary lines follow that list. When it is missing or not valid JSON, the history line says there is no record yet and the summary lines are omitted.
KR (KRW, Korean labels):
- 상품 ID: 25023
- 제목: ...
- 배송가능국가: KR
- 플랫폼: ali
- 카테고리: ...
- 이미지: https://ae-pic-a1.aliexpress-media.com/...jpg
- 세일프라자: https://saleplaza.com/25023
- 구매 링크: https://...
- 원래 가격: KRW 3,261
- 지금 혜택가: KRW 3,250
- 할인: 1%
- 목표가: KRW 2,500
- 가격 히스토리:
- 2026-10-04: KRW 35,900
- 기간 내 최저가: KRW 35,900
- 기간 내 최고가: KRW 35,900
- 첫 기록 대비 현재가: KRW 0
- 딜 상태: ...
- 딜 확인 시각: ...
- SP Score: 74
- 딜슐랭: 2성
- 고객 등급: ...
- 바이킹 曰: ...
- 추천 이유: ...
- 클릭 수: 0
- 좋아요: 0
- 싫어요: 0
- 의견 수: 0
- 등록 시각: 2026-10-01T15:00:01.000ZUS (USD, English labels):
- Product ID: 25023
- Title: ...
- Ships to: US
- Platform: amazon
- Category: ...
- Image: https://m.media-amazon.com/...jpg
- Saleplaza: https://saleplaza.com/en/25023
- Buy link: https://...
- Original: USD 29.9
- Deal Price: USD 19.9
- Discount: 33%
- Target price: none
- Price history:
- 2026-09-01: USD 25
- 2026-09-20: USD 19.9
- Lowest in range: USD 19.9
- Highest in range: USD 25
- Current vs first record: USD -5.1
- Deal status: ...
- Deal checked at: ...
- SP Score: 88
- Dealchelin: 3-star
- Customer grade: ...
- BuyKing says: ...
- Recommend reason: ...
- Clicks: 0
- Likes: 0
- Dislikes: 0
- Opinions: 0
- Listed at: 2026-10-01T15:00:01.000ZJP (JPY, Japanese labels):
- 商品ID: 25023
- タイトル: ...
- 配送可能国: JP
- プラットフォーム: jp-amazon
- カテゴリ: ...
- 画像: https://m.media-amazon.com/...jpg
- セールプラザ: https://saleplaza.com/ja/25023
- 購入リンク: https://...
- 元の価格: JPY 1,980
- 特価: JPY 1,480
- 割引: 25%
- 目標価格: なし
- 価格履歴:
- 2026-10-04: JPY 1,980
- 期間内最安値: JPY 1,480
- 期間内最高値: JPY 1,980
- 最初の記録と比べた現在価格: JPY -500
- ディール状態: ...
- ディール確認時刻: ...
- SP Score: 74
- ディールシュラン: 2つ星
- 顧客グレード: ...
- バイキング曰く: ...
- おすすめ理由: ...
- クリック数: 0
- いいね: 0
- よくない: 0
- 意見数: 0
- 登録日時: 2026-10-01T15:00:01.000Z✨ [v1.2.1 New] Enhanced Multilingual Global Search
Find global shopping hot deals smarter without language barriers!
Massive Multilingual Dictionary Built-in: Accurately and instantly matches global products without AI mistranslation (e.g., translating "mouse" to an animal) using a hashmap of 1,000+ core shopping keywords (English, Japanese ↔ Korean).
Smart Priority Sorting by Input Language: Automatically detects the user's input language (English, Japanese, Korean) in 0.1 seconds and prioritizes hot deals using that country's currency (USD, JPY, KRW) to the top. (e.g., searching for
applein English will show 🇺🇸US products first!)
Provided Tools — 6
🌍 Global Search
search_buyking_semantic: Semantically searches hot deals worldwide without borders. Each product is labeled with a shipping country code (🇰🇷KR/🇺🇸US/🇯🇵JP).
🇰🇷 Korea Exclusive
search_buyking_semantic_KR: Searches only hot deals directly shippable within Korea. KRW(₩) pricing, Korean results.
🇺🇸 US Exclusive
search_buyking_semantic_US: US-deliverable hot deals only. USD($) pricing, English results.
🇯🇵 Japan Exclusive
search_buyking_semantic_JP: Searches only hot deals deliverable within Japan. JPY(¥) pricing, Japanese results.
🔎 Product Detail
result_detail_GLOBAL: Fetches one product and its price history by the product ID from a search result. The shippable country is a region code fromcurrency, matchingPRODUCT_SHIPPING_REGIONS(KRW→KR,USD→US,JPY→JP). Parameterid(required).
ℹ️ Server Info
get_server_info: Returns the version information and feature list of the BuyKing MCP server.
Common Parameters
All search tools support the same parameters:
Parameter | Type | Required | Description | Example |
| string | ✅ | Product keyword to search | "wireless mouse", "earbuds" |
| string | ❌ | Category filter | "💻 IT/Electronics/Digital" |
| string | ❌ | Platform filter | "amazon", "aliexpress" |
| string | ❌ | Sort condition | "newest", "price_asc", "price_desc" |
Server Endpoints
HTTP JSON-RPC:
https://buyking.saleplaza.com/messageMCP Discovery:
https://buyking.saleplaza.com/.well-known/mcp.jsonLLMs.txt:
https://buyking.saleplaza.com/llms.txt
Related MCP server: admitad-mcp
📦 Installation
npm install buyking-mcp🔧 Configuration
Using in Claude Desktop
Add the following to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"buyking-mcp": {
"command": "npx",
"args": ["-y", "buyking-mcp@latest"]
}
}
}💡 Tip: Using the
@latesttag ensures you always have the latest version installed, preventing cache issues.
🔌 Direct API Call
https://buyking.saleplaza.com/message counts each caller IP.
Every
POST /messagecounts toward 30 requests per minute.Search tools and
result_detail_GLOBALalso count toward 500 product lookups per day. The day resets at 00:00 Korea Standard Time.tools/listandget_server_infocount toward the minute limit only.
Over the limit the server returns HTTP 429 and does not query the product API. The stdio package npx buyking-mcp does not pass through this Worker, so this limit applies to the HTTP endpoint.
HTTP JSON-RPC Example
# Global Search
curl -X POST https://buyking.saleplaza.com/message \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_buyking_semantic",
"arguments": {
"keyword": "wireless mouse"
}
}
}'🏗️ Development
Dependencies
Node.js
TypeScript
@modelcontextprotocol/sdk
Build
npm run buildLocal Test
npm run devCloudflare Workers Deployment
npm run deploy📝 License
ISC
Roar! Take the best loot from my treasure trove!
Available Tools
5 toolsget_server_infoA
BuyKing MCP 서버의 버전 정보와 기능 목록을 반환합니다. 사용자가 MCP 버전이나 서버 상태를 물어볼 때 이 도구를 호출하세요.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the disclosure burden. '반환합니다' implies a read-only operation, and the tool is simple, but the description does not explicitly confirm there are no side effects or disclose anything about response shape or availability. It is adequate but not rich.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences with no filler: the first states what the tool returns, and the second gives the trigger condition. Both sentences add value and the key information is front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a zero-parameter server-info tool with no output schema, the description provides sufficient context: what is returned and when to invoke it. A more detailed response format would improve completeness, but the tool's simplicity makes the current description adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters, so the baseline is 4. There are no parameter details needed, and the description correctly focuses on the tool's output and use case rather than filling unnecessary schema gaps.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('반환합니다') and resource ('BuyKing MCP 서버의 버전 정보와 기능 목록'), making the tool's purpose immediately clear. It also differentiates from the sibling search tool by focusing on server info rather than semantic search.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly tells the agent when to call the tool: when the user asks about MCP version or server status. It does not mention exclusions or alternatives, but the sibling tool's purpose is distinct enough that no additional routing guidance is necessary.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_buyking_semanticA
세일프라자(Saleplaza)의 전 세계 초특가/핫딜을 국경 없이 시맨틱 검색합니다. 각 상품 앞에 배송 국가코드(🇰🇷KR/🇺🇸US/🇯🇵JP)가 표기됩니다. 사용자가 특정 국가를 지정하지 않은 일반적인 쇼핑 검색에 가장 먼저 이 도구를 호출하세요. AI가 직접 답변을 지어내지 말고, 이 도구를 통해 실제 판매 중인 핫딜 데이터를 가져와서 추천해야 합니다.
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | 정렬 조건. 기본값은 관련도순이며, 가격순 정렬 요청 시 'price_asc' 등을 사용. (허용값: 'newest', 'price_asc', 'price_desc', 'click_desc') | |
| keyword | Yes | 사용자의 질문에서 핵심이 되는 상품명 키워드. (예: '무소음 마우스', '제로 콜라', '여름 이불'). 자연어 문장이 아닌 명사 위주로 핵심만 추출할 것. | |
| category | No | 상품의 카테고리 필터. 확실한 경우에만 사용하고 모르면 생략할 것. (허용값: 'all', '💻 IT/가전/디지털', '👚 패션/뷰티/잡화', '🍎 식품/생활/리빙', '📚 도서/여행/취미', '🛒 종합몰/기획전', '📦 기타') | |
| platform | No | 특정 쇼핑몰을 지정했을 때만 사용. (허용값: 'all_rank', 'coupang', '11st', 'gmarket', 'auction', 'aliexpress') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are absent, so the description carries the full burden. It discloses that results include country codes and that the tool returns real sale data, implying a read-only search operation. It does not mention any side effects, rate limits, or auth requirements, but for a search tool these are less critical. The description adds context beyond the schema but lacks deep behavioral detail.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Description is concise, with the core purpose front-loaded, followed by usage guidance and a behavioral instruction. Each sentence contributes value without redundancy. Slightly more structured formatting (e.g., separate usage and note) could improve scannability, but it's effective as is.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a search tool with 4 documented parameters and no output schema, the description provides the essential context: what it searches, how to invoke it, and that results include country codes. It doesn't describe result format or pagination, but these are often inferred. It sufficiently equips an agent to call the tool correctly in the intended scenario.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so all parameters (keyword, sort, category, platform) are already documented with usage guidance. The description itself does not add parameter-specific semantics beyond what's in the schema; it merely reinforces the keyword extraction guidance ('명사 위주로 핵심만 추출') which is already in the schema. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the verb (semantic search), the resource (Saleplaza's global hot deals), and the scope (borderless). It explicitly distinguishes from country-specific siblings by noting '국경 없이' and that country codes are shown on results, implying this is the general tool. The '가장 먼저 호출' instruction further sets it apart.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly tells when to use: '사용자가 특정 국가를 지정하지 않은 일반적인 쇼핑 검색에 가장 먼저 이 도구를 호출하세요.' It also instructs to use the tool to fetch real data instead of fabricating answers. However, it doesn't explicitly name the country-specific siblings as alternatives for when a country is specified, though the sibling names make that obvious.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_buyking_semantic_JPA
[日本専用] 日本国内配送可能なホットディールのみ検索します。JPY(¥)価格、日本語結果。ユーザーが日本にいるか、日本配送商品を希望する場合に使用してください。Amazon JPなど日本配送対応プラットフォームのホットディールを検索します。
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | 정렬 조건. 기본값은 관련도순이며, 가격순 정렬 요청 시 'price_asc' 등을 사용. (허용값: 'newest', 'price_asc', 'price_desc', 'click_desc') | |
| keyword | Yes | 사용자의 질문에서 핵심이 되는 상품명 키워드. (예: '무소음 마우스', '제로 콜라', '여름 이불'). 자연어 문장이 아닌 명사 위주로 핵심만 추출할 것. | |
| category | No | 상품의 카테고리 필터. 확실한 경우에만 사용하고 모르면 생략할 것. (허용값: 'all', '💻 IT/가전/디지털', '👚 패션/뷰티/잡화', '🍎 식품/생활/리빙', '📚 도서/여행/취미', '🛒 종합몰/기획전', '📦 기타') | |
| platform | No | 특정 쇼핑몰을 지정했을 때만 사용. (허용값: 'all_rank', 'coupang', '11st', 'gmarket', 'auction', 'aliexpress') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description compensates by disclosing behavioral scope: only hot deals are returned, results are in Japanese, prices are in JPY, and only Japan-deliverable platforms are covered. It could add result format or side-effect details, but for a search tool this provides solid expectations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The JP-only scope is front-loaded, but the first and last sentences repeat the same ideas: Japan delivery, hot deals, and searching. It could be tightened to two sentences without losing clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 4-parameter search tool with no annotations and no output schema, the description provides the key selection context: geographic relevance, currency, language, and delivery scope. The schema fills in parameter details, and missing result-pagination/format notes are minor for this read-oriented tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and all four parameters already have detailed descriptions, so the baseline is 3. The description adds locale/currency context but no parameter-level meaning; the Amazon JP mention is illustrative and not aligned with the platform enum values, so it does not improve parameter selection reliability.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool as a search for Japan-deliverable hot deals, with JPY pricing and Japanese results. It distinguishes this JP variant from sibling KR/US tools by stating the geographic scope and delivery condition directly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives an explicit condition: use when the user is in Japan or wants Japan-delivery products. However, it does not explicitly name the sibling KR/US tools as alternatives or state 'do not use for other regions,' so it stops short of full when-not guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_buyking_semantic_KRA
[한국 전용] 한국 내 직배송 가능한 핫딜만 검색합니다. KRW(₩) 가격, 한국어 결과. 사용자가 한국에 있거나 한국 배송 상품을 원할 때 사용하세요. 쿠팡, 11번가, G마켓, 옥션, 알리익스프레스 등 국내외 쇼핑몰의 핫딜을 검색합니다.
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | 정렬 조건. 기본값은 관련도순이며, 가격순 정렬 요청 시 'price_asc' 등을 사용. (허용값: 'newest', 'price_asc', 'price_desc', 'click_desc') | |
| keyword | Yes | 사용자의 질문에서 핵심이 되는 상품명 키워드. (예: '무소음 마우스', '제로 콜라', '여름 이불'). 자연어 문장이 아닌 명사 위주로 핵심만 추출할 것. | |
| category | No | 상품의 카테고리 필터. 확실한 경우에만 사용하고 모르면 생략할 것. (허용값: 'all', '💻 IT/가전/디지털', '👚 패션/뷰티/잡화', '🍎 식품/생활/리빙', '📚 도서/여행/취미', '🛒 종합몰/기획전', '📦 기타') | |
| platform | No | 특정 쇼핑몰을 지정했을 때만 사용. (허용값: 'all_rank', 'coupang', '11st', 'gmarket', 'auction', 'aliexpress') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses the scope (Korea-only, direct shipping, KRW, Korean results) but does not disclose behaviors like default sort order, result limits, or return format. For a read-oriented search tool, this is adequate but not exhaustive.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with the most important scoping information (Korea-only, direct shipping, KRW). No filler or redundancy. Every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the 4 parameters are fully documented in the schema and no output schema exists, the description provides sufficient context for usage and scope. The only gap is the return format, which is not critical for a search tool. Overall, it is complete enough for an agent to call correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds no parameter-specific details beyond the schema; it only provides contextual scope (KRW, Korean results) that doesn't map to a particular parameter. No additional semantic value.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('search') with a clear scope: Korea-only direct-shipping hot deals, KRW prices, and Korean results. It explicitly distinguishes itself from the US and JP siblings by name and region, so an agent can immediately tell it apart.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It clearly states when to use: 'when the user is in Korea or wants Korea shipping.' It does not explicitly list exclusions or mention the US/JP alternatives, but the regional scope makes the choice obvious given sibling names. Could be more explicit about the alternatives, but it's sufficient.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_buyking_semantic_USA
[USA Only] Search hot deals deliverable within the United States. USD ($) pricing, English results. Use when the user is in the US or wants US-deliverable products. Covers Amazon US and other platforms with US shipping.
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | 정렬 조건. 기본값은 관련도순이며, 가격순 정렬 요청 시 'price_asc' 등을 사용. (허용값: 'newest', 'price_asc', 'price_desc', 'click_desc') | |
| keyword | Yes | 사용자의 질문에서 핵심이 되는 상품명 키워드. (예: '무소음 마우스', '제로 콜라', '여름 이불'). 자연어 문장이 아닌 명사 위주로 핵심만 추출할 것. | |
| category | No | 상품의 카테고리 필터. 확실한 경우에만 사용하고 모르면 생략할 것. (허용값: 'all', '💻 IT/가전/디지털', '👚 패션/뷰티/잡화', '🍎 식품/생활/리빙', '📚 도서/여행/취미', '🛒 종합몰/기획전', '📦 기타') | |
| platform | No | 특정 쇼핑몰을 지정했을 때만 사용. (허용값: 'all_rank', 'coupang', '11st', 'gmarket', 'auction', 'aliexpress') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the burden of behavioral disclosure. It discloses the regional scope, currency, language, and inventory coverage, but does not describe result volume, ordering, pagination, or any limitations such as coverage gaps. For a search tool this is adequate but not rich.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact, information-dense, and front-loaded with the most important discriminator ('USA Only'). Every sentence earns its place: scope, pricing/language, when to use, and coverage.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simple search-tool shape, complete schema documentation, and no output schema, the description covers the key contextual needs: region, currency, language, and delivery scope. It could additionally describe the output format or result limit, but nothing critical is missing for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and the parameter descriptions already explain keyword extraction, sort values, category usage, and platform constraints. The tool description adds no parameter-level meaning beyond the schema, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description specifies a concrete verb and resource: search hot deals deliverable within the United States. It clearly distinguishes itself from regional siblings by front-loading '[USA Only]' and stating USD pricing and English results. This lets an agent select it confidently over search_buyking_semantic_KR or _JP.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It explicitly states when to use the tool: when the user is in the US or wants US-deliverable products. It does not explicitly name alternative regional tools or give exclusion criteria, but the regional usage condition is clear enough given the sibling names.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
3 tool updates
v1.2.1- Added
search_buyking_semantic_JP - Added
search_buyking_semantic_KR - Added
search_buyking_semantic_US
2 tool updates
v1.1.2- First observed
get_server_info - First observed
search_buyking_semantic
TDQS
Scored across 5 tools
The four search tools are clearly differentiated by country/region (global, KR, US, JP), but the global search_buyking_semantic overlaps with the country-specific ones since it also returns results with shipping country codes. An agent might be unsure whether to call the global tool or a region-specific one for a user in a particular country.
The search tools follow a consistent pattern: search_buyking_semantic with optional country suffix (_KR, _US, _JP). get_server_info breaks the pattern slightly by using a different verb and resource, but it is a distinct utility and the naming is still clear.
Five tools is a reasonable, focused count for a shopping search server. The four search variants plus one info tool are justified by the regional shipping use case, though the global search tool makes the set feel slightly redundant with the region-specific ones.
The server covers the core search use case well across multiple regions, but it lacks any product detail, price history, or link/redirect tools. For a hot-deals shopping server, one might expect at least a way to fetch more details about a specific deal or product after searching.
Maintenance
Related MCP Connectors
AI-powered product search, affiliate links, and price negotiation for e-commerce platforms
AI-agent product catalog: search, lookup & purchase routing over verified merchant data.
Product price checks and affiliate link building for AI shopping agents.
Product search for AI agents: Amazon + Shopify, cart-to-checkout buy path. Pay-per-call, no API key.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI models to find the best online deals by browsing and interacting with multiple shopping platforms like Amazon and eBay across various regions. It uses Playwright to automate searches and retrieve product information from compatible e-commerce and deal-tracking websites.30 npm3MIT
- FlicenseAqualityDmaintenanceEnables AI assistants to browse Admitad affiliate programs, discover product feeds, and search products directly from chat.282-
- AlicenseAqualityDmaintenanceEnables AI assistants to search products and generate affiliate links across European and global affiliate networks, automating product discovery and link creation for monetization.5MIT
- FlicenseAqualityDmaintenanceEnables AI-powered shopping assistance by analyzing natural language shopping queries and automating product searches on multiple e-commerce platforms.14-