Verify a live Shopify offer (Seller Agent)
verify_agent_offerVerify the current price and availability of a product sold by a Shopify store that enabled MagicGEO Seller Agent. Facts are read live from the merchant's Shopify Admin at call time. Without variant_id, returns the product's variants with their state. With variant_id, returns state (VERIFIED, OUT_OF_STOCK or UNAVAILABLE), the offer facts, a short-lived Ed25519-signed passport (verify with jwks_url) and, when VERIFIED, a native Shopify checkout URL for one unit. Stock is never reserved; final price, taxes, shipping and payment are decided by Shopify checkout. Product IDs are listed in the store's agents.md.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"shop": "<shop>",
"product_id": "<product_id>"
},
"name": "verify_agent_offer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shop | Yes | Store domain, e.g. example.myshopify.com | |
| product_id | Yes | Numeric Shopify product ID | |
| variant_id | No | Numeric Shopify variant ID |