MCP Server
Merchant Context
io.github.ihint/merchant-context
What this MCP does
Resolves sourced merchant facts, offers, terms, freshness, and safe action URLs for commerce-related agent workflows.
Capabilities
Tools
9
tools
check_merchant
Run a free merchant-site diagnostic. Agents should use resolve_merchant before relying on merchant facts or actions.
Read only
Open world
Idempotent
Input schema
{'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.
Read only
Open world
Idempotent
Input schema
{'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.
Read only
Open world
Idempotent
Input schema
{'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.
Read only
Input schema
{'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.
Open world
Input schema
{'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.
Read only
Open world
Idempotent
Input schema
{'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.
Open world
Input schema
{'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.
Read only
Open world
Idempotent
Input schema
{'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.
Read only
Open world
Idempotent
Input schema
{'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}$'}}}
History
Recent tool changes
Added
inspect_merchant
Sept. 17, 2026, 12:42 p.m.
Added
refresh_merchant
Sept. 17, 2026, 12:42 p.m.
Added
preflight
Sept. 17, 2026, 12:42 p.m.
Added
get_safe_actions
Sept. 17, 2026, 12:42 p.m.
Added
compare_offers
Sept. 17, 2026, 12:42 p.m.
Added
search_merchants
Sept. 17, 2026, 12:42 p.m.
Added
resolve_merchant
Sept. 17, 2026, 12:42 p.m.
Added
check_merchant
Sept. 17, 2026, 12:42 p.m.
Added
get_service_info
Sept. 17, 2026, 12:42 p.m.
Discover
Similar MCP servers
AgentLot Marketplace
io.agentlot/marketplace
Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.
zobrx
com.zobrx/zobrx
Provides read-only ecommerce operations and analytics for orders, inventory, marketplace performance, advertising, settlements, t…
SupplySlate
com.supplyslate/sourcing
Supports component sourcing, fabrication requests, supplier RFQs, catalog imports, quotes, purchase planning, checkout handoffs, …
Obriym CRM
com.obriym-crm/mcp
Manages CRM records, sales pipelines, activities, orders, products, inventory, and marketplace catalog operations.
velora
com.somosvelora/velora
Provides Argentine commerce operations including catalog and inventory, customer and supplier management, cash register tracking,…
Shopify
io.github.pipeworx-io/shopify
Provides read access to Shopify Admin data for store operations through the Shopify REST API.
Woocommerce
io.github.pipeworx-io/woocommerce
Provides access to WooCommerce store data through the WooCommerce REST API.
Troostwijk
io.github.pipeworx-io/troostwijk
Searches European industrial and insolvency liquidation auctions and retrieves auction lot details.