Merchant Context
Resolve sourced merchant facts and safe actions before an agent acts.
使うべきか
品質と安全性
検出事項(1)
- LOWcompare_offers 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"merchant-context": {
"url": "https://api.merchant.atomandbits.com/mcp"
}
}
}リモートエンドポイント
https://api.merchant.atomandbits.com/mcpstreamable-httpできること
ツール一覧
ツール(9)
🟢get_service_info
Describe the Merchant Context service, price, and inspection checks.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢check_merchant(merchant_url)
Run a free merchant-site diagnostic. Agents should use resolve_merchant before relying on merchant facts or actions.
入力スキーマ
{
"type": "object",
"properties": {
"merchant_url": {
"type": "string",
"format": "uri",
"description": "Public HTTPS merchant URL to check"
}
},
"required": [
"merchant_url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢resolve_merchant(merchant_url, client_id)
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",
"properties": {
"merchant_url": {
"type": "string",
"format": "uri",
"description": "Public HTTPS merchant URL"
},
"client_id": {
"description": "Stable, non-secret identifier for the calling client",
"type": "string",
"minLength": 3,
"maxLength": 128
}
},
"required": [
"merchant_url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_merchants(item_or_service, geography, maximum_price_amount, maximum_price_currency, timing, ...)
Search cached merchant records by sourced offer, place, price, timing, policy, action support, and freshness. Payment and adoption never change order.
入力スキーマ
{
"type": "object",
"properties": {
"item_or_service": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"geography": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"maximum_price_amount": {
"type": "number",
"minimum": 0
},
"maximum_price_currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"timing": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"policy": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"action_type": {
"type": "string",
"enum": [
"learn_more",
"contact",
"request_quote",
"book",
"checkout"
]
},
"freshness": {
"type": "string",
"enum": [
"fresh",
"stale",
"unknown",
"any"
]
},
"max_stale_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"client_id": {
"description": "Stable, non-secret identifier for the calling client",
"type": "string",
"minLength": 3,
"maxLength": 128
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢compare_offers(merchant_urls, client_id)
Compare only sourced offer fields from two or more merchants. Unknown values stay unknown and payment never changes order.
入力スキーマ
{
"type": "object",
"properties": {
"merchant_urls": {
"minItems": 2,
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"client_id": {
"type": "string",
"minLength": 3,
"maxLength": 128
}
},
"required": [
"merchant_urls"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_safe_actions(merchant_url, client_id, action_type, allowed_authority, human_confirmation_available)
Return current merchant-owned action URLs, exact inputs, authority, confirmation, expiry, retry rules, recovery, and attribution.
入力スキーマ
{
"type": "object",
"properties": {
"merchant_url": {
"type": "string",
"format": "uri"
},
"client_id": {
"type": "string",
"minLength": 3,
"maxLength": 128
},
"action_type": {
"type": "string",
"enum": [
"learn_more",
"contact",
"request_quote",
"book",
"checkout"
]
},
"allowed_authority": {
"type": "array",
"items": {
"type": "string",
"enum": [
"navigate",
"prepare",
"submit"
]
}
},
"human_confirmation_available": {
"type": "boolean"
}
},
"required": [
"merchant_url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢preflight(merchant_url, client_id, item_or_service, action_type, geography, ...)
Resolve one merchant, evaluate sourced intent constraints, select a safe action, state approval, and return attribution.
入力スキーマ
{
"type": "object",
"properties": {
"merchant_url": {
"type": "string",
"format": "uri"
},
"client_id": {
"type": "string",
"minLength": 3,
"maxLength": 128
},
"item_or_service": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"action_type": {
"type": "string",
"enum": [
"learn_more",
"contact",
"request_quote",
"book",
"checkout"
]
},
"geography": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"maximum_price_amount": {
"type": "number",
"minimum": 0
},
"maximum_price_currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"timing": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"max_stale_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"allowed_authority": {
"type": "array",
"items": {
"type": "string",
"enum": [
"navigate",
"prepare",
"submit"
]
}
},
"human_confirmation_available": {
"type": "boolean"
}
},
"required": [
"merchant_url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢refresh_merchant(merchant_url, agent_id, approved)
Pay for a fresh merchant inspection and cache refresh. Show the price and get explicit human approval first.
入力スキーマ
{
"type": "object",
"properties": {
"merchant_url": {
"type": "string",
"format": "uri",
"description": "Public HTTPS merchant URL"
},
"agent_id": {
"type": "string",
"minLength": 3,
"maxLength": 128,
"description": "Stable, non-secret identifier for the calling agent"
},
"approved": {
"type": "boolean",
"const": true,
"description": "Explicit human approval for this priced refresh"
}
},
"required": [
"merchant_url",
"agent_id",
"approved"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢inspect_merchant(merchant_url, agent_id, approved)
Compatibility alias for refresh_merchant. Show the price and get explicit human approval first.
入力スキーマ
{
"type": "object",
"properties": {
"merchant_url": {
"type": "string",
"format": "uri",
"description": "Public HTTPS merchant URL"
},
"agent_id": {
"type": "string",
"minLength": 3,
"maxLength": 128,
"description": "Stable, non-secret identifier for the calling agent"
},
"approved": {
"type": "boolean",
"const": true,
"description": "Explicit human approval for this priced refresh"
}
},
"required": [
"merchant_url",
"agent_id",
"approved"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}コミュニティ
エビデンス