● Live — registered in the official MCP Registry (io.github.MeshTok/baydeep)

Documentation

Connect your AI agent to a live commerce catalog: 7,000+ AliExpress products and 188 flight fares, with attributed buy links and commission share for your agent.

Endpoints

Interface	URL	Auth
MCP (Streamable HTTP)	`https://mcp.baydeep.com/mcp`	keyless tools + key tools
REST	`https://api.baydeep.com/v1`	same, via headers
Consumer site	leapbest.com	—

Authentication

Mint a free key in one click (console ↗) — no signup, never expires.

# mint (one call, zero signup)
curl -X POST https://api.baydeep.com/v1/trial -H "Content-Type: application/json" -d '{"client_ref":"my-agent"}'

Send the key on every call:

# either header works
X-API-Key: bd_xxxxxxxx
Authorization: Bearer bd_xxxxxxxx

Keyless tier: catalog_overview · flight_search · shelf_search · shelf_item work WITHOUT a key (30 req/min per IP). Live platform tools require the free key. Rate limit with key: 30 req/min.

MCP tools (11)

Tool	Key	What it does
`catalog_overview`	keyless	Product types, counts, top categories and how-to — call first when unsure what the catalog contains
`flight_search`	keyless	Flight fares by origin/destination IATA + date; `book_url` is pre-attributed
`shelf_search`	keyless	Search 7,000+ stocked goods + fares; sort price/sales/latest, price filters
`shelf_item`	keyless	One shelf item by goods_id (full normalized fields)
`search_products`	key	Live AliExpress search (100M+ pool, target currency)
`hot_products`	key	Live AliExpress trending products
`product_detail`	key	Detail for up to 10 product ids
`convert_link`	key	Convert any aliexpress URL(s) into YOUR attributed affiliate links (max 10)
`affiliate_orders`	key	Your attributed orders + commission share summary (settlement source)
`categories`	key	AliExpress category tree
`mint_free_key`	—	Self-serve key minting (also available as REST POST /v1/trial)

Quickstart — 3 calls

# 1. mint a key
curl -X POST https://api.baydeep.com/v1/trial -H "Content-Type: application/json" -d '{}'

# 2. search the shelf (also works keyless)
curl "https://api.baydeep.com/v1/shelf?q=air%20fryer&page_size=5"

# 3. attribute your buy link (key)
curl -X POST https://api.baydeep.com/v1/convert -H "X-API-Key: bd_xxx" \
  -H "Content-Type: application/json" -d '{"urls":"https://www.aliexpress.com/item/3256813111870438.html"}'

JavaScript (fetch)

const r = await fetch('https://api.baydeep.com/v1/shelf?q=air+fryer');
const { items } = await r.json();
items.forEach(i => console.log(i.title, i.price, i.detail_url));

Python (requests)

import requests
r = requests.get("https://api.baydeep.com/v1/shelf", params={"q": "air fryer", "page_size": 5})
for i in r.json()["items"]: print(i["title"], i["price"])

MCP client config

{
  "mcpServers": {
    "baydeep": { "url": "https://mcp.baydeep.com/mcp" }
  }
}

Commission & rules

Agent earnings: commission share on commission-eligible orders (product commission rate above program threshold). Attribution is bound to your key's tracking id — always run buy links through convert_link. Flight book_urls are pre-attributed.

Keyless limits: 30 req/min per IP, shelf tools only. Free key: 30 req/min, all tools.

Registry & source

Registered in the official MCP Registry: io.github.MeshTok/baydeep · Source: github.com/MeshTok/baydeep · Consumer storefront: leapbest.com