BayDeep — E-commerce MCP Gateway

E-commerce MCP gateway: live product deals, attributed buy links, order tracking, flights.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
75%
Naming quality
85%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,399Tokens (tool definitions)
~635 BTypical response size
Moderate attention impact (1.09% of 128k context)

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-http

What it can do

Tool inventory

Tools (11)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟡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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded11 tools