The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Merchant Context listing page.
Merchant Context is an open merchant preflight for agent builders.
It starts with a practical question:
Can an agent tell what you sell, who it is for, what it costs, which rules apply, and what action comes next without guessing?
This repo contains:
The domain schema and schema/merchant-context.schema.json
must stay semantically equal. Versioned releases preserve old contracts.
This is an early public draft from Atom & Bits. It is not a new payment or checkout protocol. It does not certify ACP, UCP, MCP, A2A, x402, or Web Bot Auth support.
The UCP profile declares no services, checkout capabilities, or payment handlers. It gives agents an explicit discovery response without claiming operations that do not exist.
The goal is to give merchants one testable context layer that can map to those systems as they mature.
No outside adoption is claimed from internal tests, registry views, repository activity, or self-funded payments.
https://api.merchant.atomandbits.com/mcpresolve_merchantPOST https://api.merchant.atomandbits.com/v1/resolverefresh_merchantPOST https://api.merchant.atomandbits.com/v1/refresh0x2f0f…57afThe first paid call settled on 2026-08-04 and returned a live inspection of
https://merchant.atomandbits.com.
python3 scripts/validate.py before publishing.The remote MCP endpoint works with clients that support Streamable HTTP:
Start with resolve_merchant.
It is free.
A cache hit makes no merchant fetch and no paid inspection call.
See the agent integration guide for Codex, Claude Code, Gemini CLI, Cursor, and the OpenAI Responses API.
Agents that support the open Agent Skills format can use
skills/merchant-context.
The worker directory contains the hosted MCP service under test. It exposes:
resolve_merchant, a free sourced merchant record with freshness, unknowns, safe actions, and attribution;search_merchants, a neutral search over cached sourced records;compare_offers, a sourced comparison that keeps unknown values;get_safe_actions, a merchant-owned action handoff with approval and recovery rules;preflight, the reusable resolution and action gate;check_merchant, a free merchant-site diagnostic;refresh_merchant, a $0.01 x402 fresh inspection that needs explicit approval;inspect_merchant, a first-release compatibility alias for paid refresh;/v1; and/.well-known/merchant-context, a public service record for agents and registries.The inspector accepts public HTTPS origins only. It blocks local and IP targets, checks each redirect, caps response size and time, and returns no page body. The payment path records hashes, not wallet addresses or signed payment tokens.
Run its local checks:
Issues, examples, and corrections are welcome. Read CONTRIBUTING.md before opening a pull request.
MIT. See LICENSE.