api.getagentmall.com.
Every /v1/* route needs Authorization: Bearer <key>. Request and response bodies are JSON. Prices and totals are integer minor units of the merchant’s currency (cents for USD, pence for GBP). GET /v1/merchants lists the nine live merchant ids.
get_product and sign_out are MCP only. The console is not on this API.
Health
GET /health
No auth required. Returns 200 when the server is up.
Catalog
POST /v1/catalog/search
Equivalent to MCP search_catalog.
POST /v1/catalog/lookup
Equivalent to MCP lookup_catalog. Reads up to 10 product pages in one call.
Cart
POST /v1/carts
Equivalent to MCP create_cart. Starts an empty cart and returns its id.
GET /v1/carts/:id
Equivalent to MCP get_cart. Reads the live merchant cart.
PUT /v1/carts/:id
Equivalent to MCP update_cart. Replaces the cart: clears, then adds each line.
GET /v1/carts/:id.
POST /v1/carts/:id/cancel
Equivalent to MCP cancel_cart. Returns the cart as last stored, then releases the browser.
Sign-in
POST /v1/carts/:id/sign-in
Equivalent to MCP sign_in. Pass Evervault-encrypted (ev:…) email and password.
POST /v1/carts/:id/sign-in/otp
Equivalent to MCP submit_sign_in_otp. Submits the SMS code after a challenge.
Checkout
POST /v1/carts/:id/checkout
Equivalent to MCP create_checkout. Opens checkout and returns the review.
GET /v1/carts/:id/checkout
Equivalent to MCP get_checkout. Re-reads without changing the page.
POST /v1/carts/:id/checkout.
PUT /v1/carts/:id/checkout
Equivalent to MCP update_checkout. Writes an address, selects a method, or adds a card.
review_hash.
POST /v1/carts/:id/checkout/cancel
Equivalent to MCP cancel_checkout. Leaves checkout without placing. The cart stays open.
POST /v1/carts/:id/checkout/complete
Equivalent to MCP complete_checkout. Places the order when review_hash and total_minor match.
Order
GET /v1/orders/:id
Equivalent to MCP get_order. Reads an order by platform id.
Errors
Every error response haserror.code and error.message: