Merchant Context

Resolve sourced merchant facts and safe actions before an agent acts.

使うべきか

品質と安全性

A
説明の品質
94%
スキーマの完全性
82%
命名の品質
91%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(1)

  • LOWTool 'compare_offers' description lacks action verbcompare_offers 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~1,520トークン数(ツール定義)
~1.3 KB一般的なレスポンスサイズ
注意への影響は中程度(128k コンテキストの 1.19%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `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#"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 9 件
検証済みバージョンは記録されていませんツール 9 件
検証済みバージョンは記録されていませんツール 9 件