ARC · DEVELOPERS · MCP TOOLS · READ THE DATA

find_agent_ready_stores

Find agent-ready stores

Stores where ARC's HTTP agent client reached checkout in the last seven days, by category or shopper words, including checkoutWebmcp status, detection and declared tool names.

NO LOGINREAD-ONLYNOT DESTRUCTIVEIDEMPOTENTNOT REACHES THE OPEN WEB

What it does

Find stores where an AI agent can complete checkout for running shoes, beauty, clothing, home goods, or another product need. Reads ARC's directory of real HTTP agent-catalog checks. Returns only stores checked within seven days whose catalog found a product and returned a checkout link. No purchase completed; availability of your specific item is not guaranteed. Includes checkoutWebmcp (Shopify-only status, nullable detected, tools, reason; buyer approval required) and a webmcp boolean for Shopify storefront adapter detection, not a live browser-agent session. No login, browser scan or model call.

Limits: 50 reads per network per day and 5,000 site-wide, shared with checkout reads.

Arguments

Name	Type	Required	Description
category	string	no	Category slug or shopper words such as running shoes
q	string	no	Product need, such as skincare or camping gear
limit	integer	no	1–50, default 10

Full input JSON Schema

INPUT SCHEMA

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Category slug or shopper words such as running shoes"
    },
    "q": {
      "type": "string",
      "description": "Product need, such as skincare or camping gear"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "additionalProperties": false
}

Call it

From Claude, Cursor, ChatGPT or VS Code, connect the server (config) and ask in plain words; the client picks the tool. Or call it directly with JSON-RPC:

CURL · JSON-RPC

curl -s https://www.arcreport.ai/api/ask \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_agent_ready_stores","arguments":{"category":"running shoes","limit":5}}}'

JAVASCRIPT

const res = await fetch("https://www.arcreport.ai/api/ask", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "find_agent_ready_stores",
      "arguments": {
        "category": "running shoes",
        "limit": 5
      }
    }
  }),
});
const { result } = await res.json();
const data = JSON.parse(result.content[0].text); // result.isError is true on errors
console.log(data);

PYTHON

import json, requests

res = requests.post("https://www.arcreport.ai/api/ask", json={
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "find_agent_ready_stores",
        "arguments": {
            "category": "running shoes",
            "limit": 5
        }
    }
}, timeout=30)
result = res.json()["result"]
print(json.loads(result["content"][0]["text"]))

REST equivalent

GET /api/agent-checkout/stores. Documented in openapi.json.

CURL · GET

curl -s 'https://www.arcreport.ai/api/agent-checkout/stores?category=running%20shoes&limit=5'