US product return policies, recalls and, as stores join, verified purchase outcomes for AI agents.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Outcomes for 2 to 5 products, in the order given.
Outcomes for 2 to 5 products, in the order given.
| Argument | Type | Description |
|---|---|---|
| product_ids* | array |
{
"type": "object",
"title": "compare_productsArguments",
"required": [
"product_ids"
],
"properties": {
"product_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
},
"title": "Product Ids",
"maxItems": 5,
"minItems": 2
}
}
}Return rate, complaint rate and delivery issue rate across a merchant's products.
| Argument | Type | Description |
|---|---|---|
| shop_domain* | string |
{
"type": "object",
"title": "get_merchant_profileArguments",
"required": [
"shop_domain"
],
"properties": {
"shop_domain": {
"type": "string",
"title": "Shop Domain",
"pattern": "^[A-Za-z0-9][A-Za-z0-9.-]{1,253}$"
}
}
}Score, sample size, outcome breakdown and top return reasons for one product.
| Argument | Type | Description |
|---|---|---|
| product_id* | string |
{
"type": "object",
"title": "get_product_outcomesArguments",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"title": "Product Id",
"format": "uuid"
}
}
}Products matching a name, GTIN or SKU: verified outcome summary, plus price, availability, rating and return policy as published on the merchant's site (labelled not verified).
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string | Name, GTIN or SKU. |
| category | any | home_kitchen, apparel, beauty, health, jewelry, toys_baby, sports_outdoors, electronics, pets, food_drink, arts_crafts, garden, automotive, office, other |
{
"type": "object",
"title": "search_productsArguments",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"title": "Query",
"maxLength": 100,
"minLength": 2,
"description": "Name, GTIN or SKU."
},
"category": {
"anyOf": [
{
"type": "string",
"maxLength": 50
},
{
"type": "null"
}
],
"title": "Category",
"default": null,
"description": "home_kitchen, apparel, beauty, health, jewelry, toys_baby, sports_outdoors, electronics, pets, food_drink, arts_crafts, garden, automotive, office, other"
}
}
}Record a purchase outcome for a product (product_id or product_url). Requires an API key (Authorization: Bearer header). Proofs: shopify_order (shop domain, order number, confirmation number) is checked against the shop's order record; email_receipt (the merchant's original DKIM-signed confirmation email, order number, product name) is checked by its signature; both count when they match. payment_receipt is stored as quarantined.
| Argument | Type | Description |
|---|---|---|
| proof* | any | |
| outcome* | string | |
| reasons | array | |
| product_id | any | |
| product_url | any |
{
"type": "object",
"$defs": {
"EmailReceiptProof": {
"type": "object",
"title": "EmailReceiptProof",
"required": [
"type",
"raw_email_base64",
"order_number",
"product_name"
],
"properties": {
"type": {
"type": "string",
"const": "email_receipt",
"title": "Type"
},
"order_number": {
"type": "string",
"title": "Order Number",
"maxLength": 60,
"minLength": 1,
"description": "Order number as it appears in the email."
},
"product_name": {
"type": "string",
"title": "Product Name",
"maxLength": 200,
"minLength": 3,
"description": "Product name exactly as it appears in the email."
},
"raw_email_base64": {
"type": "string",
"title": "Raw Email Base64",
"maxLength": 2800000,
"description": "The merchant's original order confirmation email (.eml, RFC 5322), base64-encoded. Its DKIM signature is verified; the email is processed in memory and never stored."
}
}
},
"ShopifyOrderProof": {
"type": "object",
"title": "ShopifyOrderProof",
"required": [
"type",
"shop_domain",
"order_number",
"confirmation_number"
],
"properties": {
"type": {
"type": "string",
"const": "shopify_order",
"title": "Type"
},
"shop_domain": {
"type": "string",
"title": "Shop Domain",
"pattern": "^[A-Za-z0-9][A-Za-z0-9.-]{1,253}$",
"description": "The store's domain, e.g. brand.com or brand.myshopify.com."
},
"order_number": {
"type": "string",
"title": "Order Number",
"pattern": "^#?[A-Za-z0-9-]{1,40}$",
"description": "Order number as shown to the buyer, e.g. #1001. Never stored."
},
"confirmation_number": {
"type": "string",
"title": "Confirmation Number",
"pattern": "^[A-Za-z0-9]{6,20}$",
"description": "Order confirmation number from the order confirmation, e.g. XPLZ3K9HG. Never stored."
}
}
},
"PaymentReceiptProof": {
"type": "object",
"title": "PaymentReceiptProof",
"required": [
"type",
"reference",
"purchased_on"
],
"properties": {
"type": {
"type": "string",
"const": "payment_receipt",
"title": "Type"
},
"reference": {
"type": "string",
"title": "Reference",
"maxLength": 200,
"minLength": 4,
"description": "Receipt or transaction reference. Hashed on arrival, never stored."
},
"purchased_on": {
"type": "string",
"title": "Purchased On",
"format": "date"
}
}
}
},
"title": "submit_outcomeArguments",
"required": [
"outcome",
"proof"
],
"properties": {
"proof": {
"oneOf": [
{
"$ref": "#/$defs/PaymentReceiptProof"
},
{
"$ref": "#/$defs/ShopifyOrderProof"
},
{
"$ref": "#/$defs/EmailReceiptProof"
}
],
"title": "Proof",
"discriminator": {
"mapping": {
"email_receipt": "#/$defs/EmailReceiptProof",
"shopify_order": "#/$defs/ShopifyOrderProof",
"payment_receipt": "#/$defs/PaymentReceiptProof"
},
"propertyName": "type"
}
},
"outcome": {
"enum": [
"kept_silent",
"kept_positive",
"complained",
"returned"
],
"type": "string",
"title": "Outcome"
},
"reasons": {
"type": "array",
"items": {
"enum": [
"size",
"quality",
"not_as_described",
"late_delivery",
"damaged",
"other"
],
"type": "string"
},
"title": "Reasons",
"default": [],
"maxItems": 6
},
"product_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Product Id",
"default": null
},
"product_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https://",
"maxLength": 500
},
{
"type": "null"
}
],
"title": "Product Url",
"default": null
}
}
}