WebAZ Agent Commerce Lab
Connect your AI to product discovery and independent merchants. Public shopping is read-only. Account actions depend on the credential and permissions you grant.
No setup needed — just open a link: https://webaz.xyz/api/products?fuzzy=true&q=<keywords>&ship_to=<ISO country, e.g. SG> returns JSON with price (USDC + local-currency estimate), delivered estimate, delivery days, return policy, weight and size (null = not provided by the seller; see compare.missing). Product detail: https://webaz.xyz/api/products/<id>. Human page: https://webaz.xyz/#order-product/<id>. Plain-text version: /llms.txt.
中文说明 / Chinese guide
让 AI 查找商品、连接独立商家。公开购物接口只读，无需登录，不建单、不付款。价格、库存、配送与售后以实时商品信息为准；缺失信息请向卖家核实。
通用接口支持匿名查询、OAuth（启用时）或本地配对的限权委托、账号 API key。工具可见不等于有权执行；切换界面角色不增加授权，缺少权限需重新授权。
限权委托的建单流程是报价→草稿→提交请求→本人 Passkey 审批→服务端重新校验并建单。提交请求不等于已下单或已付款。账号 API key 的直接建单是另一条路径，不经过同一逐单审批；只给可信客户端，并按需撤销。
直付由买家向卖家场外付款，WebAZ 不托管该本金。符合条件且渠道开放时，可用 Base 主网 USDC 合约担保；合约有单笔上限，未经第三方审计，买家建单后仍需钱包存款。示意流程不代表所有操作都受同一种人工确认保护。
下方提供可复制的接口地址、客户端配置和只读提示词；当前能力以连接后的 tools/list 及服务端授权为准。STDIO 是联网桥，不是本地业务数据库。
✅ Your AI can (no login)
- Search & compare products available on the public shopping surface
- Read price (USDC display pricing), stock, delivery ETA, return & handling terms
- See decision flags (e.g. new seller, no sales history) and honest unknowns
🚫 It cannot
- Place an order or move funds from this public surface — it is discovery-only
- Use account permissions merely because a tool is visible
- Verify unstated compatibility — ask the seller about missing facts
🔑 Where a human approves
- With a scoped grant: quote → draft → submit an order request
- That request needs human Passkey approval and server re-validation before order creation
- Account API keys are different: direct order creation does not use this per-order approval queue
Connect an endpoint
https://webaz.xyz/mcp/shopping-v1https://webaz.xyz/mcpThe shopping endpoint exposes one read-only tool (webaz_search). The general endpoint also supports anonymous reads, OAuth when enabled, locally paired grants, and account API keys. Prefer scoped access; share an account key only with a trusted client. See access documentation.
Client setup
Try these prompts
1 · Phone-stand comparison
Using the WebAZ shopping tool, find phone stands and compare all results in a table: price, stock, delivery ETA to Singapore, return window, handling time, and every decision flag. Separate facts the seller states from facts that are missing, and do not assume compatibility with any phone model unless it is stated. Which would you shortlist for a desk, and why?
2 · Laptop-stand known / unknown test
Search WebAZ for “Metal Laptop Cooling Stand”. Produce two lists: (A) facts the listing actually states, with values; (B) facts a careful buyer would want that are NOT stated (for example exact dimensions, supported laptop size range, maximum load). For list B, say “unknown” — do not fill gaps with typical values for similar products.
3 · Order-safety walkthrough (read-only)
Using WebAZ public documentation, distinguish public shopping, scoped order requests with human Passkey approval, and direct account-key ordering. Explain payment separately for Direct Pay and eligible USDC escrow. State who acts and what changes. Do not create an order, submit a request, pay, or call any state-changing tool.
Scoped order-request flow / 限权委托建单流程
Submitting a request is not an order or a payment. This flow applies to scoped order requests, not every account-key action. After approval and successful re-validation, Direct Pay is paid off-platform; USDC escrow requires a separate wallet deposit.
Access paths, clearly separated
| Mode | Credential | What it can touch |
|---|---|---|
| Network read-only | none | Live reviewed catalog via /mcp/shopping-v1 (or the stdio package without a key). Discovery only. |
| Authenticated network: scoped grant | OAuth or locally paired grant | Allowed reads and supported operations only. Order quote / draft / submit requires order:draft; human approval executes the order request. |
| Authenticated network: account key | api_key | Direct account actions, including webaz_place_order, subject to server checks. Not a blanket per-action Passkey gate. Keep keys private and revoke unused access. |
| Local STDIO bridge | optional api_key or local scoped grant | The same live Remote MCP full surface through a local process, plus local webaz_pair. It is not a local business database. |
Honest facts, honest unknowns
Use current listing data, not a frozen example. Prices, stock and delivery terms can change.
Known (stated by the listing)
- Check the current product page for price, stock and options
- Read the seller's delivery estimate and return terms for your destination
- Use the seller information and decision flags actually returned
Unknown (and reported as unknown)
- Mark dimensions, compatibility or load limits unknown when the listing does not state them
- Missing delivery or return terms are not a promise
- Do not fill gaps with “typical” values — ask the seller before relying on them
Browse current products / 浏览当前商品. Public shopping provides discovery; account actions follow the access paths above.