Schema | AliExpress MCP

AliExpress MCP

Overview Schema Source Related Servers Discussions Admin

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`AE_LOCALE`	No	Language / localisation (e.g. pt_BR for Portuguese).	de_DE
`AE_REGION`	No	Ship-to region (e.g. BR for Brazil).	DE
`AE_CURRENCY`	No	Display currency (e.g. BRL for Brazilian Real).	EUR
`MCP_TRANSPORT`	No	MCP transport type; set to 'stdio' for a classic stdio MCP server.	http
`AE_COOKIE_FILE`	No	Path to a text file containing the AliExpress cookie string.	~/.gemini/config/aliexpress_cookie.txt
`AE_MTOP_COOLDOWN`	No	Seconds to stop attempting MTop product detail after it answers with an anti-bot challenge.	900
`AE_MAX_CONCURRENT`	No	Process-wide cap on concurrent requests to AliExpress.	2
`ALIEXPRESS_COOKIE`	No	Full cookie string or session cookies (aep_usuc_f, xman_t, etc.) to bypass anti-bot / TMD punish page.
`AE_BROWSER_ENABLED`	No	Browser transport for product detail.	true
`AE_BROWSER_ATTEMPTS`	No	Attempts per lookup, each in a fresh context.	3
`AE_BROWSER_HEADLESS`	No	Headless mode for Chromium.	true
`AE_BROWSER_TIMEOUT_MS`	No	Per-attempt budget.	45000
`AE_BROWSER_RETRY_DELAY_S`	No	Pause between attempts.	1.5

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

Capability	Details
`tools`	{ "listChanged": true }
`logging`	{}
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }

Tools

Functions exposed to the LLM to take actions

Name Description

Name	Description
search_aliexpressA	Search AliExpress product listings by keyword. Returns a list of products — id, title, sale price (and original price / discount), star rating, orders-sold text, thumbnail image and product URL. Prices and titles follow the configured market (Germany / EUR by default). Pass a product's `id` to `get_aliexpress_product` for full details.
get_aliexpress_productA	Retrieve the record of one AliExpress product. Use after `search_aliexpress` surfaces something worth a closer look. How complete the answer is depends on which source could serve it, so check the `source` and `partial` fields before describing it to the user: `source: "mtop"`, `partial: false` — the full record: title, selected-variant price plus per-variant pricing, star rating and review count, orders sold, stock, the store (name, positive rating, country), shipping (origin, ship-to, delivery estimate), the SKU option axes (e.g. colour / size), specifications and all product images. `source: "ssr+search"`, `partial: true` — AliExpress is currently gating its detail API behind an anti-bot challenge, so the record is composed from the product page and search results: title, images, url, price, rating and orders. Every field that could not be obtained is named in `unavailable`. Occasionally even price/rating cannot be recovered; `price_note` explains why and `search_status` distinguishes the two causes — `blocked` (AliExpress is rate-limiting right now, so it is worth retrying later) from `not_found` (the listing genuinely did not turn up in search). Say which one it was rather than just "no price available". Prices are in the configured currency (EUR by default). A field listed in `unavailable` is unknown, not absent from the listing — do not tell the user a product has no variants, no reviews or no shipping options on that basis; say that detail could not be retrieved.

search_aliexpressA

Search AliExpress product listings by keyword.

Returns a list of products — id, title, sale price (and original price / discount), star rating, orders-sold text, thumbnail image and product URL. Prices and titles follow the configured market (Germany / EUR by default). Pass a product's id to get_aliexpress_product for full details.

get_aliexpress_productA

Retrieve the record of one AliExpress product.

Use after search_aliexpress surfaces something worth a closer look.

How complete the answer is depends on which source could serve it, so check the source and partial fields before describing it to the user:

source: "mtop", partial: false — the full record: title, selected-variant price plus per-variant pricing, star rating and review count, orders sold, stock, the store (name, positive rating, country), shipping (origin, ship-to, delivery estimate), the SKU option axes (e.g. colour / size), specifications and all product images.
source: "ssr+search", partial: true — AliExpress is currently gating its detail API behind an anti-bot challenge, so the record is composed from the product page and search results: title, images, url, price, rating and orders. Every field that could not be obtained is named in unavailable. Occasionally even price/rating cannot be recovered; price_note explains why and search_status distinguishes the two causes — blocked (AliExpress is rate-limiting right now, so it is worth retrying later) from not_found (the listing genuinely did not turn up in search). Say which one it was rather than just "no price available".

Prices are in the configured currency (EUR by default). A field listed in unavailable is unknown, not absent from the listing — do not tell the user a product has no variants, no reviews or no shipping options on that basis; say that detail could not be retrieved.

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.3/5.0

Scored 2026-09-17 15:40 across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: one searches for product listings while the other retrieves details for a specific product. Their descriptions explicitly cross-reference each other, leaving no ambiguity about when to use which.

Naming Consistency4/5

Both names use a consistent snake_case, action-first style: search_aliexpress and get_aliexpress_product. The minor deviation is that one name lacks a noun object, but the pattern is still predictable and readable.

Tool Count3/5

Two tools is a minimal but reasonable surface for a read-only product search and detail lookup server. It feels thin compared to more feature-complete e-commerce servers, but each tool earns its place in the core workflow.

Completeness4/5

The search-then-get flow covers the main user journey without dead ends. Pagination, category browsing, or review listing could be useful additions, but they are not essential gaps for the stated purpose of searching and inspecting products.

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers