Merchant Context
Resolve sourced merchant facts and safe actions before an agent acts.
| Endpoint | https://api.merchant.atomandbits.com/mcp (streamable-http) |
|---|---|
| Registry version | 0.3.0 |
| Now | 9 tools · grade C (72) · pin ts_d57253a4262ad973267a7190f6ec8087 · protocol 2025-06-18 |
| First / last listed | 2026-10-28 03:03 UTC / 2026-10-28 03:03 UTC |
| Grade over time | 2026-10-28: C (72), 9 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: get_service_info check_merchant resolve_merchant search_merchants compare_offers get_safe_actions preflight refresh_merchant inspect_merchant
get_service_info | Describe the Merchant Context service, price, and inspection checks. params: none |
check_merchant | Run a free merchant-site diagnostic. Agents should use resolve_merchant before relying on merchant facts or actions. params: 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. params: merchant_url*, client_id |
search_merchants | Search cached merchant records by sourced offer, place, price, timing, policy, action support, and freshness. Payment and adoption never change order. params: item_or_service, geography, maximum_price_amount, maximum_price_currency, timing, policy, action_type, freshness, max_stale_seconds, client_id |
compare_offers | Compare only sourced offer fields from two or more merchants. Unknown values stay unknown and payment never changes order. params: merchant_urls*, client_id |
get_safe_actions | Return current merchant-owned action URLs, exact inputs, authority, confirmation, expiry, retry rules, recovery, and attribution. params: merchant_url*, client_id, action_type, allowed_authority, human_confirmation_available |
preflight | Resolve one merchant, evaluate sourced intent constraints, select a safe action, state approval, and return attribution. params: merchant_url*, client_id, item_or_service, action_type, geography, maximum_price_amount, maximum_price_currency, timing, max_stale_seconds, allowed_authority, human_confirmation_available |
refresh_merchant | Pay for a fresh merchant inspection and cache refresh. Show the price and get explicit human approval first. params: merchant_url*, agent_id*, approved* |
inspect_merchant | Compatibility alias for refresh_merchant. Show the price and get explicit human approval first. params: merchant_url*, agent_id*, approved* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.