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 verb在 compare_offers 中

根據工具定義與協定合規性的自動化分析。

上下文成本

~1,520Token(工具定義)
~1.3 KB典型回應大小
中等的注意力影響(128k 上下文的 1.19%)

這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。

安裝

一鍵安裝

將以下內容加入你的 `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 個工具