Ucunhome MCP

Search in-stock products on Ucun Select (home-textile wholesale platform, Nantong China). Supports Chinese or English keyword, category, material, and max-price filters; returns up to 50 matches sorted by relevance, default limit 10. Public read-only, no auth required. Returns an empty array (not an error) when nothing matches. Use this to discover products; then call get_stock with a returned id for full details, or list_categories for an inventory overview.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "返回数量，默认10，最大50"
    },
    "keyword": {
      "type": "string",
      "description": "搜索词，如：四件套/被子/面料/棉/法兰绒/bedding/fabric"
    },
    "category": {
      "type": "string",
      "description": "品类：四件套/被子/被套/床单/枕套/面料/床盖等"
    },
    "material": {
      "type": "string",
      "description": "材质：全棉/聚酯纤维/法兰绒/磨毛等"
    },
    "price_max": {
      "type": "number",
      "description": "最高批发价(元)"
    }
  }
}

{
  "readOnlyHint": true
}

Get full details of one product by id: specs, price, stock, MOQ, merchant name. The collected_at field shows when price/stock were last recorded - always check data_age_days before quoting prices (over 30 days = stale, verify with merchant). Public read-only, no auth required. If the id does not exist, returns an error message (not an empty result). Use this when you already have a product id from search_stocks; use search_stocks instead to find products by keyword.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Product id, copy it from the id field of a search_stocks result"
    }
  }
}

{
  "readOnlyHint": true
}

List all product categories that currently have in-stock items, with per-category quantity counts reflecting the live inventory structure. Public read-only, no auth required. Use this to get an overview or to pick a valid category value for search_stocks; use search_stocks to drill into products of one category.

{
  "type": "object",
  "properties": {}
}

{
  "readOnlyHint": true
}

Get a one-call overview of Ucun Select inventory: total in-stock products, per-category counts, export-ready / custom-order / sample-available counts, and last updated time. Public read-only, no auth required. Use this first to understand the platform scale, then use search_stocks or list_categories to drill in.

{
  "type": "object",
  "properties": {}
}

{
  "readOnlyHint": true
}

List the most recently updated in-stock products, newest first. Public read-only, no auth required. Returns compact product cards (same fields as search_stocks). Use this when a buyer asks for new arrivals or latest designs; use search_stocks for keyword-based discovery.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "返回数量，默认5，最大20"
    }
  }
}

{
  "readOnlyHint": true
}

[Internal] Get buyer contact info and past inquiry records. Restricted to signed partners only, requires an authorization token. Do NOT call without explicit authorization.

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "buyer name or phone"
    }
  }
}