BayDeep — E-commerce MCP Gateway
E-commerce MCP gateway: live product deals, attributed buy links, order tracking, flights.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"baydeep": {
"url": "https://mcp.baydeep.com/mcp"
}
}
}Remote endpoints
https://mcp.baydeep.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟡mint_free_key(client_ref)
SELF-SERVE a free API key — NO signup, NEVER expires, unlocks ALL tools (live AliExpress search, hot products, attributed convert links, your orders). Call this FIRST if any other tool says a key is required. Store the returned key and send it as X-API-Key header (or Authorization: Bearer) on subsequent calls. Rate limit: 30 req/min. Attribution is bound to this key. Optional client_ref ([A-Za-z0-9-], <=40) = your own end-user id, echoed back on your orders.
Input Schema
{
"type": "object",
"properties": {
"client_ref": {
"type": "string",
"description": "optional: your stable anonymized end-user id ([A-Za-z0-9-], <=40)"
}
}
}🟢search_products(q, page, page_size, sort, category_id, ...)
LIVE AliExpress affiliate product search (100M+ item pool, ships to 200+ countries; prices in the target currency). Consumes platform quota — do not poll; prefer shelf_search for repeated lookups. Returns items with price, coupon, sales, rating, commission_rate and detail_url. Read-only. Requires a free API key.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"page": {
"type": "number",
"default": 1
},
"page_size": {
"type": "number",
"default": 10,
"maximum": 50
},
"sort": {
"type": "string",
"description": "SALE_PRICE_ASC | SALE_PRICE_DESC | AVERAGE_RATE_ASC | AVERAGE_RATE_DESC | ORDINAL_ASC | ORDINAL_DESC"
},
"category_id": {
"type": "string"
},
"ship_to": {
"type": "string",
"description": "ISO country code, default US"
},
"currency": {
"type": "string",
"default": "USD"
},
"language": {
"type": "string",
"default": "EN"
}
},
"required": [
"q"
]
}🟢hot_products(page, page_size, category_id, ship_to, currency, ...)
LIVE AliExpress hot-selling products (no keyword; optional category). Good for "what's trending" / deal feeds. Consumes platform quota. Read-only. Requires a free API key.
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "number",
"default": 1
},
"page_size": {
"type": "number",
"default": 10,
"maximum": 50
},
"category_id": {
"type": "string"
},
"ship_to": {
"type": "string"
},
"currency": {
"type": "string"
},
"language": {
"type": "string"
}
}
}🟢product_detail(product_ids)
Full detail for up to 10 AliExpress product ids (comma separated or array). Read-only. Requires a free API key.
Input Schema
{
"type": "object",
"properties": {
"product_ids": {
"type": "string",
"description": "comma separated ids, max 10"
}
},
"required": [
"product_ids"
]
}⚪convert_link(urls, link_type)
Convert any aliexpress.com product/shop/search URL(s) into YOUR affiliate-attributed link(s) (max 10 per call). ALWAYS run items through this before presenting a buy link — attribution is how agent-driven purchases are tracked. Requires a free API key.
Input Schema
{
"type": "object",
"properties": {
"urls": {
"type": "string",
"description": "comma separated URLs, max 10"
},
"link_type": {
"type": "number",
"enum": [
0,
2
],
"description": "2=short link (default), 0=original"
}
},
"required": [
"urls"
]
}⚪affiliate_orders(start_time, end_time, status, page, page_size)
YOUR attributed affiliate orders in a time range (source for your commission settlement & refund tracking). Orders are filtered to your key's tracking_id; each order carries share_eligible + share_amount and the page ends with share_summary — each order carries share_eligible and share_amount fields. Requires a free API key.
Input Schema
{
"type": "object",
"properties": {
"start_time": {
"type": "string",
"description": "ISO 8601 or yyyy-MM-dd HH:mm:ss (UTC assumed). DEFAULT: 90 days ago"
},
"end_time": {
"type": "string",
"description": "DEFAULT: now"
},
"status": {
"type": "string",
"description": "PENDING | PAID | CLOSED ..."
},
"page": {
"type": "number"
},
"page_size": {
"type": "number",
"maximum": 50
}
}
}⚪categories
AliExpress affiliate category tree (for building category filters or browse UX). Requires a free API key.
Input Schema
{
"type": "object",
"properties": {}
}🟢catalog_overview
WHAT BAYDEEP SELLS: product types currently in the catalog (physical goods from AliExpress, flight fares via Travelpayouts/Aviasales), item counts, top categories, and HOW to search/book each type. Call this FIRST when unsure what the catalog contains. Works WITHOUT any API key. Read-only.
Input Schema
{
"type": "object",
"properties": {}
}🟢flight_search(origin, destination, date, page_size)
Search FLIGHT FARES in the catalog (Aviasales/Travelpayouts partners, fares refreshed daily). Filter by origin/destination IATA code (e.g. PEK, JFK, SIN) and optional departure date (YYYY-MM-DD). Items sorted by price; book_url is ALREADY affiliate-attributed — link the user straight to it (no convert_link needed). Works WITHOUT any API key. Read-only.
Input Schema
{
"type": "object",
"properties": {
"origin": {
"type": "string",
"description": "origin IATA code, e.g. PEK"
},
"destination": {
"type": "string",
"description": "destination IATA code, e.g. SIN"
},
"date": {
"type": "string",
"description": "departure date YYYY-MM-DD (optional)"
},
"page_size": {
"type": "number",
"default": 20,
"maximum": 50
}
}
}🟢shelf_search(q, sort, price_min, price_max, page, ...)
Search the LOCAL shelf — physical goods (AliExpress) AND flight fares (Travelpayouts). No platform quota consumed — works WITHOUT any API key (30 req/min per IP). sort=relevance(default when q given)|price|sales|latest; price_min/price_max filter. Goods items carry detail_url (attribute via convert_link with a free key); flight items carry book_url directly. Read-only.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"sort": {
"type": "string",
"enum": [
"relevance",
"price",
"sales",
"latest"
]
},
"price_min": {
"type": "number"
},
"price_max": {
"type": "number"
},
"page": {
"type": "number",
"default": 1
},
"page_size": {
"type": "number",
"default": 20,
"maximum": 50
}
}
}🟢shelf_item(goods_id)
Get one LOCAL shelf item by goods_id (full normalized fields; works for goods and flight fares). Works WITHOUT any API key. Read-only.
Input Schema
{
"type": "object",
"properties": {
"goods_id": {
"type": "string"
}
},
"required": [
"goods_id"
]
}Community
Evidence