ARC store checks

Call this with a store domain, such as allbirds.com. Returns the saved checkout evidence, or not checked yet when ARC has no saved check. Free, no login, no new scan, and no fetch of the store. A missing field on a saved check says "not recorded" and is not a zero.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Store domain, such as allbirds.com."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

Search stores where a saved check shows an agent reached checkout, filtered by platform, protocol, or category. With no filters, returns the most recently checked of those stores and labels the result default: no filters given. A missing result is not counted against a store. No login and no new scan.

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "description": "Commerce platform id, such as shopify or woocommerce."
    },
    "protocol": {
      "type": "string",
      "description": "ucp, webmcp, or mcp. ACP, PAP, and payments are not recorded per store."
    },
    "category": {
      "type": "string",
      "description": "Category or shopper words, such as footwear or running shoes."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "How many stores to return. Default 10. Maximum 25."
    }
  },
  "additionalProperties": false
}

Report how far one agent got at one store. Free, no login. Omit contributor_key and ARC issues one. Emails, phones, street addresses, and card numbers are rejected. The report stays private until 3 independent contributors agree within 14 days. Same as POST /api/outcomes.

{
  "type": "object",
  "properties": {
    "store_domain": {
      "type": "string",
      "description": "Store hostname, such as allbirds.com."
    },
    "agent_family": {
      "type": "string",
      "description": "Agent family, such as browser or a model family. No personal name."
    },
    "agent_name": {
      "type": "string",
      "description": "Name of the agent that tried the checkout. No personal name."
    },
    "contributor_key": {
      "type": "string",
      "description": "Optional. Omit it and ARC returns a free key. Send that key on later reports."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 time of the attempt, within the last 14 days."
    },
    "furthest_step": {
      "type": "string",
      "enum": [
        "product",
        "cart",
        "checkout",
        "payment",
        "placed"
      ],
      "description": "Furthest step the agent reached."
    },
    "blocker": {
      "type": "string",
      "enum": [
        "captcha",
        "login_wall",
        "bot_block",
        "3ds",
        "payment_declined",
        "none"
      ],
      "description": "What stopped the agent, or none."
    },
    "store_error_text": {
      "type": "string",
      "description": "Optional store error text. Personal data is stripped."
    }
  },
  "required": [
    "store_domain",
    "agent_family",
    "agent_name",
    "timestamp",
    "furthest_step",
    "blocker"
  ],
  "additionalProperties": false
}

[Requires sign-in] Look up a free ARC store card by host. Includes saved measurements and brand_claim ownership metadata. Brand statements are not measured by ARC; claims never change measured scores.

{
  "type": "object",
  "properties": {
    "host": {
      "type": "string"
    }
  },
  "required": [
    "host"
  ]
}

[Requires sign-in] Read saved public Google agentic checkout readiness checks for a store. Free; no new scan or paid calls. Merchant Center feed eligibility cannot be checked from outside. Not Google approval or certification.

{
  "type": "object",
  "properties": {
    "host": {
      "type": "string",
      "description": "Store host or URL"
    }
  },
  "required": [
    "host"
  ]
}

Free latest saved product data and return/shipping policy check from the store's pages and structured data. Reads history only; no store fetch or model call. A missing result is not a zero.

{
  "type": "object",
  "properties": {
    "host": {
      "type": "string"
    },
    "url": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

[Requires sign-in] Can an AI agent buy from this store or check out on this Shopify store? Free real HTTP check of any public homepage or product URL: agent catalog, product, checkout link, UCP profile, Checkout WebMCP (Shopify-only checkoutWebmcp: status, nullable detected, tools, reason; buyer approval required), Shopify WebMCP storefront adapter (used by browser agents; detected in the HTML, not a browser session), blocks, and the fix. No model call, payment, or browser scan. Cached per host for 24 hours. A returned link means reach checkout, not a completed purchase.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Public store homepage or product URL"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

[Requires sign-in] Check whether personal AI agents can reach a product URL, understand it, and buy from it. Runs ARC's readiness check: crawler access, whether an agent can answer a shopper's questions from the page, and personal shopping agents trying to add to cart or reach checkout. Returns a check id — poll get_readiness_result (about 30–60 seconds). This does not ask what agents think of the brand; use ask_agents_about_brand for that.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The product or store URL to test, e.g. https://store.com/products/best-seller"
    },
    "task": {
      "type": "string",
      "description": "Optional goal, e.g. 'add to cart' (default) or 'reach checkout'."
    }
  },
  "required": [
    "url"
  ]
}

[Requires sign-in] Get a readiness check by id. While running, reports progress. When complete, reports whether personal agents could reach the page, understand it, and buy, plus the wall, concrete next steps, a directional score, a per-agent breakdown, and screenshots. Calling this again with the same id redisplays the result and does not start a new check. Never re-run check_agent_readiness just to see the screenshots again.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The check id returned by check_agent_readiness."
    }
  },
  "required": [
    "id"
  ]
}

[Requires sign-in] List this workspace's recent readiness checks (newest first) — each store, its score, status, and id. Use an id with get_readiness_result to reopen a check.

{
  "type": "object",
  "properties": {},
  "required": []
}

[Requires sign-in] Ask benchmark personal-agent personas what they think of a brand and whether they would recommend it for a category. Personas: Muse-style, Instinct-style, Grok Bot-style, OpenAI dots-style, and OpenClaw-style. This tool uses benchmark personas, including the Grok Bot-style persona; these are not live consumer-product sessions. It is not the real Grok read-back on a scan and it is not the agent-rails HTTP check. What Grok tells shoppers on a scan is a real model call via API, checked against the store's pages, not the consumer Grok app. All five cart attempts, Grok included, are ARC browser cart tests. Returns, per persona: mentioned, recommended, which competitors were recommended instead, sentiment, and short quotes, plus next steps. Limited to 8 runs per workspace per day and 12 per network. Free workspaces also share a site-wide daily cap so unpaid runs cannot drain the model budget.

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand name, e.g. Allbirds."
    },
    "store_url": {
      "type": "string",
      "description": "Public store URL, e.g. https://www.allbirds.com"
    },
    "category": {
      "type": "string",
      "description": "Product category a shopper would ask about, e.g. running shoes."
    },
    "competitors": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional competitor brand names to watch for in the answers."
    }
  },
  "required": [
    "brand",
    "store_url",
    "category"
  ]
}

[Requires sign-in] Concrete next steps to get recommended by personal agents and to become reachable, understandable, and buyable. Pass a readiness check id and/or the brand, category, store URL, and competitors that were recommended instead. Uses the check's evidence when an id is given. Does not start a new check.

{
  "type": "object",
  "properties": {
    "scan_id": {
      "type": "string",
      "description": "Optional readiness check id from check_agent_readiness."
    },
    "brand": {
      "type": "string",
      "description": "Brand name, if you want recommendation steps."
    },
    "category": {
      "type": "string",
      "description": "Product category, e.g. running shoes."
    },
    "store_url": {
      "type": "string",
      "description": "Store URL."
    },
    "competitors_recommended": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Competitors personal agents recommended instead."
    },
    "mentioned": {
      "type": "boolean",
      "description": "Whether any benchmark persona mentioned the brand."
    },
    "recommended": {
      "type": "boolean",
      "description": "Whether any benchmark persona recommended the brand for the category."
    }
  },
  "required": []
}

[Requires sign-in] Set up scheduled monitoring for one or more store URLs (the 'set up monitoring' flow). Validates each URL and rejects invalid/private/internal ones. GUIDED FLOW: first ask the user for the URLs (paste a list or a CSV), then the frequency (daily/weekly/monthly, default weekly). Every plan runs the core panel of personal shopping agents — no picking needed. Call once without confirmed=true to preview the exact setup and scan-credit estimate, read that summary to the user, and only after the user explicitly says yes call again with confirmed=true to create the monitors. Each scheduled run uses one scan credit. Every run emails who reached the cart, who stopped or started, the stuck step, and the fix. Weekly is what the plans include; daily only fits when the plan's scan allowance covers it.

{
  "type": "object",
  "properties": {
    "urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Store/product URLs to monitor (a list or pasted CSV lines)."
    },
    "frequency": {
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "monthly"
      ],
      "description": "How often to re-test. Default: weekly."
    },
    "depth": {
      "type": "string",
      "enum": [
        "cart",
        "checkout"
      ],
      "description": "How far each scan goes. Default: cart."
    },
    "confirmed": {
      "type": "boolean",
      "description": "Must be true only after the user has confirmed the summarized setup. If missing or false, ARC returns a preview and creates nothing."
    }
  },
  "required": [
    "urls"
  ]
}

[Requires sign-in] List the workspace's monitors — each store re-checked on a schedule for whether personal agents can still reach it and buy. Includes cadence, status, last score, next run, and the monitor id.

{
  "type": "object",
  "properties": {},
  "required": []
}

[Requires sign-in] Overview of whether monitored stores are still buyable by personal agents: latest score, trend, status, next run, and recent regression alerts.

{
  "type": "object",
  "properties": {},
  "required": []
}

[Requires sign-in] Change a monitor's cadence (daily/weekly/monthly) or label. Use the monitor id from list_monitors.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Monitor id from list_monitors."
    },
    "frequency": {
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "monthly"
      ]
    },
    "label": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

[Requires sign-in] Pause a monitor so it stops running on schedule (its history is kept). Use the monitor id from list_monitors.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Monitor id from list_monitors."
    }
  },
  "required": [
    "id"
  ]
}

[Requires sign-in] Resume a paused monitor.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Monitor id from list_monitors."
    }
  },
  "required": [
    "id"
  ]
}

[Requires sign-in] Run a monitor's scan immediately (off-schedule) to establish or refresh its baseline. Consumes one scan credit — only call when the user explicitly asks to run now. Use the monitor id from list_monitors.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Monitor id from list_monitors."
    }
  },
  "required": [
    "id"
  ]
}