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개