Serveur MCP

Merchant Context

io.github.ihint/merchant-context
Entreprise et opérations Commerce et retail Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Resolves sourced merchant facts, offers, terms, freshness, and safe action URLs for commerce-related agent workflows.

check_merchant
Run a free merchant-site diagnostic. Agents should use resolve_merchant before relying on merchant facts or actions.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchant_url'], 'properties': {'merchant_url': {'type': 'string', 'format': 'uri', 'description': 'Public HTTPS merchant URL to check'}}}
compare_offers
Compare only sourced offer fields from two or more merchants. Unknown values stay unknown and payment never changes order.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchant_urls'], 'properties': {'client_id': {'type': 'string', 'maxLength': 128, 'minLength': 3}, 'merchant_urls': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}, 'maxItems': 20, 'minItems': 2}}}
get_safe_actions
Return current merchant-owned action URLs, exact inputs, authority, confirmation, expiry, retry rules, recovery, and attribution.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchant_url'], 'properties': {'client_id': {'type': 'string', 'maxLength': 128, 'minLength': 3}, 'action_type': {'enum': ['learn_more', 'contact', 'request_quote', 'book', 'checkout'], 'type': 'string'}, 'merchant_url': {'type': 'string', 'format': 'uri'}, 'allowed_authority': {'type': 'array', 'items': {'enum': ['navigate', 'prepare', 'submit'], 'type': 'string'}}, 'human_confirmation_available': {'type': 'boolean'}}}
get_service_info
Describe the Merchant Context service, price, and inspection checks.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
inspect_merchant
Compatibility alias for refresh_merchant. Show the price and get explicit human approval first.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchant_url', 'agent_id', 'approved'], 'properties': {'agent_id': {'type': 'string', 'maxLength': 128, 'minLength': 3, 'description': 'Stable, non-secret identifier for the calling agent'}, 'approved': {'type': 'boolean', 'const': True, 'description': 'Explicit human approval for this priced refresh'}, 'merchant_url': {'type': 'string', 'format': 'uri', 'description': 'Public HTTPS merchant URL'}}}
preflight
Resolve one merchant, evaluate sourced intent constraints, select a safe action, state approval, and return attribution.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchant_url'], 'properties': {'timing': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'client_id': {'type': 'string', 'maxLength': 128, 'minLength': 3}, 'geography': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'action_type': {'enum': ['learn_more', 'contact', 'request_quote', 'book', 'checkout'], 'type': 'string'}, 'merchant_url': {'type': 'string', 'format': 'uri'}, 'item_or_service': {'type': 'string', 'maxLength': 256, 'minLength': 1}, 'allowed_authority': {'type': 'array', 'items': {'enum': ['navigate', 'prepare', 'submit'], 'type': 'string'}}, 'max_stale_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'maximum_price_amount': {'type': 'number', 'minimum': 0}, 'maximum_price_currency': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'human_confirmation_available': {'type': 'boolean'}}}
refresh_merchant
Pay for a fresh merchant inspection and cache refresh. Show the price and get explicit human approval first.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchant_url', 'agent_id', 'approved'], 'properties': {'agent_id': {'type': 'string', 'maxLength': 128, 'minLength': 3, 'description': 'Stable, non-secret identifier for the calling agent'}, 'approved': {'type': 'boolean', 'const': True, 'description': 'Explicit human approval for this priced refresh'}, 'merchant_url': {'type': 'string', 'format': 'uri', 'description': 'Public HTTPS merchant URL'}}}
resolve_merchant
Resolve cached merchant identity, sourced facts, offers, terms, freshness, and safe actions for free. Call this before relying on merchant facts or starting an action.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchant_url'], 'properties': {'client_id': {'type': 'string', 'maxLength': 128, 'minLength': 3, 'description': 'Stable, non-secret identifier for the calling client'}, 'merchant_url': {'type': 'string', 'format': 'uri', 'description': 'Public HTTPS merchant URL'}}}
search_merchants
Search cached merchant records by sourced offer, place, price, timing, policy, action support, and freshness. Payment and adoption never change order.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'policy': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'timing': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'client_id': {'type': 'string', 'maxLength': 128, 'minLength': 3, 'description': 'Stable, non-secret identifier for the calling client'}, 'freshness': {'enum': ['fresh', 'stale', 'unknown', 'any'], 'type': 'string'}, 'geography': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'action_type': {'enum': ['learn_more', 'contact', 'request_quote', 'book', 'checkout'], 'type': 'string'}, 'item_or_service': {'type': 'string', 'maxLength': 256, 'minLength': 1}, 'max_stale_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'maximum_price_amount': {'type': 'number', 'minimum': 0}, 'maximum_price_currency': {'type': 'string', 'pattern': '^[A-Z]{3}$'}}}
Ajouté
inspect_merchant
17 September 2026 12:42
Ajouté
refresh_merchant
17 September 2026 12:42
Ajouté
preflight
17 September 2026 12:42
Ajouté
get_safe_actions
17 September 2026 12:42
Ajouté
compare_offers
17 September 2026 12:42
Ajouté
search_merchants
17 September 2026 12:42
Ajouté
resolve_merchant
17 September 2026 12:42
Ajouté
check_merchant
17 September 2026 12:42
Ajouté
get_service_info
17 September 2026 12:42