SuperCheap MCP
SuperCheap is a product-discovery marketplace providing catalog search, cart management, checkout, order tracking, and customer support tools via its official remote MCP service for AI assistants.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://supercheap.market/mcpWhat its tools do
7 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (3)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search products in the catalog
- Manage a customer cart
- Request current checkout quotes
- Access customer support
Source and maintenance
Protocol and capabilities
- Server
- supercheap-catalog 0.1.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 7 advertised
- Resources
- 2 advertised
- Resource templates
- 1 advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
},
"resources": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
7 advertised
market_list — List SuperCheap markets
Find supported SuperCheap country, language, currency, and checkout availability combinations.
{
"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": [
"currencies",
"markets",
"schemaVersion"
],
"properties": {
"markets": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"currencies": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"schemaVersion": {
"type": "number",
"const": 1
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}category_search — Search product categories
Find canonical SuperCheap categories using lexical and semantic matching.
{
"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"
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"categories"
],
"properties": {
"categories": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}category_get_tree — Browse the category tree
Return a bounded category subtree. Use rootCategoryId and maxDepth to avoid loading the entire taxonomy.
{
"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
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"categories",
"truncated"
],
"properties": {
"truncated": {
"type": "boolean"
},
"categories": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}catalog_search_products — Search SuperCheap 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. If supplierExpansion is failed, stop retrying that supplier search, report the returned failure classification, and continue only with other available results or a materially different shopper request. Set waitForSupplierResults=true to have the server poll a queued supplier expansion for up to maxWaitMs before returning.
{
"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
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"attributeFacets",
"canonicalTotal",
"categoryFacets",
"items",
"total"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"type": "string",
"const": "pending"
},
"nextCursor": {
"type": "string"
},
"nextOffset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"retryAfter": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"matchQuality": {
"enum": [
"broad"
],
"type": "string"
},
"canonicalTotal": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"categoryFacets": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"attributeFacets": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"supplierRetryAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"supplierPreviews": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"supplierExpansion": {
"enum": [
"cached",
"failed",
"not-needed",
"queued",
"running",
"throttled"
],
"type": "string"
},
"supplierFailureReason": {
"enum": [
"attempt-limit",
"age-limit"
],
"type": "string"
},
"supplierDiscoveryRequestIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-f\\d]{64}$"
},
"maxItems": 16
},
"supplierFailureClassification": {
"enum": [
"success",
"not-found",
"budget-exhausted",
"concurrency-exhausted",
"http-429",
"http-5xx",
"timeout",
"malformed",
"semantic-error",
"identity-mismatch",
"transport-error"
],
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}catalog_report_product_impressions — Report products shown to the shopper
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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"itemIds"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"itemId"
],
"properties": {
"itemId": {
"type": "string",
"pattern": "^[a-z0-9-]+$"
},
"source": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"channel": {
"enum": [
"category",
"home",
"image",
"pinterest",
"search",
"similar",
"supplier"
],
"type": "string"
},
"collection": {
"type": "string",
"maxLength": 64
},
"sourceSchemaVersion": {
"type": "number",
"const": 1
}
}
},
"maxItems": 48
},
"cursor": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"itemIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9-]+$"
},
"maxItems": 48,
"minItems": 1
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"accepted"
],
"properties": {
"accepted": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}catalog_get_product — Get product details
Get product details, offer, attributes, variants, media, and a SuperCheap deep link. When opening a supplier preview, pass its collection, channel, source, and sourceSchemaVersion through this call and later cart/favorite calls. 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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"countryCode",
"languageCode",
"itemId"
],
"properties": {
"itemId": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"source": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"channel": {
"enum": [
"category",
"home",
"image",
"pinterest",
"search",
"similar",
"supplier"
],
"type": "string"
},
"collection": {
"type": "string",
"maxLength": 64
},
"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"
},
"sourceSchemaVersion": {
"type": "number",
"const": 1
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"item"
],
"properties": {
"item": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}catalog_get_similar_products — Find 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. If supplierExpansion is failed, stop retrying that supplier search and report its failure classification. 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.
{
"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
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"items",
"total"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"type": "string",
"const": "pending"
},
"nextCursor": {
"type": "string"
},
"nextOffset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"retryAfter": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"supplierRetryAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"supplierPreviews": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"supplierExpansion": {
"enum": [
"cached",
"failed",
"not-needed",
"queued",
"running",
"throttled"
],
"type": "string"
},
"supplierFailureReason": {
"enum": [
"attempt-limit",
"age-limit"
],
"type": "string"
},
"supplierFailureClassification": {
"enum": [
"success",
"not-found",
"budget-exhausted",
"concurrency-exhausted",
"http-429",
"http-5xx",
"timeout",
"malformed",
"semantic-error",
"identity-mismatch",
"transport-error"
],
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
2 advertised
SuperCheap product cards
Product photos, buyer-market prices, and safe links for SuperCheap items.
ui://supercheap/products-02a383eed4d123c10f726a8f.htmlSuperCheap product cards
Product photos, buyer-market prices, and safe links for SuperCheap items.
ui://supercheap/products.htmlSuperCheap product cards (versioned URI compatibility)
Product photos, buyer-market prices, and safe links for SuperCheap items.
ui://supercheap/products-{hash}.html90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-06: 1 of 1 checks answered
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 2809 ms
- 95th percentile latency
- 2809 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 2809 ms · metadata changed · 7 tool(s), 2 resource(s), 1 resource template(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http supercheap-mcp https://supercheap.market/mcpCodex
codex mcp add supercheap-mcp --url https://supercheap.market/mcpCursor
{
"mcpServers": {
"supercheap-mcp": {
"url": "https://supercheap.market/mcp"
}
}
}Cline
{
"mcpServers": {
"supercheap-mcp": {
"type": "streamableHttp",
"url": "https://supercheap.market/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"supercheap-mcp": {
"type": "http",
"url": "https://supercheap.market/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http supercheap-mcp https://supercheap.market/mcpClaude Desktop
https://supercheap.market/mcpWindsurf
{
"mcpServers": {
"supercheap-mcp": {
"serverUrl": "https://supercheap.market/mcp"
}
}
}Let your agent find its tools
Find servers like SuperCheap MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.