Temu MCP server for AI agents

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

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

Connect

Just Temu

An MCP server for Temu 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/temu
Every site

One MCP server for Temu 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 5
  • listCategoriesList Temu's top-level shopping categories (Women's Clothing, Home & Kitchen, Electronics, …), each with its subcategories and the url that opens it.

    Arguments

    NameTypeRequired
    parentstringNo

    Returns TemuCategory[]

    interface TemuCategoryLink { id: string; name: string; url: string; }
    
    interface TemuCategory extends TemuCategoryLink { subcategories: TemuCategoryLink[]; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.listCategories();
  • listOrdersThe caller's own order history.

    Arguments

    None.

    Returns TemuOrder[]

    interface TemuOrder { orderId: string; placedAt?: string; total?: string; status?: string; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.listOrders();
  • listWishlistList the products saved to the caller's wishlist, 20 a page with a cursor for the next.

    Arguments

    NameTypeRequired
    cursorstringNo

    Returns TemuWishlist

    interface TemuWishlistItem { productId: string; title: string; url?: string; price?: string; imageUrl?: string; }
    
    interface TemuWishlist { items: TemuWishlistItem[]; cursor?: string; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.listWishlist();
  • trackOrderWhere a specific order's package is and when it is due.

    Arguments

    NameTypeRequired
    orderIdstringYes

    Returns TemuTracking

    interface TemuTrackingEvent { time?: string; description: string; }
    
    interface TemuPackage { packageId?: string; carrier?: string; trackingNumber?: string; status?: string; expectedDelivery?: string; events: TemuTrackingEvent[]; }
    
    interface TemuTracking { orderId: string; packages: TemuPackage[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/temu/trackOrder

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.trackOrder({ orderId: "PO-211-00000000000000000" });
  • viewCartRead the caller's current cart.

    Arguments

    None.

    Returns TemuCart

    interface TemuCartItem { productId: string; quantity: number; price?: string; }
    
    interface TemuCart { items: TemuCartItem[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/temu/viewCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.viewCart();
Act 7
  • addToCartAdd one product (with its chosen variant and quantity) to the caller's cart.

    Arguments

    NameTypeRequired
    productIdstringNo
    urlstringNo
    skuIdstringYes
    quantitynumberNo

    Returns TemuCartChange

    interface TemuCheckoutAccount { site: string; hint: string; signedInAs?: string; signInUrl?: string; }
    
    interface TemuCheckoutItem { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string; } // prices are decimal strings
    
    interface TemuCheckoutSummary { items: TemuCheckoutItem[]; 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 TemuCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; urlKind?: "carries_items" | "signed_in_cart" | "product_page"; account: TemuCheckoutAccount; summary: TemuCheckoutSummary | null; reason?: string; detail?: string; expiresAt?: string; warnings: string[]; }
    
    interface TemuCartChange { productId: string; skuId: string; quantity: number; operation: "add" | "update" | "remove"; checkout?: TemuCheckoutHandoff; }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.addToCart({ skuId: "<skuId>" });
  • addToWishlistSave a product to the caller's wishlist by its productId (goods_id) or product url.

    Arguments

    NameTypeRequired
    productIdstringNo
    urlstringNo

    Returns TemuWishlistSave

    interface TemuWishlistSave { productId: string; saved: true; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/temu/addToWishlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.addToWishlist({});
  • checkoutRead the live order total (items, shipping, tax, any coupon) for the caller's cart and hand back Temu's own checkout url.

    Arguments

    None.

    Returns TemuCheckout

    interface TemuCheckout { total: string; checkoutUrl: string; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/temu/checkout

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.checkout();
  • removeFromCartRemove one line from the cart.

    Arguments

    NameTypeRequired
    productIdstringNo
    urlstringNo
    skuIdstringYes
    quantitynumberNo

    Returns TemuCartChange

    interface TemuCheckoutAccount { site: string; hint: string; signedInAs?: string; signInUrl?: string; }
    
    interface TemuCheckoutItem { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string; } // prices are decimal strings
    
    interface TemuCheckoutSummary { items: TemuCheckoutItem[]; 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 TemuCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; urlKind?: "carries_items" | "signed_in_cart" | "product_page"; account: TemuCheckoutAccount; summary: TemuCheckoutSummary | null; reason?: string; detail?: string; expiresAt?: string; warnings: string[]; }
    
    interface TemuCartChange { productId: string; skuId: string; quantity: number; operation: "add" | "update" | "remove"; checkout?: TemuCheckoutHandoff; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/temu/removeFromCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.removeFromCart({ skuId: "<skuId>" });
  • removeFromWishlistRemove a product from the caller's wishlist by its productId (goods_id) or product url.

    Arguments

    NameTypeRequired
    productIdstringNo
    urlstringNo

    Returns TemuWishlistRemoval

    interface TemuWishlistRemoval { productId: string; removed: true; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/temu/removeFromWishlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.removeFromWishlist({});
  • updateCartChange a cart line's quantity or chosen variant.

    Arguments

    NameTypeRequired
    productIdstringNo
    urlstringNo
    skuIdstringYes
    quantitynumberYes
    fromQuantitynumberNo

    Returns TemuCartChange

    interface TemuCheckoutAccount { site: string; hint: string; signedInAs?: string; signInUrl?: string; }
    
    interface TemuCheckoutItem { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string; } // prices are decimal strings
    
    interface TemuCheckoutSummary { items: TemuCheckoutItem[]; 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 TemuCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; urlKind?: "carries_items" | "signed_in_cart" | "product_page"; account: TemuCheckoutAccount; summary: TemuCheckoutSummary | null; reason?: string; detail?: string; expiresAt?: string; warnings: string[]; }
    
    interface TemuCartChange { productId: string; skuId: string; quantity: number; operation: "add" | "update" | "remove"; checkout?: TemuCheckoutHandoff; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/temu/updateCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.updateCart({ skuId: "<skuId>", quantity: 1 });
  • writeReviewPost a 1-5 star review, with optional text, on a product from one of the caller's own orders (orderId from listOrders, productId the goods_id).

    Arguments

    NameTypeRequired
    orderIdstringYes
    productIdstringYes
    ratingnumberYes
    textstringNo

    Returns TemuReview

    interface TemuReview { orderId: string; productId: string; rating: number; reviewIds: string[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/temu/writeReview

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.temu.writeReview({
      orderId: "<orderId>",
      productId: "<productId>",
      rating: 1
    });

Use it from code