MCP-Server

Merchant Context

io.github.ihint/merchant-context
Business & Betrieb Commerce & Retail Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'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.
Nur Lesen
Eingabeschema
{'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.
Externer Zugriff
Eingabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'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.
Externer Zugriff
Eingabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'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}$'}}}
Hinzugefügt
inspect_merchant
17. September 2026 12:42
Hinzugefügt
refresh_merchant
17. September 2026 12:42
Hinzugefügt
preflight
17. September 2026 12:42
Hinzugefügt
get_safe_actions
17. September 2026 12:42
Hinzugefügt
compare_offers
17. September 2026 12:42
Hinzugefügt
search_merchants
17. September 2026 12:42
Hinzugefügt
resolve_merchant
17. September 2026 12:42
Hinzugefügt
check_merchant
17. September 2026 12:42
Hinzugefügt
get_service_info
17. September 2026 12:42