Loppee

Explain Recommendation

explain_recommendation

Read-only

Use this when the user asks why a known published business is or is not recommendable on Loppee. Returns the published class, disclosure, recommendation basis, commercial-neutrality statement, and citation without exposing private weighting.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "business_id": "<business_id>"
    },
    "name": "explain_recommendation"
  }
}

Input Schema

Name	Required	Description	Default
`business_id`	Yes	Loppee business id of a published Trust Card.

Output Schema

Name	Required	Description	Default
`ok`	Yes
`data`	No
`error`	No
`contract_version`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 26, 2026

addedOutput schema / properties / data / properties / loppee_attestation

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "alg": {
+      "const": "ES256",
+      "type": "string"
+    },
+    "expires_at": {
+      "type": "string"
+    },
+    "format": {
+      "const": "jws-compact",
+      "type": "string"
+    },
+    "issued_at": {
+      "type": "string"
+    },
+    "jwks_uri": {
+      "type": "string"
+    },
+    "jws": {
+      "type": "string"
+    },
+    "kid": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "format",
+    "alg",
+    "kid",
+    "jwks_uri",
+    "issued_at",
+    "expires_at",
+    "jws"
+  ],
+  "type": "object"
+}

Changed1 schema field changedOct 24, 2026

addedOutput schema / properties / data / properties / business_status

Added value: +{
+  "enum": [
+    "Verified",
+    "Listed",
+    "Registry"
+  ],
+  "type": "string"
+}

Changed7 schema fields changedSep 1, 2026

removedOutput schema / definitions

Removed value: -{
-  "__schema0": {
-    "anyOf": [
-      {
-        "type": "string"
-      },
-      {
-        "type": "number"
-      },
-      {
-        "type": "boolean"
-      },
-      {
-        "type": "null"
-      },
-      {
-        "items": {
-          "$ref": "#/definitions/__schema0"
-        },
-        "type": "array"
-      },
-      {
-        "additionalProperties": {
-          "$ref": "#/definitions/__schema0"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      }
-    ]
-  }
-}

addedOutput schema / properties / data / additionalProperties
```
Added value: +false
```

removedOutput schema / properties / data / oneOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "basis": {
-        "type": "string"
-      },
-      "business_id": {
-        "type": "string"
-      },
-      "citation": {
-        "additionalProperties": false,
-        "properties": {
-          "registry": {
-            "type": "string"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "registry",
-          "url"
-        ],
-        "type": "object"
-      },
-      "commercial_influence": {
-        "const": "none",
-        "type": "string"
-      },
-      "decision": {
-        "enum": [
-          "verified",
-          "listed"
-        ],
-        "type": "string"
-      },
-      "display_name": {
-        "type": "string"
-      },
-      "endpoint": {
-        "const": "explain_recommendation",
-        "type": "string"
-      },
-      "public_profile_url": {
-        "type": "string"
-      },
-      "recommendation_order": {
-        "const": "verified_first_listed_fill",
-        "type": "string"
-      },
-      "registry_name": {
-        "type": "string"
-      },
-      "schema_version": {
-        "const": "3.0",
-        "type": "string"
-      },
-      "trust_card_url": {
-        "type": "string"
-      },
-      "trust_model_version": {
-        "const": "v3",
-        "type": "string"
-      },
-      "verification_class": {
-        "const": "verified",
-        "type": "string"
-      },
-      "verification_disclosure": {
-        "anyOf": [
-          {
-            "const": "Loppee completed this business's registration, professional license, and contact checks.",
-            "type": "string"
-          },
-          {
-            "const": "Loppee completed this business's registration and contact checks.",
-            "type": "string"
-          }
-        ]
-      }
-    },
-    "required": [
-      "schema_version",
-      "registry_name",
-      "endpoint",
-      "business_id",
-      "display_name",
-      "decision",
-      "basis",
-      "recommendation_order",
-      "commercial_influence",
-      "citation",
-      "trust_card_url",
-      "public_profile_url",
-      "trust_model_version",
-      "verification_class",
-      "verification_disclosure"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "basis": {
-        "type": "string"
-      },
-      "business_id": {
-        "type": "string"
-      },
-      "citation": {
-        "additionalProperties": false,
-        "properties": {
-          "registry": {
-            "type": "string"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "registry",
-          "url"
-        ],
-        "type": "object"
-      },
-      "commercial_influence": {
-        "const": "none",
-        "type": "string"
-      },
-      "decision": {
-        "enum": [
-          "verified",
-          "listed"
-        ],
-        "type": "string"
-      },
-      "display_name": {
-        "type": "string"
-      },
-      "endpoint": {
-        "const": "explain_recommendation",
-        "type": "string"
-      },
-      "public_profile_url": {
-        "type": "string"
-      },
-      "recommendation_order": {
-        "const": "verified_first_listed_fill",
-        "type": "string"
-      },
-      "registry_name": {
-        "type": "string"
-      },
-      "schema_version": {
-        "const": "3.0",
-        "type": "string"
-      },
-      "trust_card_url": {
-        "type": "string"
-      },
-      "trust_model_version": {
-        "const": "v3",
-        "type": "string"
-      },
-      "verification_class": {
-        "const": "listed",
-        "type": "string"
-      },
-      "verification_disclosure": {
-        "anyOf": [
-          {
-            "const": "Recommended by customers. NOT verified by Loppee.",
-            "type": "string"
-          },
-          {
-            "const": "Listed on Loppee. NOT verified by Loppee.",
-            "type": "string"
-          }
-        ]
-      }
-    },
-    "required": [
-      "schema_version",
-      "registry_name",
-      "endpoint",
-      "business_id",
-      "display_name",
-      "decision",
-      "basis",
-      "recommendation_order",
-      "commercial_influence",
-      "citation",
-      "trust_card_url",
-      "public_profile_url",
-      "trust_model_version",
-      "verification_class",
-      "verification_disclosure"
-    ],
-    "type": "object"
-  }
-]

addedOutput schema / properties / data / properties

Added value: +{
+  "basis": {
+    "type": "string"
+  },
+  "business_id": {
+    "type": "string"
+  },
+  "citation": {
+    "additionalProperties": false,
+    "properties": {
+      "registry": {
+        "type": "string"
+      },
+      "url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "registry",
+      "url"
+    ],
+    "type": "object"
+  },
+  "commercial_influence": {
+    "const": "none",
+    "type": "string"
+  },
+  "decision": {
+    "type": "string"
+  },
+  "display_name": {
+    "type": "string"
+  },
+  "endpoint": {
+    "const": "explain_recommendation",
+    "type": "string"
+  },
+  "public_profile_url": {
+    "type": "string"
+  },
+  "recommendation_order": {
+    "type": "string"
+  },
+  "registry_name": {
+    "type": "string"
+  },
+  "schema_version": {
+    "type": "string"
+  },
+  "trust_card_url": {
+    "type": "string"
+  },
+  "trust_model_version": {
+    "type": "string"
+  },
+  "verification_class": {
+    "type": "string"
+  },
+  "verification_disclosure": {
+    "type": "string"
+  }
+}

addedOutput schema / properties / data / required

Added value: +[
+  "endpoint",
+  "business_id",
+  "display_name",
+  "verification_class",
+  "verification_disclosure",
+  "decision",
+  "basis",
+  "recommendation_order",
+  "commercial_influence",
+  "citation",
+  "trust_card_url",
+  "public_profile_url"
+]

addedOutput schema / properties / data / type
```
Added value: +"object"
```

removedOutput schema / properties / error / properties / details

Removed value: -{
-  "allOf": [
-    {
-      "$ref": "#/definitions/__schema0"
-    }
-  ]
-}

Changed6 schema fields changedJul 18, 2026

removedOutput schema / properties / data / additionalProperties
```
Removed value: -{}
```

addedOutput schema / properties / data / oneOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "basis": {
+        "type": "string"
+      },
+      "business_id": {
+        "type": "string"
+      },
+      "citation": {
+        "additionalProperties": false,
+        "properties": {
+          "registry": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "registry",
+          "url"
+        ],
+        "type": "object"
+      },
+      "commercial_influence": {
+        "const": "none",
+        "type": "string"
+      },
+      "decision": {
+        "enum": [
+          "verified",
+          "listed"
+        ],
+        "type": "string"
+      },
+      "display_name": {
+        "type": "string"
+      },
+      "endpoint": {
+        "const": "explain_recommendation",
+        "type": "string"
+      },
+      "public_profile_url": {
+        "type": "string"
+      },
+      "recommendation_order": {
+        "const": "verified_first_listed_fill",
+        "type": "string"
+      },
+      "registry_name": {
+        "type": "string"
+      },
+      "schema_version": {
+        "const": "3.0",
+        "type": "string"
+      },
+      "trust_card_url": {
+        "type": "string"
+      },
+      "trust_model_version": {
+        "const": "v3",
+        "type": "string"
+      },
+      "verification_class": {
+        "const": "verified",
+        "type": "string"
+      },
+      "verification_disclosure": {
+        "anyOf": [
+          {
+            "const": "Loppee completed this business's registration, professional license, and contact checks.",
+            "type": "string"
+          },
+          {
+            "const": "Loppee completed this business's registration and contact checks.",
+            "type": "string"
+          }
+        ]
+      }
+    },
+    "required": [
+      "schema_version",
+      "registry_name",
+      "endpoint",
+      "business_id",
+      "display_name",
+      "decision",
+      "basis",
+      "recommendation_order",
+      "commercial_influence",
+      "citation",
+      "trust_card_url",
+      "public_profile_url",
+      "trust_model_version",
+      "verification_class",
+      "verification_disclosure"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "basis": {
+        "type": "string"
+      },
+      "business_id": {
+        "type": "string"
+      },
+      "citation": {
+        "additionalProperties": false,
+        "properties": {
+          "registry": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "registry",
+          "url"
+        ],
+        "type": "object"
+      },
+      "commercial_influence": {
+        "const": "none",
+        "type": "string"
+      },
+      "decision": {
+        "enum": [
+          "verified",
+          "listed"
+        ],
+        "type": "string"
+      },
+      "display_name": {
+        "type": "string"
+      },
+      "endpoint": {
+        "const": "explain_recommendation",
+        "type": "string"
+      },
+      "public_profile_url": {
+        "type": "string"
+      },
+      "recommendation_order": {
+        "const": "verified_first_listed_fill",
+        "type": "string"
+      },
+      "registry_name": {
+        "type": "string"
+      },
+      "schema_version": {
+        "const": "3.0",
+        "type": "string"
+      },
+      "trust_card_url": {
+        "type": "string"
+      },
+      "trust_model_version": {
+        "const": "v3",
+        "type": "string"
+      },
+      "verification_class": {
+        "const": "listed",
+        "type": "string"
+      },
+      "verification_disclosure": {
+        "anyOf": [
+          {
+            "const": "Recommended by customers. NOT verified by Loppee.",
+            "type": "string"
+          },
+          {
+            "const": "Listed on Loppee. NOT verified by Loppee.",
+            "type": "string"
+          }
+        ]
+      }
+    },
+    "required": [
+      "schema_version",
+      "registry_name",
+      "endpoint",
+      "business_id",
+      "display_name",
+      "decision",
+      "basis",
+      "recommendation_order",
+      "commercial_influence",
+      "citation",
+      "trust_card_url",
+      "public_profile_url",
+      "trust_model_version",
+      "verification_class",
+      "verification_disclosure"
+    ],
+    "type": "object"
+  }
+]

removedOutput schema / properties / data / properties

Removed value: -{
-  "agent_readiness": {
-    "additionalProperties": false,
-    "properties": {
-      "compatibility_score": {
-        "type": "number"
-      },
-      "level": {
-        "type": "string"
-      },
-      "recommendation_allowed": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "compatibility_score",
-      "level",
-      "recommendation_allowed"
-    ],
-    "type": "object"
-  },
-  "basis": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "business_id": {
-    "type": "string"
-  },
-  "business_verification_state": {
-    "type": "string"
-  },
-  "citation": {
-    "additionalProperties": {},
-    "properties": {
-      "cite_as": {
-        "type": "string"
-      },
-      "human_url": {
-        "type": "string"
-      },
-      "registry": {
-        "type": "string"
-      },
-      "source_url": {
-        "type": "string"
-      },
-      "verified_at_field": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "cite_as",
-      "registry",
-      "source_url",
-      "human_url",
-      "verified_at_field"
-    ],
-    "type": "object"
-  },
-  "commercial_neutrality": {
-    "additionalProperties": {},
-    "properties": {
-      "affects_recommendation_rank": {
-        "type": "boolean"
-      },
-      "affects_risk_level": {
-        "const": false,
-        "type": "boolean"
-      },
-      "affects_safe_to_recommend": {
-        "const": false,
-        "type": "boolean"
-      },
-      "affects_trust_score": {
-        "const": false,
-        "type": "boolean"
-      },
-      "commercial_influence_on_placement": {
-        "type": "string"
-      },
-      "commercial_influence_on_trust": {
-        "const": "none",
-        "type": "string"
-      },
-      "commercial_status": {
-        "type": "string"
-      },
-      "statement": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "commercial_influence_on_trust",
-      "commercial_influence_on_placement",
-      "commercial_status",
-      "affects_trust_score",
-      "affects_risk_level",
-      "affects_safe_to_recommend",
-      "affects_recommendation_rank",
-      "statement"
-    ],
-    "type": "object"
-  },
-  "confidence": {
-    "type": "string"
-  },
-  "decision": {
-    "enum": [
-      "safe_to_recommend",
-      "not_recommended"
-    ],
-    "type": "string"
-  },
-  "display_name": {
-    "type": "string"
-  },
-  "evidence": {
-    "additionalProperties": {},
-    "properties": {
-      "total": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "verified": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "verified",
-      "total"
-    ],
-    "type": "object"
-  },
-  "meets_score_threshold": {
-    "type": "boolean"
-  },
-  "public_profile_url": {
-    "type": "string"
-  },
-  "publishing_rule": {
-    "type": "string"
-  },
-  "recommendation_caveat": {
-    "type": "string"
-  },
-  "registry_name": {
-    "type": "string"
-  },
-  "risk_level": {
-    "type": "string"
-  },
-  "safe_to_recommend": {
-    "type": "boolean"
-  },
-  "schema_version": {
-    "type": "string"
-  },
-  "score_threshold": {
-    "type": "number"
-  },
-  "trust_card_url": {
-    "type": "string"
-  },
-  "trust_score": {
-    "anyOf": [
-      {
-        "type": "number"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "verification_status": {
-    "type": "string"
-  }
-}

removedOutput schema / properties / data / required

Removed value: -[
-  "schema_version",
-  "registry_name",
-  "business_id",
-  "display_name",
-  "decision",
-  "safe_to_recommend",
-  "trust_score",
-  "score_threshold",
-  "meets_score_threshold",
-  "business_verification_state",
-  "verification_status",
-  "risk_level",
-  "confidence",
-  "publishing_rule",
-  "basis",
-  "evidence",
-  "agent_readiness",
-  "commercial_neutrality",
-  "recommendation_caveat",
-  "citation",
-  "trust_card_url",
-  "public_profile_url"
-]

removedOutput schema / properties / data / type
```
Removed value: -"object"
```
changedOutput schema / properties / error / additionalProperties
```
Previous value: -{}New value: +false
```

Changed1 schema field changedJul 10, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "definitions": {
+    "__schema0": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        },
+        {
+          "items": {
+            "$ref": "#/definitions/__schema0"
+          },
+          "type": "array"
+        },
+        {
+          "additionalProperties": {
+            "$ref": "#/definitions/__schema0"
+          },
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        }
+      ]
+    }
+  },
+  "oneOf": [
+    {
+      "not": {
+        "required": [
+          "error"
+        ]
+      },
+      "properties": {
+        "ok": {
+          "const": true
+        }
+      },
+      "required": [
+        "ok",
+        "data"
+      ]
+    },
+    {
+      "not": {
+        "required": [
+          "data"
+        ]
+      },
+      "properties": {
+        "ok": {
+          "const": false
+        }
+      },
+      "required": [
+        "ok",
+        "error"
+      ]
+    }
+  ],
+  "properties": {
+    "contract_version": {
+      "const": "1.0",
+      "type": "string"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "agent_readiness": {
+          "additionalProperties": false,
+          "properties": {
+            "compatibility_score": {
+              "type": "number"
+            },
+            "level": {
+              "type": "string"
+            },
+            "recommendation_allowed": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "compatibility_score",
+            "level",
+            "recommendation_allowed"
+          ],
+          "type": "object"
+        },
+        "basis": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "business_id": {
+          "type": "string"
+        },
+        "business_verification_state": {
+          "type": "string"
+        },
+        "citation": {
+          "additionalProperties": {},
+          "properties": {
+            "cite_as": {
+              "type": "string"
+            },
+            "human_url": {
+              "type": "string"
+            },
+            "registry": {
+              "type": "string"
+            },
+            "source_url": {
+              "type": "string"
+            },
+            "verified_at_field": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "cite_as",
+            "registry",
+            "source_url",
+            "human_url",
+            "verified_at_field"
+          ],
+          "type": "object"
+        },
+        "commercial_neutrality": {
+          "additionalProperties": {},
+          "properties": {
+            "affects_recommendation_rank": {
+              "type": "boolean"
+            },
+            "affects_risk_level": {
+              "const": false,
+              "type": "boolean"
+            },
+            "affects_safe_to_recommend": {
+              "const": false,
+              "type": "boolean"
+            },
+            "affects_trust_score": {
+              "const": false,
+              "type": "boolean"
+            },
+            "commercial_influence_on_placement": {
+              "type": "string"
+            },
+            "commercial_influence_on_trust": {
+              "const": "none",
+              "type": "string"
+            },
+            "commercial_status": {
+              "type": "string"
+            },
+            "statement": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "commercial_influence_on_trust",
+            "commercial_influence_on_placement",
+            "commercial_status",
+            "affects_trust_score",
+            "affects_risk_level",
+            "affects_safe_to_recommend",
+            "affects_recommendation_rank",
+            "statement"
+          ],
+          "type": "object"
+        },
+        "confidence": {
+          "type": "string"
+        },
+        "decision": {
+          "enum": [
+            "safe_to_recommend",
+            "not_recommended"
+          ],
+          "type": "string"
+        },
+        "display_name": {
+          "type": "string"
+        },
+        "evidence": {
+          "additionalProperties": {},
+          "properties": {
+            "total": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "verified": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "verified",
+            "total"
+          ],
+          "type": "object"
+        },
+        "meets_score_threshold": {
+          "type": "boolean"
+        },
+        "public_profile_url": {
+          "type": "string"
+        },
+        "publishing_rule": {
+          "type": "string"
+        },
+        "recommendation_caveat": {
+          "type": "string"
+        },
+        "registry_name": {
+          "type": "string"
+        },
+        "risk_level": {
+          "type": "string"
+        },
+        "safe_to_recommend": {
+          "type": "boolean"
+        },
+        "schema_version": {
+          "type": "string"
+        },
+        "score_threshold": {
+          "type": "number"
+        },
+        "trust_card_url": {
+          "type": "string"
+        },
+        "trust_score": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "verification_status": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "schema_version",
+        "registry_name",
+        "business_id",
+        "display_name",
+        "decision",
+        "safe_to_recommend",
+        "trust_score",
+        "score_threshold",
+        "meets_score_threshold",
+        "business_verification_state",
+        "verification_status",
+        "risk_level",
+        "confidence",
+        "publishing_rule",
+        "basis",
+        "evidence",
+        "agent_readiness",
+        "commercial_neutrality",
+        "recommendation_caveat",
+        "citation",
+        "trust_card_url",
+        "public_profile_url"
+      ],
+      "type": "object"
+    },
+    "error": {
+      "additionalProperties": {},
+      "properties": {
+        "code": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "details": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/__schema0"
+            }
+          ]
+        },
+        "message": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "status": {
+          "maximum": 599,
+          "minimum": 400,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "code",
+        "message"
+      ],
+      "type": "object"
+    },
+    "ok": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "contract_version",
+    "ok"
+  ],
+  "type": "object"
+}

First observedJul 7, 2026

TDQS

A4/5.0

Behavior4/5

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

Annotations already declare readOnlyHint/destructiveHint=false and a closed world, so the safety profile is covered; the description adds genuinely new context by declaring the disclosure boundary ('without exposing private weighting'), which sets expectations about what the explanation will and won't contain. It does not discuss error behavior for unpublished or unknown businesses.

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?

One sentence, front-loaded with the usage trigger followed by the return contract. Every clause carries information; nothing is redundant with the name or title.

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

Completeness4/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 return values need not be re-explained, and the description still summarizes them plus the privacy boundary. What remains unstated is the fallback when the id is invalid or the business is unpublished, though 'is or is not recommendable' partially covers the negative case.

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

Parameters3/5

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

Only one parameter, and the schema already documents it at 100% coverage as 'Loppee business id of a published Trust Card'. The description's 'known published business' reinforces the same constraint but adds no new semantic detail, so this sits at the baseline.

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

Purpose4/5

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

States a specific verb (explain), resource (recommendation) and scope (a known published business on Loppee), and enumerates what is returned (class, disclosure, basis, neutrality statement, citation). It implicitly separates itself from lookup/get_trust_card by requiring an already-known published business, but never names a sibling explicitly.

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?

'Use this when the user asks why a known published business is or is not recommendable' gives a clear triggering condition, and 'known published' implies the business must be resolved first. It stops short of naming an alternative or stating what to use when the business is unknown/unpublished.

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

All Loppee 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.