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.
- Site
- temu.com
- Functions
- 12
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/temuOne MCP server for Temu and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth 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.
listCategoriesList Temu's top-level shopping categories (Women's Clothing, Home & Kitchen, Electronics, …), each with its subcategories and the url that opens it.Arguments
Name Type Required 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/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/temu/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listOrdersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.listOrders();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.listOrders())curl -X POST https://api.bowmark.ai/v1/sites/temu/listOrders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.temu.listOrders();listWishlistList the products saved to the caller's wishlist, 20 a page with a cursor for the next.Arguments
Name Type Required cursorstringNo Returns
TemuWishlistinterface 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/listWishlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.listWishlist();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.listWishlist())curl -X POST https://api.bowmark.ai/v1/sites/temu/listWishlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.temu.listWishlist();trackOrderWhere a specific order's package is and when it is due.Arguments
Name Type Required orderIdstringYes Returns
TemuTrackinginterface 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/trackOrderCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.trackOrder({ orderId: "PO-211-00000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.trackOrder({"orderId": "PO-211-00000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/temu/trackOrder \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"orderId":"PO-211-00000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.temu.trackOrder({ orderId: "PO-211-00000000000000000" });viewCartRead the caller's current cart.Arguments
None.
Returns
TemuCartinterface TemuCartItem { productId: string; quantity: number; price?: string; } interface TemuCart { items: TemuCartItem[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/temu/viewCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.viewCart();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.viewCart())curl -X POST https://api.bowmark.ai/v1/sites/temu/viewCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.temu.viewCart();
addToCartAdd one product (with its chosen variant and quantity) to the caller's cart.Arguments
Name Type Required productIdstringNo urlstringNo skuIdstringYes quantitynumberNo Returns
TemuCartChangeinterface 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/addToCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.addToCart({ skuId: "<skuId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.addToCart({"skuId": "<skuId>"}))curl -X POST https://api.bowmark.ai/v1/sites/temu/addToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"skuId":"<skuId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.temu.addToCart({ skuId: "<skuId>" });addToWishlistSave a product to the caller's wishlist by its productId (goods_id) or product url.Arguments
Name Type Required productIdstringNo urlstringNo Returns
TemuWishlistSaveinterface TemuWishlistSave { productId: string; saved: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/temu/addToWishlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.addToWishlist({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.addToWishlist({}))curl -X POST https://api.bowmark.ai/v1/sites/temu/addToWishlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
TemuCheckoutinterface TemuCheckout { total: string; checkoutUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/temu/checkoutCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.checkout();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.checkout())curl -X POST https://api.bowmark.ai/v1/sites/temu/checkout \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.temu.checkout();removeFromCartRemove one line from the cart.Arguments
Name Type Required productIdstringNo urlstringNo skuIdstringYes quantitynumberNo Returns
TemuCartChangeinterface 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/removeFromCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.removeFromCart({ skuId: "<skuId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.removeFromCart({"skuId": "<skuId>"}))curl -X POST https://api.bowmark.ai/v1/sites/temu/removeFromCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"skuId":"<skuId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.temu.removeFromCart({ skuId: "<skuId>" });removeFromWishlistRemove a product from the caller's wishlist by its productId (goods_id) or product url.Arguments
Name Type Required productIdstringNo urlstringNo Returns
TemuWishlistRemovalinterface TemuWishlistRemoval { productId: string; removed: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/temu/removeFromWishlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.removeFromWishlist({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.removeFromWishlist({}))curl -X POST https://api.bowmark.ai/v1/sites/temu/removeFromWishlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.temu.removeFromWishlist({});updateCartChange a cart line's quantity or chosen variant.Arguments
Name Type Required productIdstringNo urlstringNo skuIdstringYes quantitynumberYes fromQuantitynumberNo Returns
TemuCartChangeinterface 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/updateCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.updateCart({ skuId: "<skuId>", quantity: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.updateCart({"skuId": "<skuId>", "quantity": 1}))curl -X POST https://api.bowmark.ai/v1/sites/temu/updateCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"skuId":"<skuId>","quantity":1}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required orderIdstringYes productIdstringYes ratingnumberYes textstringNo Returns
TemuReviewinterface TemuReview { orderId: string; productId: string; rating: number; reviewIds: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/temu/writeReviewCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.temu.writeReview({ orderId: "<orderId>", productId: "<productId>", rating: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.temu.writeReview({ "orderId": "<orderId>", "productId": "<productId>", "rating": 1 }))curl -X POST https://api.bowmark.ai/v1/sites/temu/writeReview \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"orderId":"<orderId>","productId":"<productId>","rating":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.temu.writeReview({ orderId: "<orderId>", productId: "<productId>", rating: 1 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/temu/<function> - OpenAPI
/v1/sites/temu/openapi.json