Loppee MCP
An MCP server providing access to Loppee's US local business registry, enabling agents to discover verified and listed service businesses, retrieve Trust Cards, read reviews, and compare providers without requiring user authentication for read-only discovery.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://loppee.com/mcp/discoveryWhat its tools do
5 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to loppee.com ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Find local businesses by category and location
- Retrieve business Trust Cards and verification status
- Read and compare business reviews
- Explain business recommendations
Source and maintenance
Vendor evidenceRegistry 0.1.4
- Maintenance checked
Protocol and capabilities
- Server
- loppee-agent-api 0.1.4
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 5 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
5 advertised
lookup_business — Lookup Business
Advertised read-only
Use this when the user names a business and wants its Loppee Registry match. Returns exact and genuine-prefix name matches with stable ids, coarse public city/state, and truthful Verified, Listed, or Registry disclosure. It does not perform category discovery, accept or return caller location, or return a street address or ZIP.
lookup_business input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Business name to look up through the universal, pay-independent name lane."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum result count from 1 to 50."
},
"cursor": {
"type": "string",
"maxLength": 4096,
"minLength": 1,
"description": "Opaque cursor returned in next_cursor by the previous v3 search page. Omit for the first page."
},
"verified": {
"type": "boolean",
"description": "Return only Verified businesses on this bounded page. The response counts this page, not all matching businesses."
},
"worth_it_meter": {
"enum": [
"cheap",
"fair",
"expensive",
"cheap_or_fair"
],
"type": "string",
"description": "Only when the customer asks, for example \"fair-priced plumber\". Keeps rows customers rated this way, in their existing order, and drops unrated rows. It removes rows and never reorders them."
}
}
}lookup_business output schema
{
"type": "object",
"oneOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"ok",
"data"
],
"properties": {
"ok": {
"const": true
}
}
},
{
"not": {
"required": [
"data"
]
},
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"const": false
}
}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"contract_version",
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"has_more",
"returned_count",
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"display_name"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"type": "string"
},
"open_now": {
"anyOf": [
{
"type": "object",
"required": [
"status",
"is_open",
"label",
"detail",
"closes_at",
"opens_at",
"override_label",
"time_zone",
"local_time"
],
"properties": {
"label": {
"type": "string"
},
"detail": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
},
"is_open": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"opens_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"closes_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"time_zone": {
"type": "string"
},
"local_time": {
"type": "string"
},
"override_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"insurance": {
"type": "object",
"required": [
"status",
"carrier_name",
"stated_expires_at",
"disclosure"
],
"properties": {
"status": {
"type": "string"
},
"disclosure": {
"type": "string"
},
"carrier_name": {
"type": "string"
},
"stated_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"disclosure": {
"type": "string"
},
"listing_id": {
"type": "string"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"business_id": {
"type": "string"
},
"source_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_type": {
"type": "string"
},
"claim_status": {
"type": "string"
},
"display_name": {
"type": "string"
},
"subject_kind": {
"type": "string"
},
"review_summary": {
"type": "object",
"required": [
"average",
"count",
"last_review_at"
],
"properties": {
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"average": {
"anyOf": [
{
"type": "number",
"maximum": 5,
"minimum": 1
},
{
"type": "null"
}
]
},
"last_review_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"trust_card_url": {
"type": "string"
},
"worth_it_meter": {
"type": "object",
"required": [
"status",
"position",
"band",
"count",
"quote_match_rate",
"updated_at",
"ranking_effect"
],
"properties": {
"band": {
"anyOf": [
{
"enum": [
"cheap",
"fair",
"expensive"
],
"type": "string"
},
{
"type": "null"
}
]
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"available",
"insufficient_ratings"
],
"type": "string"
},
"position": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": -1
},
{
"type": "null"
}
]
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ranking_effect": {
"type": "string",
"const": "none"
},
"quote_match_rate": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"business_status": {
"enum": [
"Verified",
"Listed",
"Registry"
],
"type": "string"
},
"review_reputation": {
"type": "object",
"required": [
"display_rating",
"display_review_count",
"ranking"
],
"properties": {
"ranking": {
"type": "object",
"required": [
"status",
"basis",
"half_star_band"
],
"properties": {
"basis": {
"type": "string"
},
"status": {
"type": "string"
},
"half_star_band": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"reviews_url": {
"type": "string"
},
"display_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"quality_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"counts_truncated": {
"type": "boolean"
},
"display_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"latest_review_snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verified_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"identity_verified_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"loppee_attestation": {
"type": "object",
"required": [
"format",
"alg",
"kid",
"jwks_uri",
"issued_at",
"expires_at",
"jws"
],
"properties": {
"alg": {
"type": "string",
"const": "ES256"
},
"jws": {
"type": "string"
},
"kid": {
"type": "string"
},
"format": {
"type": "string",
"const": "jws-compact"
},
"jwks_uri": {
"type": "string"
},
"issued_at": {
"type": "string"
},
"expires_at": {
"type": "string"
}
},
"additionalProperties": false
},
"public_profile_url": {
"type": "string"
},
"verification_class": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
}
},
"additionalProperties": false
}
},
"has_more": {
"type": "boolean"
},
"page_limit": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"generated_at": {
"type": "string"
},
"display_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"registry_name": {
"type": "string"
},
"total_matches": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"returned_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"schema_version": {
"type": "string"
},
"verified_filter": {
"type": "object",
"required": [
"requested",
"verified_found",
"count_basis",
"explanation"
],
"properties": {
"requested": {
"type": "boolean",
"const": true
},
"count_basis": {
"type": "string",
"const": "returned_page"
},
"explanation": {
"type": "string"
},
"verified_found": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"total_matches_basis": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"registry_count_basis": {
"type": "string"
},
"presentation_guidance": {
"type": "string"
},
"total_registry_records": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"visible_candidate_records": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"candidate_window_truncated": {
"type": "boolean"
},
"registry_count_observed_at": {
"type": "string"
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"message": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"contract_version": {
"type": "string",
"const": "1.0"
}
},
"additionalProperties": false
}lookup_business annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_trust_card — Get Trust Card
Advertised read-only
Use this when a business is already identified and the user wants its public Loppee Trust Card. Returns the exact business status, disclosure, coarse public city/state, public facts, review context, and citation without account authority, street address, ZIP, or signed media links.
get_trust_card input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"domain_key": {
"type": "string",
"description": "Normalized domain key such as example-com."
},
"business_id": {
"type": "string",
"description": "Loppee business id."
}
}
}get_trust_card output schema
{
"type": "object",
"oneOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"ok",
"data"
],
"properties": {
"ok": {
"const": true
}
}
},
{
"not": {
"required": [
"data"
]
},
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"const": false
}
}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"contract_version",
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"anyOf": [
{
"type": "object",
"required": [
"business_id",
"display_name",
"category",
"services",
"reviews"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hours": {
"anyOf": [
{
"type": "object",
"required": [
"weekly",
"overrides"
],
"properties": {
"weekly": {
"type": "object",
"properties": {
"fri": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"mon": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"sat": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"sun": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"thu": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"tue": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"wed": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"overrides": {
"type": "array",
"items": {
"type": "object",
"required": [
"status",
"ranges",
"date",
"label"
],
"properties": {
"date": {
"type": "string"
},
"label": {
"type": "string"
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"rating",
"title",
"body",
"reviewer_name",
"relationship",
"service_date",
"created_at",
"authoring_mode",
"agent_assisted",
"owner_response"
],
"properties": {
"id": {
"type": "string"
},
"body": {
"type": "string"
},
"title": {
"type": "string"
},
"rating": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"created_at": {
"type": "string"
},
"relationship": {
"type": "string"
},
"service_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reviewer_name": {
"type": "string"
},
"agent_assisted": {
"type": "boolean"
},
"authoring_mode": {
"type": "string"
},
"owner_response": {
"anyOf": [
{
"type": "object",
"required": [
"body",
"author_label",
"created_at"
],
"properties": {
"body": {
"type": "string"
},
"created_at": {
"type": "string"
},
"author_label": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"verification_label": {
"type": "string"
},
"reviewer_verification_label": {
"type": "string"
},
"reviewer_verification_disclosure": {
"type": "string"
}
},
"additionalProperties": false
}
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"type": "array",
"items": {
"type": "string"
}
},
"citation": {
"type": "object",
"required": [
"registry",
"url"
],
"properties": {
"url": {
"type": "string"
},
"registry": {
"type": "string"
}
},
"additionalProperties": false
},
"services": {
"type": "array",
"items": {
"type": "string"
}
},
"insurance": {
"type": "object",
"required": [
"status",
"carrier_name",
"stated_expires_at",
"disclosure"
],
"properties": {
"status": {
"type": "string"
},
"disclosure": {
"type": "string"
},
"carrier_name": {
"type": "string"
},
"stated_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"disclosure": {
"type": "string"
},
"legal_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"updated_at": {
"type": "string"
},
"business_id": {
"type": "string"
},
"source_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_type": {
"type": "string"
},
"claim_status": {
"type": "string"
},
"display_name": {
"type": "string"
},
"subject_kind": {
"type": "string"
},
"registry_name": {
"type": "string"
},
"service_areas": {
"type": "array",
"items": {
"type": "string"
}
},
"review_summary": {
"type": "object",
"required": [
"average",
"count",
"last_review_at"
],
"properties": {
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"average": {
"anyOf": [
{
"type": "number",
"maximum": 5,
"minimum": 1
},
{
"type": "null"
}
]
},
"last_review_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"schema_version": {
"type": "string"
},
"trust_card_url": {
"type": "string"
},
"worth_it_meter": {
"type": "object",
"required": [
"status",
"position",
"band",
"count",
"quote_match_rate",
"updated_at",
"ranking_effect"
],
"properties": {
"band": {
"anyOf": [
{
"enum": [
"cheap",
"fair",
"expensive"
],
"type": "string"
},
{
"type": "null"
}
]
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"available",
"insufficient_ratings"
],
"type": "string"
},
"position": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": -1
},
{
"type": "null"
}
]
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ranking_effect": {
"type": "string",
"const": "none"
},
"quote_match_rate": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"business_status": {
"enum": [
"Verified",
"Listed",
"Registry"
],
"type": "string"
},
"primary_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_completeness": {
"type": "object",
"required": [
"fields",
"missing_fields",
"note"
],
"properties": {
"note": {
"type": "string"
},
"fields": {
"type": "object",
"required": [
"hours",
"services",
"service_areas",
"phone",
"website",
"reviews"
],
"properties": {
"hours": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
},
"phone": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
},
"reviews": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
},
"website": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
},
"services": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
},
"service_areas": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
}
},
"additionalProperties": false
},
"missing_fields": {
"type": "array",
"items": {
"enum": [
"hours",
"services",
"service_areas",
"phone",
"website",
"reviews"
],
"type": "string"
}
}
},
"additionalProperties": false
},
"review_reputation": {
"type": "object",
"required": [
"display_rating",
"display_review_count",
"ranking"
],
"properties": {
"ranking": {
"type": "object",
"required": [
"status",
"basis",
"half_star_band"
],
"properties": {
"basis": {
"type": "string"
},
"status": {
"type": "string"
},
"half_star_band": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"reviews_url": {
"type": "string"
},
"display_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"quality_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"counts_truncated": {
"type": "boolean"
},
"display_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"latest_review_snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verified_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"identity_verified_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"loppee_attestation": {
"type": "object",
"required": [
"format",
"alg",
"kid",
"jwks_uri",
"issued_at",
"expires_at",
"jws"
],
"properties": {
"alg": {
"type": "string",
"const": "ES256"
},
"jws": {
"type": "string"
},
"kid": {
"type": "string"
},
"format": {
"type": "string",
"const": "jws-compact"
},
"jwks_uri": {
"type": "string"
},
"issued_at": {
"type": "string"
},
"expires_at": {
"type": "string"
}
},
"additionalProperties": false
},
"public_profile_url": {
"type": "string"
},
"verification_class": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
},
"verification_valid_until": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"business_id",
"domain",
"trust_card"
],
"properties": {
"domain": {
"type": "string"
},
"trust_card": {
"type": "object",
"required": [
"business_id",
"display_name",
"category",
"services",
"reviews"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hours": {
"anyOf": [
{
"type": "object",
"required": [
"weekly",
"overrides"
],
"properties": {
"weekly": {
"type": "object",
"properties": {
"fri": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"mon": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"sat": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"sun": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"thu": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"tue": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
},
"wed": {
"type": "object",
"required": [
"status",
"ranges"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"overrides": {
"type": "array",
"items": {
"type": "object",
"required": [
"status",
"ranges",
"date",
"label"
],
"properties": {
"date": {
"type": "string"
},
"label": {
"type": "string"
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"open",
"close"
],
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"open",
"closed",
"open_24",
"appointment"
],
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"rating",
"title",
"body",
"reviewer_name",
"relationship",
"service_date",
"created_at",
"authoring_mode",
"agent_assisted",
"owner_response"
],
"properties": {
"id": {
"type": "string"
},
"body": {
"type": "string"
},
"title": {
"type": "string"
},
"rating": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"created_at": {
"type": "string"
},
"relationship": {
"type": "string"
},
"service_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reviewer_name": {
"type": "string"
},
"agent_assisted": {
"type": "boolean"
},
"authoring_mode": {
"type": "string"
},
"owner_response": {
"anyOf": [
{
"type": "object",
"required": [
"body",
"author_label",
"created_at"
],
"properties": {
"body": {
"type": "string"
},
"created_at": {
"type": "string"
},
"author_label": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"verification_label": {
"type": "string"
},
"reviewer_verification_label": {
"type": "string"
},
"reviewer_verification_disclosure": {
"type": "string"
}
},
"additionalProperties": false
}
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"type": "array",
"items": {
"type": "string"
}
},
"citation": {
"type": "object",
"required": [
"registry",
"url"
],
"properties": {
"url": {
"type": "string"
},
"registry": {
"type": "string"
}
},
"additionalProperties": false
},
"services": {
"type": "array",
"items": {
"type": "string"
}
},
"insurance": {
"type": "object",
"required": [
"status",
"carrier_name",
"stated_expires_at",
"disclosure"
],
"properties": {
"status": {
"type": "string"
},
"disclosure": {
"type": "string"
},
"carrier_name": {
"type": "string"
},
"stated_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"disclosure": {
"type": "string"
},
"legal_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"updated_at": {
"type": "string"
},
"business_id": {
"type": "string"
},
"source_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_type": {
"type": "string"
},
"claim_status": {
"type": "string"
},
"display_name": {
"type": "string"
},
"subject_kind": {
"type": "string"
},
"registry_name": {
"type": "string"
},
"service_areas": {
"type": "array",
"items": {
"type": "string"
}
},
"review_summary": {
"type": "object",
"required": [
"average",
"count",
"last_review_at"
],
"properties": {
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"average": {
"anyOf": [
{
"type": "number",
"maximum": 5,
"minimum": 1
},
{
"type": "null"
}
]
},
"last_review_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"schema_version": {
"type": "string"
},
"trust_card_url": {
"type": "string"
},
"worth_it_meter": {
"type": "object",
"required": [
"status",
"position",
"band",
"count",
"quote_match_rate",
"updated_at",
"ranking_effect"
],
"properties": {
"band": {
"anyOf": [
{
"enum": [
"cheap",
"fair",
"expensive"
],
"type": "string"
},
{
"type": "null"
}
]
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"available",
"insufficient_ratings"
],
"type": "string"
},
"position": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": -1
},
{
"type": "null"
}
]
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ranking_effect": {
"type": "string",
"const": "none"
},
"quote_match_rate": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"business_status": {
"enum": [
"Verified",
"Listed",
"Registry"
],
"type": "string"
},
"primary_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_completeness": {
"type": "object",
"required": [
"fields",
"missing_fields",
"note"
],
"properties": {
"note": {
"type": "string"
},
"fields": {
"type": "object",
"required": [
"hours",
"services",
"service_areas",
"phone",
"website",
"reviews"
],
"properties": {
"hours": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
},
"phone": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
},
"reviews": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
},
"website": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
},
"services": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
},
"service_areas": {
"enum": [
"available",
"not_provided",
"none_published"
],
"type": "string"
}
},
"additionalProperties": false
},
"missing_fields": {
"type": "array",
"items": {
"enum": [
"hours",
"services",
"service_areas",
"phone",
"website",
"reviews"
],
"type": "string"
}
}
},
"additionalProperties": false
},
"review_reputation": {
"type": "object",
"required": [
"display_rating",
"display_review_count",
"ranking"
],
"properties": {
"ranking": {
"type": "object",
"required": [
"status",
"basis",
"half_star_band"
],
"properties": {
"basis": {
"type": "string"
},
"status": {
"type": "string"
},
"half_star_band": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"reviews_url": {
"type": "string"
},
"display_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"quality_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"counts_truncated": {
"type": "boolean"
},
"display_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"latest_review_snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verified_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"identity_verified_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"loppee_attestation": {
"type": "object",
"required": [
"format",
"alg",
"kid",
"jwks_uri",
"issued_at",
"expires_at",
"jws"
],
"properties": {
"alg": {
"type": "string",
"const": "ES256"
},
"jws": {
"type": "string"
},
"kid": {
"type": "string"
},
"format": {
"type": "string",
"const": "jws-compact"
},
"jwks_uri": {
"type": "string"
},
"issued_at": {
"type": "string"
},
"expires_at": {
"type": "string"
}
},
"additionalProperties": false
},
"public_profile_url": {
"type": "string"
},
"verification_class": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
},
"verification_valid_until": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"business_id": {
"type": "string"
},
"schema_version": {
"type": "string"
},
"trust_card_url": {
"type": "string"
},
"business_status": {
"enum": [
"Verified",
"Listed",
"Registry"
],
"type": "string"
},
"loppee_attestation": {
"type": "object",
"required": [
"format",
"alg",
"kid",
"jwks_uri",
"issued_at",
"expires_at",
"jws"
],
"properties": {
"alg": {
"type": "string",
"const": "ES256"
},
"jws": {
"type": "string"
},
"kid": {
"type": "string"
},
"format": {
"type": "string",
"const": "jws-compact"
},
"jwks_uri": {
"type": "string"
},
"issued_at": {
"type": "string"
},
"expires_at": {
"type": "string"
}
},
"additionalProperties": false
},
"verification_class": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"message": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"contract_version": {
"type": "string",
"const": "1.0"
}
},
"additionalProperties": false
}get_trust_card annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_business_reviews — Get Business Reviews (paginated)
Advertised read-only
Use this when the user wants the public customer reviews for one Loppee business id. Supports pagination and star-rating filters, preserves reviewer and interaction labels, masks reviewer identity, and changes nothing.
get_business_reviews input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"business_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number (default 1)."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Reviews per page (default 5, max 50)."
},
"ratings": {
"type": "array",
"items": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"description": "Star-rating filter: return only reviews with these ratings, e.g. [1] or [4,5]. Omit for all ratings."
},
"business_id": {
"type": "string",
"minLength": 1,
"description": "Loppee business id of a published business."
}
}
}get_business_reviews output schema
{
"type": "object",
"oneOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"ok",
"data"
],
"properties": {
"ok": {
"const": true
}
}
},
{
"not": {
"required": [
"data"
]
},
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"const": false
}
}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"contract_version",
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"business_id",
"display_name",
"sort",
"filter",
"summary",
"reviews",
"pagination"
],
"properties": {
"sort": {
"type": "string"
},
"filter": {
"type": "object",
"required": [
"ratings"
],
"properties": {
"ratings": {
"anyOf": [
{
"type": "array",
"items": {
"type": "integer",
"maximum": 5,
"minimum": 1
}
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"rating",
"title",
"body",
"reviewer_name",
"relationship",
"service_date",
"created_at",
"authoring_mode",
"agent_assisted",
"owner_response"
],
"properties": {
"id": {
"type": "string"
},
"body": {
"type": "string"
},
"title": {
"type": "string"
},
"rating": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"created_at": {
"type": "string"
},
"relationship": {
"type": "string"
},
"service_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reviewer_name": {
"type": "string"
},
"agent_assisted": {
"type": "boolean"
},
"authoring_mode": {
"type": "string"
},
"owner_response": {
"anyOf": [
{
"type": "object",
"required": [
"body",
"author_label",
"created_at"
],
"properties": {
"body": {
"type": "string"
},
"created_at": {
"type": "string"
},
"author_label": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"verification_label": {
"type": "string"
},
"reviewer_verification_label": {
"type": "string"
},
"reviewer_verification_disclosure": {
"type": "string"
}
},
"additionalProperties": false
}
},
"summary": {
"type": "object",
"required": [
"average_rating",
"review_count",
"rating_counts",
"ranking"
],
"properties": {
"ranking": {
"type": "object",
"required": [
"status",
"basis",
"half_star_band"
],
"properties": {
"basis": {
"type": "string"
},
"status": {
"type": "string"
},
"half_star_band": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"rating_counts": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"average_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"quality_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"counts_truncated": {
"type": "boolean"
},
"verified_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"identity_verified_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"pagination": {
"type": "object",
"required": [
"page",
"limit",
"total_count",
"total_pages",
"has_more",
"next_page"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"has_more": {
"type": "boolean"
},
"next_page": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"total_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"total_pages": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"business_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"registry_name": {
"type": "string"
},
"schema_version": {
"type": "string"
},
"business_status": {
"enum": [
"Verified",
"Listed",
"Registry"
],
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"registry_page_notice": {
"type": "string"
},
"business_claim_status": {
"type": "string"
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"message": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"contract_version": {
"type": "string",
"const": "1.0"
}
},
"additionalProperties": false
}get_business_reviews annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}explain_recommendation — Explain Recommendation
Advertised 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.
explain_recommendation input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"business_id"
],
"properties": {
"business_id": {
"type": "string",
"minLength": 1,
"description": "Loppee business id of a published Trust Card."
}
}
}explain_recommendation output schema
{
"type": "object",
"oneOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"ok",
"data"
],
"properties": {
"ok": {
"const": true
}
}
},
{
"not": {
"required": [
"data"
]
},
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"const": false
}
}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"contract_version",
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"endpoint",
"business_id",
"display_name",
"verification_class",
"verification_disclosure",
"decision",
"basis",
"recommendation_order",
"commercial_influence",
"citation",
"trust_card_url",
"public_profile_url"
],
"properties": {
"basis": {
"type": "string"
},
"citation": {
"type": "object",
"required": [
"registry",
"url"
],
"properties": {
"url": {
"type": "string"
},
"registry": {
"type": "string"
}
},
"additionalProperties": false
},
"decision": {
"type": "string"
},
"endpoint": {
"type": "string",
"const": "explain_recommendation"
},
"business_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"registry_name": {
"type": "string"
},
"schema_version": {
"type": "string"
},
"trust_card_url": {
"type": "string"
},
"business_status": {
"enum": [
"Verified",
"Listed",
"Registry"
],
"type": "string"
},
"loppee_attestation": {
"type": "object",
"required": [
"format",
"alg",
"kid",
"jwks_uri",
"issued_at",
"expires_at",
"jws"
],
"properties": {
"alg": {
"type": "string",
"const": "ES256"
},
"jws": {
"type": "string"
},
"kid": {
"type": "string"
},
"format": {
"type": "string",
"const": "jws-compact"
},
"jwks_uri": {
"type": "string"
},
"issued_at": {
"type": "string"
},
"expires_at": {
"type": "string"
}
},
"additionalProperties": false
},
"public_profile_url": {
"type": "string"
},
"verification_class": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"commercial_influence": {
"type": "string",
"const": "none"
},
"recommendation_order": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"message": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"contract_version": {
"type": "string",
"const": "1.0"
}
},
"additionalProperties": false
}explain_recommendation annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}compare_businesses — Compare Businesses
Advertised read-only
Use this when the user wants a side-by-side comparison of two to twenty known published Loppee business ids. Returns each business's exact class, disclosure, review context, and citation; unknown or unavailable ids are listed as unresolved rather than fabricated.
compare_businesses input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"business_ids"
],
"properties": {
"business_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 20,
"minItems": 2,
"description": "Two to twenty Loppee business ids to compare. Duplicates are de-duplicated."
}
}
}compare_businesses output schema
{
"type": "object",
"oneOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"ok",
"data"
],
"properties": {
"ok": {
"const": true
}
}
},
{
"not": {
"required": [
"data"
]
},
"required": [
"ok",
"error"
],
"properties": {
"ok": {
"const": false
}
}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"contract_version",
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"endpoint",
"ordering",
"comparison_neutrality",
"requested_count",
"compared_count",
"comparisons",
"unresolved_business_ids"
],
"properties": {
"endpoint": {
"type": "string",
"const": "compare_businesses"
},
"ordering": {
"type": "string"
},
"comparisons": {
"type": "array",
"items": {
"type": "object",
"required": [
"business_id",
"display_name",
"category",
"verification_class",
"verification_disclosure",
"trust_card_url",
"public_profile_url"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"type": "string"
},
"insurance": {
"type": "object",
"required": [
"status",
"carrier_name",
"stated_expires_at",
"disclosure"
],
"properties": {
"status": {
"type": "string"
},
"disclosure": {
"type": "string"
},
"carrier_name": {
"type": "string"
},
"stated_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"business_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"review_summary": {
"type": "object",
"required": [
"average",
"count",
"last_review_at"
],
"properties": {
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"average": {
"anyOf": [
{
"type": "number",
"maximum": 5,
"minimum": 1
},
{
"type": "null"
}
]
},
"last_review_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"trust_card_url": {
"type": "string"
},
"worth_it_meter": {
"type": "object",
"required": [
"status",
"position",
"band",
"count",
"quote_match_rate",
"updated_at",
"ranking_effect"
],
"properties": {
"band": {
"anyOf": [
{
"enum": [
"cheap",
"fair",
"expensive"
],
"type": "string"
},
{
"type": "null"
}
]
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"available",
"insufficient_ratings"
],
"type": "string"
},
"position": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": -1
},
{
"type": "null"
}
]
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ranking_effect": {
"type": "string",
"const": "none"
},
"quote_match_rate": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"business_status": {
"enum": [
"Verified",
"Listed",
"Registry"
],
"type": "string"
},
"review_reputation": {
"type": "object",
"required": [
"display_rating",
"display_review_count",
"ranking"
],
"properties": {
"ranking": {
"type": "object",
"required": [
"status",
"basis",
"half_star_band"
],
"properties": {
"basis": {
"type": "string"
},
"status": {
"type": "string"
},
"half_star_band": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"reviews_url": {
"type": "string"
},
"display_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"quality_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"counts_truncated": {
"type": "boolean"
},
"display_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"latest_review_snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verified_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"identity_verified_review_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"loppee_attestation": {
"type": "object",
"required": [
"format",
"alg",
"kid",
"jwks_uri",
"issued_at",
"expires_at",
"jws"
],
"properties": {
"alg": {
"type": "string",
"const": "ES256"
},
"jws": {
"type": "string"
},
"kid": {
"type": "string"
},
"format": {
"type": "string",
"const": "jws-compact"
},
"jwks_uri": {
"type": "string"
},
"issued_at": {
"type": "string"
},
"expires_at": {
"type": "string"
}
},
"additionalProperties": false
},
"public_profile_url": {
"type": "string"
},
"verification_class": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
}
},
"additionalProperties": false
}
},
"compared_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"schema_version": {
"type": "string"
},
"requested_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"trust_model_version": {
"type": "string"
},
"comparison_neutrality": {
"type": "string",
"const": "Comparison order is neutral and based only on public business trust and review facts."
},
"unresolved_business_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"message": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"contract_version": {
"type": "string",
"const": "1.0"
}
},
"additionalProperties": false
}compare_businesses annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 805 ms
- 95th percentile latency
- 805 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 805 ms · metadata changed · 5 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http loppee-mcp https://loppee.com/mcp/discoveryCodex
Codex configuration
codex mcp add loppee-mcp --url https://loppee.com/mcp/discoveryCursor
Cursor configuration
{
"mcpServers": {
"loppee-mcp": {
"url": "https://loppee.com/mcp/discovery"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"loppee-mcp": {
"type": "streamableHttp",
"url": "https://loppee.com/mcp/discovery",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"loppee-mcp": {
"type": "http",
"url": "https://loppee.com/mcp/discovery"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http loppee-mcp https://loppee.com/mcp/discoveryClaude Desktop
Claude Desktop configuration
https://loppee.com/mcp/discoveryWindsurf
Windsurf configuration
{
"mcpServers": {
"loppee-mcp": {
"serverUrl": "https://loppee.com/mcp/discovery"
}
}
}Let your agent find its tools
Find servers like Loppee MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run Loppee MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.