marketplace-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
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
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| connections_listA | Returns every connected marketplace seller account (never keys or secrets). Call this first to learn the connection_id required by the other tools. |
| connection_getA | Returns details of a single connection by connection_id (never secrets). |
| connection_testB | Performs a real read-only connectivity check: token validity and API availability. The seller account is not modified. |
| marketplace_capabilitiesA | Shows which data categories are actually available to the AI for this connection (token scopes plus server policy). Call before using the marketplace-specific tools. |
| wb_products_listA | Returns Wildberries product cards: WB article (nmID), seller article, barcode, title, brand, category. Read-only; the seller account is not modified. Use it to survey the assortment; do not use it for stocks (wb_stocks_get) or prices (wb_prices_get). |
| wb_stocks_getA | Returns current stock levels split by FBO (WB warehouses) and FBS (seller warehouses): available to order, in transit to customer, in transit from customer. Read-only. Fulfillment models are never merged into one number. WB refreshes this data every 30 minutes. Requires the Analytics (Аналитика) token category. |
| wb_prices_getA | Returns current Wildberries prices and discounts. Read-only; never changes prices. Money values are decimal strings with a currency, never floats. |
| wb_orders_listA | Returns Wildberries orders for a period (30 days by default): date, article, amount, warehouse, status. Read-only. WB refreshes this data every 30 minutes and retains it for 90 days. For aggregate sales stats, call this tool and compute on the AI side. |
| ozon_products_listA | Returns Ozon products: product_id, seller article (offer_id), title, category. Read-only. Use it to survey the assortment; do not use it for stocks (ozon_stocks_get) or prices (ozon_prices_get). |
| ozon_stocks_getA | Returns Ozon stock levels split by FBO (Ozon warehouses) and FBS (seller warehouses): available to order and reserved. Read-only. Fulfillment models are never merged. |
| ozon_prices_getA | Returns current Ozon prices: price before discount, price for the customer, currency. Read-only; never changes prices. Money values are decimal strings. |
| ozon_orders_listA | Returns Ozon postings for a period (30 days by default): posting number, date, items, amount, status. FBO and FBS are independent order streams on Ozon; both are returned by default. Read-only. |
| ym_campaigns_listA | Returns the Yandex Market shops (campaignId) and business accounts (businessId) the token can reach. Yandex Market has a two-level structure: an account holds several shops, and different methods need different identifiers. Call this before the other ym_* tools. |
| ym_products_listA | Returns Yandex Market products: seller article (offerId), title, category, barcode, Market SKU. Read-only. Operates at the business-account level (businessId), not per shop. |
| ym_stocks_getA | Returns Yandex Market stock levels: available to order and reserved. Read-only. Market stock types (AVAILABLE/FIT/FREEZE/DEFECT/…) are normalized: sellable quantity is kept separate from reserved and defective stock. IMPORTANT: Yandex Market splits stocks across two methods and a single call does NOT cover both. Without campaign_id you get seller warehouses (FBS/DBS/Express). With campaign_id you get Market warehouses (FBY, i.e. the FBO model), which is also the only working path for accounts with warehouse groups. To see all stock, call it twice: without campaign_id and with it (shop ids come from ym_campaigns_list). |
| ym_prices_getB | Returns Yandex Market prices: base price, price for the customer, currency. Read-only; never changes prices. Money values are decimal strings. |
| ym_orders_listA | Returns Yandex Market orders for a period (30 days by default): date, items, amount, status, shop. Read-only. A single request spans at most 30 days (API limitation). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
Each tool targets a distinct resource and marketplace: connections, capabilities, products, stocks, prices, and orders are clearly separated, and provider prefixes (wb_/ozon_/ym_) remove cross-marketplace confusion. The descriptions also explicitly warn against using one tool for another data category.
The naming pattern is largely consistent: provider prefix plus resource plus list/get (e.g., wb_products_list, ozon_stocks_get, ym_orders_list). Minor deviations include connections_list vs connection_get/connection_test (plural/singular inconsistency) and marketplace_capabilities lacking a verb suffix.
17 tools is slightly above the typical 3-15 range, but the count is justified by covering three separate marketplaces with four data categories each plus connection and capability tools. No tool feels redundant; the scope is broad but well organized.
The server fully covers the read-only marketplace domain: products, stocks, prices, and orders for all three supported marketplaces, plus connection discovery, testing, and capability checks. Required prerequiste lookups like ym_campaigns_list are present, so the user has no dead ends.