Servidor MCP

Merchant Context

io.github.ihint/merchant-context
Negocio y operaciones Comercio y retail Público y accesible MCP 2025-11-25

Qué hace este 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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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.
Solo lectura
Esquema de entrada
{'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.
Acceso externo
Esquema de entrada
{'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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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.
Acceso externo
Esquema de entrada
{'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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'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}$'}}}
Añadido
inspect_merchant
17 de September de 2026 a las 12:42
Añadido
refresh_merchant
17 de September de 2026 a las 12:42
Añadido
preflight
17 de September de 2026 a las 12:42
Añadido
get_safe_actions
17 de September de 2026 a las 12:42
Añadido
compare_offers
17 de September de 2026 a las 12:42
Añadido
search_merchants
17 de September de 2026 a las 12:42
Añadido
resolve_merchant
17 de September de 2026 a las 12:42
Añadido
check_merchant
17 de September de 2026 a las 12:42
Añadido
get_service_info
17 de September de 2026 a las 12:42