Trusteed Agentic Commerce

get_merchant_profile

Read-onlyIdempotent

Get the complete profile — trust score, policies, compliance, and protocol support — of the merchant this MCP endpoint belongs to. Takes NO parameters: the merchant is fixed by which store's /:storeSlug/mcp endpoint you connected to, not by an argument. To read a different merchant's profile, call this same tool on that merchant's own endpoint instead.

Input Schema

Name	Required	Description	Default
No arguments

Output Schema

Name	Required	Description	Default
`store`	Yes
`trust`	Yes
`identity`	Yes
`policies`	Yes
`discovery`	Yes
`protocols`	Yes
`acpFeedUrl`	Yes
`compliance`	Yes
`manifest_jws`	Yes
`manifest_hash`	Yes
`protocolScopeNote`	Yes
`agentPolicySummary`	Yes
`manifest_signed_at`	Yes
`supportedProtocols`	Yes
`identityProviderType`	Yes
`enrichedCatalogEnabled`	Yes
`identityLinkingEnabled`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 26, 2026

addedOutput schema / properties / agentPolicySummary / properties / maxItemsPerOrder

Added value: +{
+  "additionalProperties": true,
+  "properties": {
+    "derivedFrom": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "units": {
+      "type": "integer"
+    }
+  },
+  "required": [
+    "units",
+    "derivedFrom"
+  ],
+  "type": "object"
+}

Changed1 schema field changedOct 15, 2026

addedOutput schema / properties / policies / properties / imported

Added value: +{
+  "additionalProperties": true,
+  "description": "Pages IMPORTED from the merchant's store platform (link, title, last-modified date only; no page content). These are NOT policies declared by the merchant and are not verified or summarised here: read the linked page for the actual terms. Absent = nothing imported.",
+  "properties": {
+    "privacy": {
+      "$ref": "#/properties/policies/properties/imported/properties/terms"
+    },
+    "terms": {
+      "additionalProperties": true,
+      "properties": {
+        "fetched_at": {
+          "type": "string"
+        },
+        "page_modified_at": {
+          "type": "string"
+        },
+        "provenance": {
+          "const": "imported_from_store_page",
+          "type": "string"
+        },
+        "source": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "url",
+        "page_modified_at",
+        "source",
+        "fetched_at",
+        "provenance"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

Changed3 schema fields changedSep 24, 2026

changedOutput schema / properties / trust / properties / legacyV2Components / description

Previous value: -"Legacy v2 self-declared breakdown (0-1). Does NOT explain overallScore (v4.1). For the components behind the published score call GET /api/v1/stores/{slug}/trust-score, or get_store_trust for the signed envelope. Omitted when every value is zero."New value: +"Legacy v2 self-declared breakdown (0-1). Does NOT explain overallScore (v4.1). For the components behind the published score call GET /api/v1/stores/{slug}/trust-score. Omitted when every value is zero."

addedOutput schema / properties / trust / properties / verificationProvenance

Added value: +{
+  "enum": [
+    "seeded",
+    "verified"
+  ],
+  "type": "string"
+}

changedOutput schema / properties / trust / required

Previous value: -[
-  "overallScore",
-  "scoringVersion",
-  "verificationLevel",
-  "componentsSourceOfTruth"
-]New value: +[
+  "overallScore",
+  "scoringVersion",
+  "verificationLevel",
+  "verificationProvenance",
+  "componentsSourceOfTruth"
+]

Changed12 schema fields changedSep 22, 2026
- addedOutput schema / properties / compliance / properties / provenance
```
Added value: +{
+  "$ref": "#/properties/identity/properties/provenance"
+}
```
- addedOutput schema / properties / compliance / properties / verified
```
Added value: +{
+  "$ref": "#/properties/identity/properties/verified"
+}
```
- addedOutput schema / properties / identity / properties / provenance
```
Added value: +{
+  "const": "synthetic_demo",
+  "description": "Present only on showcase/demo stores: this block is synthetic demo data, not a real seller's claim.",
+  "type": "string"
+}
```
- addedOutput schema / properties / identity / properties / verified
```
Added value: +{
+  "const": false,
+  "type": "boolean"
+}
```
- addedOutput schema / properties / policies / properties / payment / properties / provenance
```
Added value: +{
+  "$ref": "#/properties/identity/properties/provenance"
+}
```
- addedOutput schema / properties / policies / properties / payment / properties / verified
```
Added value: +{
+  "$ref": "#/properties/identity/properties/verified"
+}
```
- addedOutput schema / properties / policies / properties / returns / properties / provenance
```
Added value: +{
+  "$ref": "#/properties/identity/properties/provenance"
+}
```
- addedOutput schema / properties / policies / properties / returns / properties / verified
```
Added value: +{
+  "$ref": "#/properties/identity/properties/verified"
+}
```
- addedOutput schema / properties / policies / properties / shipping / properties / provenance
```
Added value: +{
+  "$ref": "#/properties/identity/properties/provenance"
+}
```
- addedOutput schema / properties / policies / properties / shipping / properties / verified
```
Added value: +{
+  "$ref": "#/properties/identity/properties/verified"
+}
```
- addedOutput schema / properties / policies / properties / warranty / properties / provenance
```
Added value: +{
+  "$ref": "#/properties/identity/properties/provenance"
+}
```
- addedOutput schema / properties / policies / properties / warranty / properties / verified
```
Added value: +{
+  "$ref": "#/properties/identity/properties/verified"
+}
```
Changed27 schema fields changedSep 17, 2026
- addedInput schema / additionalProperties
```
Added value: +true
```
- changedOutput schema / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / agentPolicySummary / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / agentPolicySummary / properties / allowedShippingCountries / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / agentPolicySummary / properties / maxCartValue / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / agentPolicySummary / properties / maxUnitsPerLine / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / compliance / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / discovery / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / identity / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / identity / properties / address / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / identity / properties / contact / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / policies / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / policies / properties / payment / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / policies / properties / payment / properties / withheldMethods / items / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / policies / properties / returns / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / policies / properties / shipping / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / policies / properties / warranty / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / protocols / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / protocols / properties / acp / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / protocols / properties / ap2 / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / protocols / properties / ucp / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / protocols / properties / vic / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / protocols / properties / x402 / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / store / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / supportedProtocols / items / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / trust / additionalProperties
```
Previous value: -falseNew value: +true
```
- changedOutput schema / properties / trust / properties / legacyV2Components / additionalProperties
```
Previous value: -falseNew value: +true
```

Changed2 schema fields changedSep 12, 2026

addedOutput schema / properties / agentPolicySummary / properties / maxUnitsPerLine

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "derivedFrom": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "units": {
+      "type": "integer"
+    }
+  },
+  "required": [
+    "units",
+    "derivedFrom"
+  ],
+  "type": "object"
+}

changedOutput schema / properties / agentPolicySummary / properties / source / enum

Previous value: -[
-  "merchant_rules",
-  "not_configured",
-  "lookup_failed"
-]New value: +[
+  "merchant_rules",
+  "platform_ceiling",
+  "not_configured",
+  "lookup_failed"
+]

Changed13 schema fields changedSep 11, 2026

addedOutput schema / properties / agentPolicySummary / properties / allowedShippingCountries / additionalProperties
```
Added value: +false
```
removedOutput schema / properties / agentPolicySummary / properties / allowedShippingCountries / items
```
Removed value: -{
-  "type": "string"
-}
```

addedOutput schema / properties / agentPolicySummary / properties / allowedShippingCountries / properties

Added value: +{
+  "countries": {
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "derivedFrom": {
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  }
+}

addedOutput schema / properties / agentPolicySummary / properties / allowedShippingCountries / required
```
Added value: +[
+  "countries",
+  "derivedFrom"
+]
```
changedOutput schema / properties / agentPolicySummary / properties / allowedShippingCountries / type
```
Previous value: -"array"New value: +"object"
```

removedOutput schema / properties / agentPolicySummary / properties / alwaysConfirm

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

removedOutput schema / properties / agentPolicySummary / properties / confirmationRequiredAboveUsd
```
Removed value: -{
-  "type": "number"
-}
```
addedOutput schema / properties / agentPolicySummary / properties / confirmationRequiredAtOrAbove
```
Added value: +{
+  "$ref": "#/properties/agentPolicySummary/properties/maxCartValue"
+}
```

addedOutput schema / properties / agentPolicySummary / properties / maxCartValue

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "amountCents": {
+      "type": "number"
+    },
+    "derivedFrom": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "amountCents",
+    "derivedFrom"
+  ],
+  "type": "object"
+}

removedOutput schema / properties / agentPolicySummary / properties / maxCartValueUsd
```
Removed value: -{
-  "type": "number"
-}
```

removedOutput schema / properties / agentPolicySummary / properties / neverConfirm

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

addedOutput schema / properties / agentPolicySummary / properties / source

Added value: +{
+  "enum": [
+    "merchant_rules",
+    "not_configured",
+    "lookup_failed"
+  ],
+  "type": "string"
+}

changedOutput schema / properties / agentPolicySummary / required

Previous value: -[
-  "maxCartValueUsd",
-  "confirmationRequiredAboveUsd",
-  "allowedShippingCountries",
-  "alwaysConfirm",
-  "neverConfirm"
-]New value: +[
+  "source"
+]

Changed1 schema field changedSep 10, 2026

changedOutput schema / properties / policies / properties / shipping / description

Previous value: -"Merchant-declared shipping policy. Absent = not declared. An absent freeThresholdCents is NOT 'free shipping on everything'."New value: +"Merchant-declared shipping policy for the merchant's OWN checkout. Absent = not declared. An absent freeThresholdCents is NOT 'free shipping on everything', and a declared one is NOT applied by get_shipping_rates: those rates are flat estimates that ignore the cart subtotal. Delivery days here may differ from the estimates too."

Changed16 schema fields changedSep 10, 2026

addedOutput schema / properties / compliance / properties / dataRetentionDays / description

Added value: +"Retention window as declared by the merchant. Absent = not declared; absence is NOT 'data is deleted immediately'."

addedOutput schema / properties / compliance / properties / gdprContactEmail
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / compliance / properties / pciDssLevel / description

Added value: +"PCI DSS merchant level as declared by the merchant (1-4). Absent = not declared."

removedOutput schema / properties / compliance / required

Removed value: -[
-  "gdprDataController",
-  "pciDssLevel",
-  "encryptionAtRest",
-  "encryptionInTransit",
-  "dataRetentionDays"
-]

removedOutput schema / properties / identity / properties / address / required

Removed value: -[
-  "street",
-  "city",
-  "state",
-  "country",
-  "postalCode"
-]

removedOutput schema / properties / identity / properties / contact / required
```
Removed value: -[
-  "email",
-  "phone",
-  "chat"
-]
```

removedOutput schema / properties / identity / required

Removed value: -[
-  "legalName",
-  "taxId",
-  "address",
-  "contact"
-]

addedOutput schema / properties / policies / properties / payment / description

Added value: +"Merchant-declared payment policy. Absent = not declared; ask at checkout."

removedOutput schema / properties / policies / properties / payment / required
```
Removed value: -[
-  "acceptedMethods",
-  "securityStandard"
-]
```

addedOutput schema / properties / policies / properties / returns / description

Added value: +"Merchant-declared return policy. Absent = not declared; absence is NEVER zero."

removedOutput schema / properties / policies / properties / returns / required

Removed value: -[
-  "windowDays",
-  "freeReturnShipping",
-  "refundMethod",
-  "refundProcessingDays"
-]

addedOutput schema / properties / policies / properties / shipping / description

Added value: +"Merchant-declared shipping policy. Absent = not declared. An absent freeThresholdCents is NOT 'free shipping on everything'."

removedOutput schema / properties / policies / properties / shipping / required

Removed value: -[
-  "freeThresholdCents",
-  "standardDeliveryDays",
-  "expressPrice",
-  "overnightPrice"
-]

addedOutput schema / properties / policies / properties / warranty / description

Added value: +"Merchant-declared warranty. Absent = not declared, NOT 'no warranty'."

removedOutput schema / properties / policies / properties / warranty / required
```
Removed value: -[
-  "periodYears",
-  "covered"
-]
```

removedOutput schema / properties / policies / required

Removed value: -[
-  "returns",
-  "shipping",
-  "warranty",
-  "payment"
-]

Changed1 schema field changedSep 8, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "acpFeedUrl": {
+      "type": "string"
+    },
+    "agentPolicySummary": {
+      "additionalProperties": false,
+      "properties": {
+        "allowedShippingCountries": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "alwaysConfirm": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "confirmationRequiredAboveUsd": {
+          "type": "number"
+        },
+        "maxCartValueUsd": {
+          "type": "number"
+        },
+        "neverConfirm": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "maxCartValueUsd",
+        "confirmationRequiredAboveUsd",
+        "allowedShippingCountries",
+        "alwaysConfirm",
+        "neverConfirm"
+      ],
+      "type": "object"
+    },
+    "compliance": {
+      "additionalProperties": false,
+      "properties": {
+        "dataRetentionDays": {
+          "type": "number"
+        },
+        "encryptionAtRest": {
+          "type": "string"
+        },
+        "encryptionInTransit": {
+          "type": "string"
+        },
+        "gdprDataController": {
+          "type": "string"
+        },
+        "pciDssLevel": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "gdprDataController",
+        "pciDssLevel",
+        "encryptionAtRest",
+        "encryptionInTransit",
+        "dataRetentionDays"
+      ],
+      "type": "object"
+    },
+    "discovery": {
+      "additionalProperties": false,
+      "properties": {
+        "agUiEndpoint": {
+          "type": "string"
+        },
+        "agentCard": {
+          "type": "string"
+        },
+        "agentPolicy": {
+          "type": "string"
+        },
+        "llmsTxt": {
+          "type": "string"
+        },
+        "mcpEndpoint": {
+          "type": "string"
+        },
+        "ucpProfile": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "mcpEndpoint",
+        "agUiEndpoint",
+        "agentCard",
+        "agentPolicy",
+        "ucpProfile",
+        "llmsTxt"
+      ],
+      "type": "object"
+    },
+    "enrichedCatalogEnabled": {
+      "type": "boolean"
+    },
+    "identity": {
+      "additionalProperties": false,
+      "properties": {
+        "address": {
+          "additionalProperties": false,
+          "properties": {
+            "city": {
+              "type": "string"
+            },
+            "country": {
+              "type": "string"
+            },
+            "postalCode": {
+              "type": "string"
+            },
+            "state": {
+              "type": "string"
+            },
+            "street": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "street",
+            "city",
+            "state",
+            "country",
+            "postalCode"
+          ],
+          "type": "object"
+        },
+        "contact": {
+          "additionalProperties": false,
+          "properties": {
+            "chat": {
+              "type": "string"
+            },
+            "email": {
+              "type": "string"
+            },
+            "phone": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "email",
+            "phone",
+            "chat"
+          ],
+          "type": "object"
+        },
+        "legalName": {
+          "type": "string"
+        },
+        "taxId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "legalName",
+        "taxId",
+        "address",
+        "contact"
+      ],
+      "type": "object"
+    },
+    "identityLinkingEnabled": {
+      "type": "boolean"
+    },
+    "identityProviderType": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "manifest_hash": {
+      "type": "string"
+    },
+    "manifest_jws": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "manifest_signed_at": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "policies": {
+      "additionalProperties": false,
+      "properties": {
+        "payment": {
+          "additionalProperties": false,
+          "properties": {
+            "acceptedMethods": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "securityStandard": {
+              "type": "string"
+            },
+            "withheldMethods": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "method": {
+                    "type": "string"
+                  },
+                  "reason": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "method",
+                  "reason"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "acceptedMethods",
+            "securityStandard"
+          ],
+          "type": "object"
+        },
+        "returns": {
+          "additionalProperties": false,
+          "properties": {
+            "freeReturnShipping": {
+              "type": "string"
+            },
+            "refundMethod": {
+              "type": "string"
+            },
+            "refundProcessingDays": {
+              "type": "number"
+            },
+            "windowDays": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "windowDays",
+            "freeReturnShipping",
+            "refundMethod",
+            "refundProcessingDays"
+          ],
+          "type": "object"
+        },
+        "shipping": {
+          "additionalProperties": false,
+          "properties": {
+            "expressPrice": {
+              "type": "number"
+            },
+            "freeThresholdCents": {
+              "type": "number"
+            },
+            "overnightPrice": {
+              "type": "number"
+            },
+            "standardDeliveryDays": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "freeThresholdCents",
+            "standardDeliveryDays",
+            "expressPrice",
+            "overnightPrice"
+          ],
+          "type": "object"
+        },
+        "warranty": {
+          "additionalProperties": false,
+          "properties": {
+            "covered": {
+              "type": "string"
+            },
+            "periodYears": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "periodYears",
+            "covered"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "returns",
+        "shipping",
+        "warranty",
+        "payment"
+      ],
+      "type": "object"
+    },
+    "protocolScopeNote": {
+      "type": "string"
+    },
+    "protocols": {
+      "additionalProperties": false,
+      "properties": {
+        "acp": {
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "provider": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "enabled",
+            "provider"
+          ],
+          "type": "object"
+        },
+        "ap2": {
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "provider": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "enabled",
+            "provider"
+          ],
+          "type": "object"
+        },
+        "ucp": {
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "version": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "enabled",
+            "version"
+          ],
+          "type": "object"
+        },
+        "vic": {
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "environment": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "enabled",
+            "environment"
+          ],
+          "type": "object"
+        },
+        "x402": {
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "provider": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "enabled",
+            "provider"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "acp",
+        "ap2",
+        "x402"
+      ],
+      "type": "object"
+    },
+    "store": {
+      "additionalProperties": false,
+      "properties": {
+        "description": {
+          "type": "string"
+        },
+        "isDemo": {
+          "type": "boolean"
+        },
+        "name": {
+          "type": "string"
+        },
+        "slug": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "name",
+        "slug",
+        "description",
+        "isDemo"
+      ],
+      "type": "object"
+    },
+    "supportedProtocols": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "description": {
+            "type": "string"
+          },
+          "mode": {
+            "enum": [
+              "live",
+              "sandbox",
+              "coming_soon"
+            ],
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "mode",
+          "description"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "trust": {
+      "additionalProperties": false,
+      "properties": {
+        "componentsSourceOfTruth": {
+          "description": "Canonical source for the components behind overallScore.",
+          "type": "string"
+        },
+        "legacyV2Components": {
+          "additionalProperties": false,
+          "description": "Legacy v2 self-declared breakdown (0-1). Does NOT explain overallScore (v4.1). For the components behind the published score call GET /api/v1/stores/{slug}/trust-score, or get_store_trust for the signed envelope. Omitted when every value is zero.",
+          "properties": {
+            "catalogCompleteness": {
+              "type": "number"
+            },
+            "dataFreshness": {
+              "type": "number"
+            },
+            "policyClarity": {
+              "type": "number"
+            },
+            "priceAccuracy": {
+              "type": "number"
+            },
+            "responseTime": {
+              "type": "number"
+            },
+            "returnRate": {
+              "type": "number"
+            },
+            "stockReliability": {
+              "type": "number"
+            },
+            "verificationDepth": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "catalogCompleteness",
+            "dataFreshness",
+            "priceAccuracy",
+            "stockReliability",
+            "policyClarity",
+            "responseTime",
+            "returnRate",
+            "verificationDepth"
+          ],
+          "type": "object"
+        },
+        "overallScore": {
+          "description": "Trust score, engine v4.1, scale 0-100. null = not published.",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "scoringVersion": {
+          "description": "Engine version behind overallScore ('4.1'), null when absent.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "verificationLevel": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "overallScore",
+        "scoringVersion",
+        "verificationLevel",
+        "componentsSourceOfTruth"
+      ],
+      "type": "object"
+    }
+  },
+  "required": [
+    "store",
+    "identity",
+    "trust",
+    "policies",
+    "compliance",
+    "protocols",
+    "supportedProtocols",
+    "protocolScopeNote",
+    "agentPolicySummary",
+    "discovery",
+    "identityLinkingEnabled",
+    "identityProviderType",
+    "acpFeedUrl",
+    "enrichedCatalogEnabled",
+    "manifest_hash",
+    "manifest_signed_at",
+    "manifest_jws"
+  ],
+  "type": "object"
+}

Changed2 schema fields changedAug 24, 2026
- addedInput schema / $schema
```
Added value: +"http://json-schema.org/draft-07/schema#"
```
- addedInput schema / properties
```
Added value: +{}
```

Changed3 schema fields changedJul 10, 2026

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

removedInput schema / properties
```
Removed value: -{}
```

changedOutput schema / (root)

Previous value: -{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "additionalProperties": false,
-  "properties": {
-    "acpFeedUrl": {
-      "type": "string"
-    },
-    "agentPolicySummary": {
-      "additionalProperties": false,
-      "properties": {
-        "allowedShippingCountries": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "alwaysConfirm": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "confirmationRequiredAboveUsd": {
-          "type": "number"
-        },
-        "maxCartValueUsd": {
-          "type": "number"
-        },
-        "neverConfirm": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        }
-      },
-      "required": [
-        "maxCartValueUsd",
-        "confirmationRequiredAboveUsd",
-        "allowedShippingCountries",
-        "alwaysConfirm",
-        "neverConfirm"
-      ],
-      "type": "object"
-    },
-    "compliance": {
-      "additionalProperties": false,
-      "properties": {
-        "dataRetentionDays": {
-          "type": "number"
-        },
-        "encryptionAtRest": {
-          "type": "string"
-        },
-        "encryptionInTransit": {
-          "type": "string"
-        },
-        "gdprDataController": {
-          "type": "string"
-        },
-        "pciDssLevel": {
-          "type": "number"
-        }
-      },
-      "required": [
-        "gdprDataController",
-        "pciDssLevel",
-        "encryptionAtRest",
-        "encryptionInTransit",
-        "dataRetentionDays"
-      ],
-      "type": "object"
-    },
-    "discovery": {
-      "additionalProperties": false,
-      "properties": {
-        "agUiEndpoint": {
-          "type": "string"
-        },
-        "agentCard": {
-          "type": "string"
-        },
-        "agentPolicy": {
-          "type": "string"
-        },
-        "llmsTxt": {
-          "type": "string"
-        },
-        "mcpEndpoint": {
-          "type": "string"
-        },
-        "ucpProfile": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "mcpEndpoint",
-        "agUiEndpoint",
-        "agentCard",
-        "agentPolicy",
-        "ucpProfile",
-        "llmsTxt"
-      ],
-      "type": "object"
-    },
-    "enrichedCatalogEnabled": {
-      "type": "boolean"
-    },
-    "identity": {
-      "additionalProperties": false,
-      "properties": {
-        "address": {
-          "additionalProperties": false,
-          "properties": {
-            "city": {
-              "type": "string"
-            },
-            "country": {
-              "type": "string"
-            },
-            "postalCode": {
-              "type": "string"
-            },
-            "state": {
-              "type": "string"
-            },
-            "street": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "street",
-            "city",
-            "state",
-            "country",
-            "postalCode"
-          ],
-          "type": "object"
-        },
-        "contact": {
-          "additionalProperties": false,
-          "properties": {
-            "chat": {
-              "type": "string"
-            },
-            "email": {
-              "type": "string"
-            },
-            "phone": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "email",
-            "phone",
-            "chat"
-          ],
-          "type": "object"
-        },
-        "legalName": {
-          "type": "string"
-        },
-        "taxId": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "legalName",
-        "taxId",
-        "address",
-        "contact"
-      ],
-      "type": "object"
-    },
-    "identityLinkingEnabled": {
-      "type": "boolean"
-    },
-    "identityProviderType": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "manifest_hash": {
-      "type": "string"
-    },
-    "manifest_jws": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "manifest_signed_at": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "policies": {
-      "additionalProperties": false,
-      "properties": {
-        "payment": {
-          "additionalProperties": false,
-          "properties": {
-            "acceptedMethods": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "securityStandard": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "acceptedMethods",
-            "securityStandard"
-          ],
-          "type": "object"
-        },
-        "returns": {
-          "additionalProperties": false,
-          "properties": {
-            "freeReturnShipping": {
-              "type": "string"
-            },
-            "refundMethod": {
-              "type": "string"
-            },
-            "refundProcessingDays": {
-              "type": "number"
-            },
-            "windowDays": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "windowDays",
-            "freeReturnShipping",
-            "refundMethod",
-            "refundProcessingDays"
-          ],
-          "type": "object"
-        },
-        "shipping": {
-          "additionalProperties": false,
-          "properties": {
-            "expressPrice": {
-              "type": "number"
-            },
-            "freeThresholdCents": {
-              "type": "number"
-            },
-            "overnightPrice": {
-              "type": "number"
-            },
-            "standardDeliveryDays": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "freeThresholdCents",
-            "standardDeliveryDays",
-            "expressPrice",
-            "overnightPrice"
-          ],
-          "type": "object"
-        },
-        "warranty": {
-          "additionalProperties": false,
-          "properties": {
-            "covered": {
-              "type": "string"
-            },
-            "periodYears": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "periodYears",
-            "covered"
-          ],
-          "type": "object"
-        }
-      },
-      "required": [
-        "returns",
-        "shipping",
-        "warranty",
-        "payment"
-      ],
-      "type": "object"
-    },
-    "protocols": {
-      "additionalProperties": false,
-      "properties": {
-        "acp": {
-          "additionalProperties": false,
-          "properties": {
-            "enabled": {
-              "type": "boolean"
-            },
-            "provider": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "enabled",
-            "provider"
-          ],
-          "type": "object"
-        },
-        "ap2": {
-          "additionalProperties": false,
-          "properties": {
-            "enabled": {
-              "type": "boolean"
-            },
-            "provider": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "enabled",
-            "provider"
-          ],
-          "type": "object"
-        },
-        "x402": {
-          "additionalProperties": false,
-          "properties": {
-            "enabled": {
-              "type": "boolean"
-            },
-            "provider": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "enabled",
-            "provider"
-          ],
-          "type": "object"
-        }
-      },
-      "required": [
-        "acp",
-        "ap2",
-        "x402"
-      ],
-      "type": "object"
-    },
-    "store": {
-      "additionalProperties": false,
-      "properties": {
-        "description": {
-          "type": "string"
-        },
-        "isDemo": {
-          "type": "boolean"
-        },
-        "name": {
-          "type": "string"
-        },
-        "slug": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "name",
-        "slug",
-        "description",
-        "isDemo"
-      ],
-      "type": "object"
-    },
-    "supportedProtocols": {
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "description": {
-            "type": "string"
-          },
-          "mode": {
-            "enum": [
-              "live",
-              "sandbox",
-              "coming_soon"
-            ],
-            "type": "string"
-          },
-          "name": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "name",
-          "mode",
-          "description"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "trust": {
-      "additionalProperties": false,
-      "properties": {
-        "components": {
-          "additionalProperties": false,
-          "properties": {
-            "catalogCompleteness": {
-              "type": "number"
-            },
-            "dataFreshness": {
-              "type": "number"
-            },
-            "policyClarity": {
-              "type": "number"
-            },
-            "priceAccuracy": {
-              "type": "number"
-            },
-            "responseTime": {
-              "type": "number"
-            },
-            "returnRate": {
-              "type": "number"
-            },
-            "stockReliability": {
-              "type": "number"
-            },
-            "verificationDepth": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "catalogCompleteness",
-            "dataFreshness",
-            "priceAccuracy",
-            "stockReliability",
-            "policyClarity",
-            "responseTime",
-            "returnRate",
-            "verificationDepth"
-          ],
-          "type": "object"
-        },
-        "overallScore": {
-          "type": "number"
-        },
-        "verificationLevel": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "overallScore",
-        "verificationLevel",
-        "components"
-      ],
-      "type": "object"
-    }
-  },
-  "required": [
-    "store",
-    "identity",
-    "trust",
-    "policies",
-    "compliance",
-    "protocols",
-    "supportedProtocols",
-    "agentPolicySummary",
-    "discovery",
-    "identityLinkingEnabled",
-    "identityProviderType",
-    "acpFeedUrl",
-    "enrichedCatalogEnabled",
-    "manifest_hash",
-    "manifest_signed_at",
-    "manifest_jws"
-  ],
-  "type": "object"
-}New value: +null

Changed4 schema fields changedMay 1, 2026

addedOutput schema / properties / manifest_hash
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / manifest_jws

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / manifest_signed_at

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

changedOutput schema / required

Previous value: -[
-  "store",
-  "identity",
-  "trust",
-  "policies",
-  "compliance",
-  "protocols",
-  "supportedProtocols",
-  "agentPolicySummary",
-  "discovery",
-  "identityLinkingEnabled",
-  "identityProviderType",
-  "acpFeedUrl",
-  "enrichedCatalogEnabled"
-]New value: +[
+  "store",
+  "identity",
+  "trust",
+  "policies",
+  "compliance",
+  "protocols",
+  "supportedProtocols",
+  "agentPolicySummary",
+  "discovery",
+  "identityLinkingEnabled",
+  "identityProviderType",
+  "acpFeedUrl",
+  "enrichedCatalogEnabled",
+  "manifest_hash",
+  "manifest_signed_at",
+  "manifest_jws"
+]

First observedApr 28, 2026

TDQS

A4.6/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, non-destructive behavior, and openWorldHint, so the description needn't restate safety. It adds important behavioral context beyond the annotations: there is no parameter-based targeting, merchant identity is determined by the connected endpoint, and reading another merchant requires switching endpoints. It does not discuss auth or rate limits, but the endpoint-scoping insight is substantial.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three tight sentences with no waste. It front-loads what the tool returns, then immediately addresses the critical invocation constraint, then the alternative path for other merchants.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so the description does not need to enumerate return fields, and annotations already cover the safety profile. Given that, the description is complete: it tells the agent what the tool returns, that it takes no arguments, and how to target a different merchant.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With zero parameters, the schema itself provides no semantic guidance. The description compensates by explaining why no parameters exist and how merchant identity is instead supplied implicitly by the endpoint. That is exactly the kind of clarification a parameterless tool needs.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource ('Get the complete profile ... of the merchant') and enumerates the contents: trust score, policies, compliance, and protocol support. It clearly distinguishes this merchant-scoped profile from sibling trust tools by tying the resource to the MCP endpoint itself.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly explains the unusual invocation model: this tool takes no parameters because the merchant is fixed by the connected endpoint, and it directs the agent to call the same tool on another merchant's endpoint when a different merchant is needed. It does not explicitly compare itself to siblings like get_store_trust or get_trust_receipt, so it falls short of full alternative routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Trusteed Agentic Commerce tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?