Discovery Tool

get_faqs

Get pre-generated frequently asked questions for a product. FAQs are AI-generated from product data and sorted by relevance.

Parameters

Parameter	Type	Required	Default	Description
`product_public_id`	string		—	The product's public_id to get FAQs for.
`limit`	integer		`10`	Number of FAQs to return. Range: 1-50.

Parameter name

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

Response

Returns an array of FAQ objects sorted by priority_score in descending order. Returns an empty array if no FAQs exist for the product or if the product is not found.

Response

[
  {
    "public_id": "faq_9xk3m",
    "question": "What grind settings does this grinder have?",
    "answer": "The Pro Burr Coffee Grinder features 40 precise grind settings ranging from extra-fine (suitable for Turkish coffee and espresso) to coarse (ideal for French press and cold brew). Each setting is clearly marked on the adjustment dial for easy repeatability.",
    "buyer_stage": "consideration",
    "intent_category": "product_details",
    "priority_score": 0.92
  },
  {
    "public_id": "faq_2mv8n",
    "question": "How do I clean the burrs?",
    "answer": "Remove the upper burr by twisting it counterclockwise and lifting it out. Brush both burrs with the included cleaning brush. We recommend cleaning every 2-3 weeks for daily users. Never wash burrs with water as this can cause rust.",
    "buyer_stage": "decision",
    "intent_category": "usage",
    "priority_score": 0.85
  },
  {
    "public_id": "faq_7pt4k",
    "question": "Does it come with a warranty?",
    "answer": "Yes, the Pro Burr Coffee Grinder comes with a 2-year manufacturer warranty covering defects in materials and workmanship. Register your product within 30 days of purchase to activate the warranty.",
    "buyer_stage": "decision",
    "intent_category": "product_details",
    "priority_score": 0.78
  }
]

Example

Example Call

// Tool call
{
  "name": "get_faqs",
  "arguments": {
    "product_public_id": "prod_8kx2m",
    "limit": 5
  }
}

Response Fields

Field	Type	Description
`public_id`	string	Unique identifier for this FAQ.
`question`	string	The frequently asked question.
`answer`	string	The pre-generated answer to the question.
`buyer_stage`	string \| null	Customer journey stage: `awareness`, `consideration`, `decision`, or `retention`.
`intent_category`	string \| null	Question category: `product_details`, `ingredients`, `usage`, `pricing`, `shipping`, `benefits`, `safety`, or `comparison`.
`priority_score`	number \| null	Relevance score from 0 to 1. Higher scores indicate more commonly asked questions.

Notes

FAQs are pre-generated by AI from the product's details, reviews, and store policies. They are not user-submitted questions.
Results are sorted by priority_score descending. The highest-priority FAQs represent the most commonly relevant questions for the product.
Cross-store access is prevented. The product must belong to the store identified by the MCP endpoint URL.
Use buyer_stage and intent_category to select the most relevant FAQs for the customer's current context in the buying journey.