AliExpress MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on AliExpress: 8 typed functions through one MCP server. No AliExpress API key needed.

Functions
8
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just AliExpress

An MCP server for AliExpress alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/aliexpress
Every site

One MCP server for AliExpress and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 7
  • getProductFetches detailed product information including the price of every variant (size, color, etc.), shipping cost and delivery days to the ship-to…

    Arguments

    NameTypeRequired
    idstring
    The numeric product id from a search row's id, or an /item/<id>.html url.
    Yes

    Returns aliexpressProductDetail

    interface aliexpressProductDetail {
      id: string;
      title: string;
      price?: number;
      original_price?: number;
      currency?: string;
      images: string[];
      /** SKU dimensions, e.g. { name: "Color", values: ["black", "white"] }. */
      variants: { name: string; values: string[] }[];
      /** Every SKU with its OWN price, e.g. { options: { Color: "black", Length: "1m" }, price: 1.09 }.
       *  `price` above is only the page's selected SKU. */
      skus: { sku_id: string; options: Record<string, string>; price?: number; original_price?: number;
        currency?: string; stock?: number; available: boolean }[];
    
      shipping: { ship_to: string; ship_from?: string; fee?: number; currency?: string; carrier?: string;
        delivery_days_min?: number; delivery_days_max?: number }[];
      properties: { name: string; value: string }[];
      rating?: number;
      review_count?: number;
      store?: { name: string; url?: string; positive_rate?: string };
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aliexpress/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aliexpress.getProduct({ id: "<id>" });
  • getStoreFetches a seller's store info.

    Arguments

    NameTypeRequired
    idstring
    A seller id, or the store url a product's own store.url field returns.
    Yes

    Returns aliexpressStoreInfo

    interface aliexpressStoreInfo {
      id: string;
      /** AliExpress's own internal shop id, distinct from the seller id. */
      shopId?: string;
      name: string;
      logoUrl?: string;
      /** "available", "closed" (on vacation), etc, the site's own word. */
      status?: string;
      followerCount?: number;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aliexpress/getStore

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aliexpress.getStore({ id: "2678280160" });
  • listCartLists items in the CALLER's own AliExpress shopping cart.

    Arguments

    None.

    Returns aliexpressCartItem[]

    interface aliexpressCartItem {
      product_id: string;
      title?: string;
      price?: number;
      currency?: string;
      quantity: number;
      image_url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aliexpress/listCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aliexpress.listCart();
  • listCategoriesLists AliExpress's own category navigation menu.

    Arguments

    NameTypeRequired
    tabstring
    The id of a top-level category (from a call with no tab) to get that category's own second- and third-level subcategories.
    No

    Returns aliexpressCategory[]

    interface aliexpressCategory {
      id: string;
      platform_category_id?: string;
      name: string;
      icon_url?: string;
      subcategories?: aliexpressCategory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aliexpress/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aliexpress.listCategories();
  • listOrdersLists the CALLER's own AliExpress orders, 10 a page.

    Arguments

    NameTypeRequired
    pagenumber
    1-based page of the caller's order history, 10 orders a page.
    No

    Returns aliexpressOrder[]

    interface aliexpressOrder {
      order_id: string;
      status?: string;
      created_at?: string;
      total?: number;
      currency?: string;
      store_name?: string;
      items: { product_id?: string; title?: string; quantity?: number; image_url?: string }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aliexpress/listOrders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aliexpress.listOrders();
  • listWishlistLists products in the CALLER's own AliExpress wishlist.

    Arguments

    NameTypeRequired
    pagenumber
    1-based page of the caller's wishlist.
    No

    Returns aliexpressWishlistItem[]

    interface aliexpressWishlistItem {
      product_id: string;
      title?: string;
      price?: number;
      currency?: string;
      image_url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aliexpress/listWishlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aliexpress.listWishlist();
Act 1
  • addToCartAdds one variant (productId + skuId from getProduct) to the CALLER's own AliExpress cart.

    Arguments

    NameTypeRequired
    productIdstring
    The product id a search row or getProduct returns.
    Yes
    skuIdstring
    One variant's id, getProduct's sku list carries it.
    Yes
    quantitynumber
    Default 1.
    No

    Returns aliexpressAddToCartResult

    interface AliexpressCheckoutAccount { site: string; hint: string; signedInAs?: string; signInUrl?: string; }
    
    interface AliexpressCheckoutItem { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string; } // prices are decimal strings
    
    interface AliexpressCheckoutSummary { items: AliexpressCheckoutItem[]; total: string | null; currency: string; }
    
    /** Where to finish: open url, signed in as account. Bowmark never pays. status is ready_to_checkout, needs_login or unavailable (reason + detail say why). */
    interface AliexpressCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; urlKind?: "carries_items" | "signed_in_cart" | "product_page"; account: AliexpressCheckoutAccount; summary: AliexpressCheckoutSummary | null; reason?: string; detail?: string; expiresAt?: string; warnings: string[]; }
    
    interface aliexpressAddToCartResult {
      cart_line_id?: string;
      cart_count?: number;
      checkout?: AliexpressCheckoutHandoff;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aliexpress/addToCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aliexpress.addToCart({ productId: "<productId>", skuId: "<skuId>" });

Use it from code