Merchant Context

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Merchant Context": {
      "url": "https://api.merchant.atomandbits.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (9)

• get_service_info read-only

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

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• check_merchant read-only

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

  Parameters:

  • merchant_url (required) — string — Public HTTPS merchant URL to check

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• resolve_merchant read-only

  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.

  Parameters:

  • merchant_url (required) — string — Public HTTPS merchant URL
  • client_id — string — Stable, non-secret identifier for the calling client

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• search_merchants read-only

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

  Parameters:

  • 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

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• compare_offers read-only

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

  Parameters:

  • merchant_urls (required) — array
  • client_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_safe_actions read-only

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

  Parameters:

  • merchant_url (required) — string
  • client_id — string
  • action_type — string
  • allowed_authority — array
  • human_confirmation_available — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• preflight read-only

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

  Parameters:

  • merchant_url (required) — string
  • timing — string
  • client_id — string
  • geography — string
  • action_type — string
  • item_or_service — string
  • allowed_authority — array
  • max_stale_seconds — integer
  • maximum_price_amount — number
  • maximum_price_currency — string
  • human_confirmation_available — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• refresh_merchant

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

  Parameters:

  • merchant_url (required) — string — Public HTTPS merchant URL
  • agent_id (required) — string — Stable, non-secret identifier for the calling agent
  • approved (required) — boolean — Explicit human approval for this priced refresh

  Hints: read-only no · destructive no · idempotent no · open-world yes

• inspect_merchant

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

  Parameters:

  • merchant_url (required) — string — Public HTTPS merchant URL
  • agent_id (required) — string — Stable, non-secret identifier for the calling agent
  • approved (required) — boolean — Explicit human approval for this priced refresh

  Hints: read-only no · destructive no · idempotent no · open-world yes

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.