MCPサーバー

Merchant Context

io.github.ihint/merchant-context
ビジネス・業務 コマース・小売 公開・接続可能 MCP 2025-11-25

この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.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'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.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'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.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'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.
読み取り専用
入力スキーマ
{'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.
外部アクセスあり
入力スキーマ
{'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.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'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.
外部アクセスあり
入力スキーマ
{'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.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'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.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'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}$'}}}
追加
inspect_merchant
2026年9月17日12:42
追加
refresh_merchant
2026年9月17日12:42
追加
preflight
2026年9月17日12:42
追加
get_safe_actions
2026年9月17日12:42
追加
compare_offers
2026年9月17日12:42
追加
search_merchants
2026年9月17日12:42
追加
resolve_merchant
2026年9月17日12:42
追加
check_merchant
2026年9月17日12:42
追加
get_service_info
2026年9月17日12:42