BayDeep — E-commerce MCP Gateway is an MCP server published by io.github.MeshTok, hosted at mcp.baydeep.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 11 tools, including mint_free_key, search_products, hot_products, product_detail, convert_link.
E-commerce MCP gateway: live product deals, attributed buy links, order tracking, flights.
Nothing else in the archive shares these values.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| client_ref | string | optional: your stable anonymized end-user id ([A-Za-z0-9-], <=40) |
{
"name": "mint_free_key",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"client_ref": {
"type": "string",
"description": "optional: your stable anonymized end-user id ([A-Za-z0-9-], <=40)"
}
}
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
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.
| Parameter | Type | Description |
|---|---|---|
| q * | string | |
| page | number | |
| sort | string | SALE_PRICE_ASC | SALE_PRICE_DESC | AVERAGE_RATE_ASC | AVERAGE_RATE_DESC | ORDINAL_ASC | ORDINAL_DESC |
| ship_to | string | ISO country code, default US |
| currency | string | |
| language | string | |
| page_size | number | |
| category_id | string |
{
"name": "search_products",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string"
},
"page": {
"type": "number",
"default": 1
},
"sort": {
"type": "string",
"description": "SALE_PRICE_ASC | SALE_PRICE_DESC | AVERAGE_RATE_ASC | AVERAGE_RATE_DESC | ORDINAL_ASC | ORDINAL_DESC"
},
"ship_to": {
"type": "string",
"description": "ISO country code, default US"
},
"currency": {
"type": "string",
"default": "USD"
},
"language": {
"type": "string",
"default": "EN"
},
"page_size": {
"type": "number",
"default": 10,
"maximum": 50
},
"category_id": {
"type": "string"
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | number | |
| ship_to | string | |
| currency | string | |
| language | string | |
| page_size | number | |
| category_id | string |
{
"name": "hot_products",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"page": {
"type": "number",
"default": 1
},
"ship_to": {
"type": "string"
},
"currency": {
"type": "string"
},
"language": {
"type": "string"
},
"page_size": {
"type": "number",
"default": 10,
"maximum": 50
},
"category_id": {
"type": "string"
}
}
}
}Full detail for up to 10 AliExpress product ids (comma separated or array). Read-only. Requires a free API key.
| Parameter | Type | Description |
|---|---|---|
| product_ids * | string | comma separated ids, max 10 |
{
"name": "product_detail",
"description": "Full detail for up to 10 AliExpress product ids (comma separated or array). Read-only. Requires a free API key.",
"inputSchema": {
"type": "object",
"required": [
"product_ids"
],
"properties": {
"product_ids": {
"type": "string",
"description": "comma separated ids, max 10"
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| urls * | string | comma separated URLs, max 10 |
| link_type | number | 2=short link (default), 0=original |
{
"name": "convert_link",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"urls"
],
"properties": {
"urls": {
"type": "string",
"description": "comma separated URLs, max 10"
},
"link_type": {
"enum": [
0,
2
],
"type": "number",
"description": "2=short link (default), 0=original"
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | number | |
| status | string | PENDING | PAID | CLOSED ... |
| end_time | string | DEFAULT: now |
| page_size | number | |
| start_time | string | ISO 8601 or yyyy-MM-dd HH:mm:ss (UTC assumed). DEFAULT: 90 days ago |
{
"name": "affiliate_orders",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"page": {
"type": "number"
},
"status": {
"type": "string",
"description": "PENDING | PAID | CLOSED ..."
},
"end_time": {
"type": "string",
"description": "DEFAULT: now"
},
"page_size": {
"type": "number",
"maximum": 50
},
"start_time": {
"type": "string",
"description": "ISO 8601 or yyyy-MM-dd HH:mm:ss (UTC assumed). DEFAULT: 90 days ago"
}
}
}
}AliExpress affiliate category tree (for building category filters or browse UX). Requires a free API key.
No parameters.
{
"name": "categories",
"description": "AliExpress affiliate category tree (for building category filters or browse UX). Requires a free API key.",
"inputSchema": {
"type": "object",
"properties": {}
}
}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.
No parameters.
{
"name": "catalog_overview",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| date | string | departure date YYYY-MM-DD (optional) |
| origin | string | origin IATA code, e.g. PEK |
| page_size | number | |
| destination | string | destination IATA code, e.g. SIN |
{
"name": "flight_search",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "departure date YYYY-MM-DD (optional)"
},
"origin": {
"type": "string",
"description": "origin IATA code, e.g. PEK"
},
"page_size": {
"type": "number",
"default": 20,
"maximum": 50
},
"destination": {
"type": "string",
"description": "destination IATA code, e.g. SIN"
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| q | string | |
| page | number | |
| sort | string | one of ["relevance","price","sales","latest"] |
| page_size | number | |
| price_max | number | |
| price_min | number |
{
"name": "shelf_search",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"q": {
"type": "string"
},
"page": {
"type": "number",
"default": 1
},
"sort": {
"enum": [
"relevance",
"price",
"sales",
"latest"
],
"type": "string"
},
"page_size": {
"type": "number",
"default": 20,
"maximum": 50
},
"price_max": {
"type": "number"
},
"price_min": {
"type": "number"
}
}
}
}Get one LOCAL shelf item by goods_id (full normalized fields; works for goods and flight fares). Works WITHOUT any API key. Read-only.
| Parameter | Type | Description |
|---|---|---|
| goods_id * | string |
{
"name": "shelf_item",
"description": "Get one LOCAL shelf item by goods_id (full normalized fields; works for goods and flight fares). Works WITHOUT any API key. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"goods_id"
],
"properties": {
"goods_id": {
"type": "string"
}
}
}
}BayDeep — the e-commerce plugin for AI agents (AliExpress affiliate gateway, 100M+ item pool, 200+ ship-to countries). OPEN ACCESS — NO signup required: shelf_search / shelf_item work without any key (30 req/min per IP), and you can SELF-SERVE a free API key by calling the mint_free_key tool right here (never expires, unlocks ALL tools incl. live search + attributed links + your commission). Mint it once, store it, and send it as X-API-Key on subsequent calls. A HTTP fallback also exists: POST https://api.baydeep.com/v1/trial. SHOPPING FLOW (most common): 1. search_products with the user ask (q may be natural language; sort=SALE_PRICE_ASC when the user stresses cheap). For repeated/simple lookups prefer shelf_search (quota-free, no key needed). 2. product_detail on shortlisted ids for full fields. 3. convert_link EVERY url you are about to show as a buy link — attributed links are how agent-driven purchases are tracked to your key. Always present the converted link to the user. POLICY: never recommend medicines or give medical advice. Never put words like cashback/rebate in front of consumers — your share is your business revenue, not a user reward. The user always pays on AliExpress directly; agents never touch money. RATE LIMITS: search_products / hot_products / product_detail consume platform quota — do not poll or batch-poll them; prefer shelf tools for repeated lookups. SETTLEMENT: affiliate_orders returns your attributed orders (filtered by your tracking_id) with share_eligible / share_amount per order and a share_summary — the commission partnership dataset. YOUR USERS (optional): pass client_ref ([A-Za-z0-9-], <=40) when minting your key — echoed back on order responses so you can run your own user rewards; the server never interprets it.
Names, descriptions and schemas were written by the server and are shown as data.