get_product

Get full details of a specific product by ID. Returns the merchant description, store info, all images, the full color/size availability matrix with SKU-level variants, and a click-tracked purchase link.

Parameters

Parameter	Type	Required	Default	Description
`product_id`	`string`	Yes	—	The product ID
`currency`	`string`	No	`USD`	ISO 4217 code to render prices in (e.g. `"GBP"`, `"EUR"`). Falls back to FX when no stored native price exists.

Response

{
  "id": "665a1f...",
  "title": "Classic Leather Chelsea Boot",
  "brand": "Grenson",
  "merchantDescription": "Handcrafted from full-grain Italian leather with a comfortable rubber sole...",
  "summary": "A timeless chelsea boot in black leather with pull tabs and elastic side panels.",
  "category": "shoes/boots/chelsea-boots",
  "colors": ["black"],
  "materials": ["leather"],
  "gender": "men",
  "silhouette": "fitted",
  "closures": ["pull-on"],
  "tags": ["classic", "formal", "business"],
  "isSustainable": false,
  "inStock": true,
  "price": 295,
  "compareAtPrice": 350,
  "currency": "USD",
  "images": [
    "https://cdn.store.com/boot-front.jpg",
    "https://cdn.store.com/boot-side.jpg",
    "https://cdn.store.com/boot-sole.jpg"
  ],
  "availability": {
    "dimensions": ["color", "size"],
    "color": [
      {
        "colorKey": "black",
        "color": "black",
        "label": "Black",
        "imageUrls": ["https://..."],
        "availableSizes": [
          { "label": "9",  "inStock": true },
          { "label": "10", "inStock": true }
        ]
      }
    ],
    "sizes": [
      { "label": "9",  "inStock": true },
      { "label": "10", "inStock": true }
    ],
    "variants": [
      {
        "colorKey": "black",
        "size": "9",
        "inStock": true,
        "sku": "CLB-BLK-9",
        "imageUrl": "https://...",
        "price": 295,
        "compareAtPrice": 350,
        "currency": "USD"
      },
      {
        "colorKey": "black",
        "size": "10",
        "inStock": true,
        "sku": "CLB-BLK-10",
        "imageUrl": "https://...",
        "price": 295,
        "compareAtPrice": 350,
        "currency": "USD"
      }
    ]
  },
  "productUrl": "https://api.vistoya.com/go/665a1f...?src=mcp",
  "store": {
    "name": "Grenson",
    "domain": "grenson.com"
  }
}

Response fields

Field	Description
`merchantDescription`	Plain-text merchant/source product description (the long-form copy). Returned only on detail.
`summary`	AI-generated one-line shopping summary (same as on search results).
`category`	Most specific available category value, preferring subcategory over broad category
`silhouette`	AI-classified fit (e.g. fitted, oversized, relaxed)
`tags`	Merged public descriptive tags — fit, function, details, aesthetic, style, and pattern
`compareAtPrice`	Original price before discount (nullable — present when on sale)
`availability`	Full color/size matrix with SKU-level `variants`. When variant pricing differs by color or size, `price`/`compareAtPrice`/`priceRange` fields appear nested under the dimension that drives the difference.
`productUrl`	Click-tracked Vistoya redirect URL — use this when linking users to the purchase page.
`store`	Store info: `name`, `domain`

Examples

{
  "name": "get_product",
  "arguments": {
    "product_id": "665a1f2b3c4d5e6f7a8b9c0d",
    "currency": "EUR"
  }
}

You typically reach this tool from a result returned by discover_products or find_similar_products — pass the result's id here as product_id to get the full description, all images, and SKU-level variants. Use find_similar_products with the same product_id to surface alternatives.

get_product

Parameters

Response

Response fields

Examples

Related tools