SuperCheap

Working · 3.2 s

io.github.hardtab/supercheap-shoppingv0.1.0

Search products, manage a customer cart, and request current checkout quotes.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://supercheap.market/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

catalog_get_product

Get product details, offer, attributes, variants, media, and a SuperCheap deep link. If the item is a supplier preview, this may request background supplier-detail hydration and returns its current status; retry while pending until full product details are available before choosing a configuration or adding it to a cart.

itemIdstring, required

countryCodestring, required

ISO 3166-1 alpha-2 country code

languageCodestring, required

Lowercase two-letter language code

detailLevelstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (7)

catalog_get_product

Argument	Type	Description
itemId*	string
countryCode*	string	ISO 3166-1 alpha-2 country code
detailLevel	string
languageCode*	string	Lowercase two-letter language code

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "countryCode",
    "languageCode",
    "itemId"
  ],
  "properties": {
    "itemId": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1
    },
    "countryCode": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code"
    },
    "detailLevel": {
      "enum": [
        "summary",
        "standard",
        "full"
      ],
      "type": "string",
      "default": "standard"
    },
    "languageCode": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "Lowercase two-letter language code"
    }
  }
}

catalog_get_similar_products

Find similar products with stable continuation across catalog and supplier sources. Use nextCursor with the same item and market for subsequent pages. A short page is not exhaustion when continuation is present. If status is pending or supplierExpansion is queued, running, or throttled, retry at retryAfter or supplierRetryAt. Supplier previews must be hydrated with catalog_get_product before choosing a configuration or adding to cart. Present only buyer-market offer prices, never supplier costs.

Argument	Type	Description
limit	integer
cursor	string
itemId*	string
offset	integer
countryCode*	string	ISO 3166-1 alpha-2 country code
languageCode*	string	Lowercase two-letter language code
expandSuppliers	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "countryCode",
    "languageCode",
    "itemId"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 12,
      "maximum": 24,
      "minimum": 1
    },
    "cursor": {
      "type": "string",
      "maxLength": 512,
      "minLength": 1
    },
    "itemId": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "countryCode": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code"
    },
    "languageCode": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "Lowercase two-letter language code"
    },
    "expandSuppliers": {
      "type": "boolean",
      "default": true
    }
  }
}

catalog_report_product_impressions

Record only products that were actually presented to the shopper. Searching alone does not mark products as viewed. This idempotent impression signal is used to demote or exclude products in later searches.

Argument	Type	Description
cursor	string
itemIds*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "itemIds"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "maxLength": 512,
      "minLength": 1
    },
    "itemIds": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9-]+$"
      },
      "maxItems": 48,
      "minItems": 1
    }
  }
}

catalog_search_products

Search canonical products with category, attribute, price, provider, vendor, sorting, and bounded pagination filters. Attribute pairs are forwarded to supplier discovery as provider Pid/Vid filters when expansion is needed, so keep the exact attributeId/valueId returned by facets. When the shopper requests N products, set limit=N (1–48); leave it unset to use the default of 12 when no count is specified. Set compact=true when limit exceeds 24; compact changes card payload size, not card selection. The product-card UI displays every returned item and supplier preview, up to 24 cards per result. Do not fetch a larger page and then select fewer only in prose: those returned cards still appear in the UI. If the shopper wants only the existing catalog or says not to search suppliers, set expandSuppliers=false so previews are not added. When product-card UI is attached, do not claim product photos are unavailable solely because the text response lacks inline images; refer to the rendered cards. Set freshOnly=true to exclude products already opened or explicitly exposed to this shopper. Use nextCursor for stable exploration pages, or nextOffset when nextCursor is unavailable; keep using the same query and filters. If status is pending, wait until retryAfter and resume with nextCursor as cursor, or nextOffset as offset when no cursor is returned; never restart a pending search from the first page. Supplier discovery automatically runs in the background for missing, weak, or exhausted results unless expandSuppliers=false. A broad result withholds unconfirmed canonical cards and describes only the current page. Continue with nextCursor when present, otherwise nextOffset; zero supplier previews on a page does not mean the search is exhausted. If supplierExpansion is queued, running, or throttled, wait until supplierRetryAt and repeat the same search. Set waitForSupplierResults=true to have the server poll a queued supplier expansion for up to maxWaitMs before returning.

Argument	Type	Description
sort	string
limit	integer	Number of canonical results in this page. Match an explicit shopper request for N products with limit=N (1–48); leave unset to keep the default of 12 when no count is specified. Use compact=true above 24. The native card UI displays returned items and supplier previews (up to 24 total per result), so do not request a larger page and claim that only a smaller subset was shown.

category_get_tree

Return a bounded category subtree. Use rootCategoryId and maxDepth to avoid loading the entire taxonomy.

read-only

Argument	Type	Description
maxDepth	integer
maxNodes	integer
countryCode*	string	ISO 3166-1 alpha-2 country code
languageCode*	string	Lowercase two-letter language code
rootCategoryId	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "countryCode",
    "languageCode"
  ],
  "properties": {
    "maxDepth": {
      "type": "integer",
      "default": 2,
      "maximum": 5,
      "minimum": 1
    },
    "maxNodes": {
      "type": "integer",
      "default": 200,
      "maximum": 500,
      "minimum": 1
    },
    "countryCode": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code"
    },
    "languageCode": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "Lowercase two-letter language code"
    },
    "rootCategoryId": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1
    }
  }
}

category_search

Find canonical SuperCheap categories using lexical and semantic matching.

read-only

Argument	Type	Description
limit	integer
query*	string
countryCode*	string	ISO 3166-1 alpha-2 country code
languageCode*	string	Lowercase two-letter language code

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "countryCode",
    "languageCode",
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 160,
      "minLength": 2
    },
    "countryCode": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code"
    },
    "languageCode": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "Lowercase two-letter language code"
    }
  }
}

market_list

Find supported SuperCheap country, language, currency, and checkout availability combinations.

read-only

Argument	Type	Description
limit	integer
query	string
availability	string	discoverable includes markets where checkout is enabled

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 80
    },
    "availability": {
      "enum": [
        "checkout-enabled",
        "discoverable"
      ],
      "type": "string",
      "description": "discoverable includes markets where checkout is enabled"
    }
  }
}

{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "countryCode", "languageCode" ], "properties": { "sort": { "enum": [ "relevance", "price-asc", "price-desc" ], "type": "string", "default": "relevance" }, "limit": { "type": "integer", "default": 12, "maximum": 48, "minimum": 1, "description": "Number of canonical results in this page. Match an explicit shopper request for N products with limit=N (1–48); leave unset to keep the default of 12 when no count is specified. Use compact=true above 24. The native card UI displays returned items and supplier previews (up to 24 total per result), so do not request a larger page and claim that only a smaller subset was shown." }, "query": { "type": "string", "maxLength": 160 }, "cursor": { "type": "string", "maxLength": 512, "minLength": 1 }, "offset": { "type": "integer", "default": 0, "maximum": 9007199254740991, "minimum": 0 }, "compact": { "type": "boolean", "default": false }, "vendorId": { "type": "string", "maxLength": 160, "minLength": 1 }, "freshOnly": { "type": "boolean", "default": false }, "maxWaitMs": { "type": "integer", "default": 15000, "maximum": 15000, "minimum": 0 }, "attributes": { "type": "array", "items": { "type": "object", "required": [ "attributeId", "valueId" ], "properties": { "valueId": { "type": "string", "maxLength": 160, "minLength": 1 }, "attributeId": { "type": "string", "maxLength": 160, "minLength": 1 } } }, "maxItems": 30 }, "categoryIds": { "type": "array", "items": { "type": "string", "maxLength": 160, "minLength": 1 }, "maxItems": 20 }, "countryCode": { "type": "string", "pattern": "^[A-Z]{2}$", "description": "ISO 3166-1 alpha-2 country code" }, "languageCode": { "type": "string", "pattern": "^[a-z]{2}$", "description": "Lowercase two-letter language code" }, "maxAmountMinor": { "type": "integer", "maximum": 9007199254740991, "minimum": 0 }, "minAmountMinor": { "type": "integer", "maximum": 9007199254740991, "minimum": 0 }, "sourceProvider": { "enum": [ "alibaba1688", "aliexpress", "taobao" ], "type": "string" }, "expandSuppliers": { "type": "boolean", "default": true }, "waitForSupplierResults": { "type": "boolean", "default": false } } }