Skip to main content

Policy and FAQs tool

The Policy and FAQs MCP endpoint provides non-catalog tools for interacting with a single merchant's store. The tool is available at:

https://{storedomain}/api/mcp

Replace storedomain with the store's actual domain. No authentication is required.

For UCP catalog tools (search_catalog, lookup_catalog, get_product), see Storefront Catalog.


Anchor to [object Object]search_shop_policies_and_faqs

Answers questions about the store's policies, products, and services to build customer trust.

When to use:

  • A customer asks "What's your return policy?"
  • You need to clarify shipping or payment options.
  • A customer has questions about product care or warranties.

Parameters:

ParameterTypeRequiredDescription
querystringYesThe question about policies or FAQs. For example, "What is your return policy for sale items?"
contextstringNoAdditional context like the current product being viewed or the customer's situation.

Example:

{
"jsonrpc": "2.0",
"method": "tools/call",
"id": 1,
"params": {
"name": "search_shop_policies_and_faqs",
"arguments": {
"query": "What is your return policy for sale items?",
"context": "Customer is looking at discounted winter jackets"
}
}
}

Response:

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"structuredContent": {
"answer": "Sale items can be returned within 14 days if tags are attached and the item is unworn. Refunds go to the original payment method. Final sale items are noted on the product page.",
"sources": [
{
"title": "Refund policy",
"url": "https://business.example.com/policies/refund-policy"
},
{
"title": "FAQ — Sale merchandise",
"url": "https://business.example.com/pages/faq#sale-items"
}
]
}
}
}

Was this page helpful?