Merchant Context

Working · 3.4 s

io.github.ihint/merchant-contextv0.3.0

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

Commerce

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://api.merchant.atomandbits.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

check_merchant

Run a free merchant-site diagnostic. Agents should use resolve_merchant before relying on merchant facts or actions.

merchant_urlstring, required

Public HTTPS merchant URL to check

Tools (9)

check_merchant

Run a free merchant-site diagnostic. Agents should use resolve_merchant before relying on merchant facts or actions.

read-only

Argument	Type	Description
merchant_url*	string	Public HTTPS merchant URL to check

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_url"
  ],
  "properties": {
    "merchant_url": {
      "type": "string",
      "format": "uri",
      "description": "Public HTTPS merchant URL to check"
    }
  }
}

compare_offers

Compare only sourced offer fields from two or more merchants. Unknown values stay unknown and payment never changes order.

read-only

Argument	Type	Description
client_id	string
merchant_urls*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_urls"
  ],
  "properties": {
    "client_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3
    },
    "merchant_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "maxItems": 20,
      "minItems": 2
    }
  }
}

get_safe_actions

Return current merchant-owned action URLs, exact inputs, authority, confirmation, expiry, retry rules, recovery, and attribution.

read-only

Argument	Type	Description
client_id	string
action_type	string
merchant_url*	string
allowed_authority	array
human_confirmation_available	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_url"
  ],
  "properties": {
    "client_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3
    },
    "action_type": {
      "enum": [
        "learn_more",
        "contact",
        "request_quote",
        "book",
        "checkout"
      ],
      "type": "string"
    },
    "merchant_url": {
      "type": "string",
      "format": "uri"
    },
    "allowed_authority": {
      "type": "array",
      "items": {
        "enum": [
          "navigate",
          "prepare",
          "submit"
        ],
        "type": "string"
      }
    },
    "human_confirmation_available": {
      "type": "boolean"
    }
  }
}

get_service_info

Describe the Merchant Context service, price, and inspection checks.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

inspect_merchant

Compatibility alias for refresh_merchant. Show the price and get explicit human approval first.

Argument	Type	Description
agent_id*	string	Stable, non-secret identifier for the calling agent
approved*	boolean	Explicit human approval for this priced refresh
merchant_url*	string	Public HTTPS merchant URL

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_url",
    "agent_id",
    "approved"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3,
      "description": "Stable, non-secret identifier for the calling agent"
    },
    "approved": {
      "type": "boolean",
      "const": true,
      "description": "Explicit human approval for this priced refresh"
    },
    "merchant_url": {
      "type": "string",
      "format": "uri",
      "description": "Public HTTPS merchant URL"
    }
  }
}

preflight

Resolve one merchant, evaluate sourced intent constraints, select a safe action, state approval, and return attribution.

read-only

Argument	Type	Description
timing	string
client_id	string
geography	string
action_type	string
merchant_url*	string
item_or_service	string
allowed_authority	array
max_stale_seconds	integer
maximum_price_amount	number
maximum_price_currency	string
human_confirmation_available

refresh_merchant

Pay for a fresh merchant inspection and cache refresh. Show the price and get explicit human approval first.

Argument	Type	Description
agent_id*	string	Stable, non-secret identifier for the calling agent
approved*	boolean	Explicit human approval for this priced refresh
merchant_url*	string	Public HTTPS merchant URL

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_url",
    "agent_id",
    "approved"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3,
      "description": "Stable, non-secret identifier for the calling agent"
    },
    "approved": {
      "type": "boolean",
      "const": true,
      "description": "Explicit human approval for this priced refresh"
    },
    "merchant_url": {
      "type": "string",
      "format": "uri",
      "description": "Public HTTPS merchant URL"
    }
  }
}

resolve_merchant

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.

read-only

Argument	Type	Description
client_id	string	Stable, non-secret identifier for the calling client
merchant_url*	string	Public HTTPS merchant URL

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_url"
  ],
  "properties": {
    "client_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3,
      "description": "Stable, non-secret identifier for the calling client"
    },
    "merchant_url": {
      "type": "string",
      "format": "uri",
      "description": "Public HTTPS merchant URL"
    }
  }
}

search_merchants

Search cached merchant records by sourced offer, place, price, timing, policy, action support, and freshness. Payment and adoption never change order.

read-only

Argument	Type	Description
policy	string
timing	string
client_id	string	Stable, non-secret identifier for the calling client
freshness	string
geography	string
action_type	string
item_or_service	string
max_stale_seconds	integer
maximum_price_amount	number
maximum_price_currency	string

Input schema (JSON)