Discovery Tool

get_product_details

Get complete product details by public ID, with commission metadata. Use this to retrieve full information about a specific product found via search_products.

Parameters

Parameter	Type	Required	Default	Description
`public_id`	string		—	The product's unique public identifier.
`agent_id`	string		—	Your agent ID for attribution tracking.

Parameter name

The parameter is named public_id, not product_id. Use the public_id value returned by search_products.

Response

Returns a single product object with the same shape as items in the search_products response. Returns null if the product is not found or does not belong to the current store.

Response (found)

{
  "public_id": "prod_8kx2m",
  "name": "Pro Burr Coffee Grinder",
  "description": "Professional-grade burr grinder with 40 grind settings. Features a precision timer, anti-static technology, and a sleek stainless steel design. Perfect for pour-over, French press, espresso, and cold brew.",
  "price": {
    "amount_in_cents": 14999,
    "currency": "USD"
  },
  "image_urls": [
    "https://cdn.shopify.com/s/files/1/example/grinder-front.jpg",
    "https://cdn.shopify.com/s/files/1/example/grinder-side.jpg",
    "https://cdn.shopify.com/s/files/1/example/grinder-top.jpg"
  ],
  "variation_attributes": [
    {
      "name": "Color",
      "values": ["Matte Black", "Stainless Steel"]
    }
  ],
  "has_variations": true,
  "_meta": {
    "commission": {
      "default_rate": 0.08,
      "effective_rate": 0.13,
      "rate_breakdown": {
        "base": 0.08,
        "campaign_bonus": 0.05,
        "campaign_name": "Spring Sale",
        "campaign_ends": "2026-03-31T23:59:59+00:00"
      }
    },
    "attribution": {
      "agent_ref": "agent_abc123def456"
    }
  }
}

Response (not found)

null

Example

Example Call

// Tool call
{
  "name": "get_product_details",
  "arguments": {
    "public_id": "prod_8kx2m",
    "agent_id": "agent_abc123def456"
  }
}

Notes

Cross-store access is prevented. A product must belong to the store identified by the MCP endpoint URL. Requesting a product from a different store returns null.
The response shape is identical to individual items in the search_products response, including the optional _meta block.
When agent_id is provided and the store has commission rates configured, the response includes commission and attribution metadata.