Merchant Context
Resolve sourced merchant facts and safe actions before an agent acts.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin compare_offers
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"merchant-context": {
"url": "https://api.merchant.atomandbits.com/mcp"
}
}
}Remote-Endpunkte
https://api.merchant.atomandbits.com/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (9)
🟢get_service_info
Describe the Merchant Context service, price, and inspection checks.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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#"
}Community
Nachweis