ARC · DEVELOPERS · MCP TOOLS · READ THE DATA

get_agent_facts

Agent facts for a store

Typed agent facts for a store or product (use-case mention, price clarity, agent-friendly description, cart-blocker suspicion, readiness score) with confidences, from an HTTP page scrape.

NO LOGIN

What it does

Read free ARC agent facts for a store or product with no login. Returns TypeSafe Jev typed decisions (use-case mention, price clarity, agent-friendly description, cart-blocker suspicion, readiness score) from an HTTP scrape. Not a browser session and not any third-party agent product; ARC's browser cart tests (ARC browser shoppers A–E) are separate. JSON: GET /api/agent-facts?host=

Limits: Daily read limit per network.

Arguments

NameTypeRequiredDescription
hoststringnoStore hostname, e.g. allbirds.com
urlstringnoStore or product URL
slugstringnoARC Index slug, e.g. allbirds
Full input JSON Schema
INPUT SCHEMA
{
  "type": "object",
  "properties": {
    "host": {
      "type": "string",
      "description": "Store hostname, e.g. allbirds.com"
    },
    "url": {
      "type": "string",
      "description": "Store or product URL"
    },
    "slug": {
      "type": "string",
      "description": "ARC Index slug, e.g. allbirds"
    }
  }
}

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":"get_agent_facts","arguments":{"host":"allbirds.com"}}}'
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": "get_agent_facts",
      "arguments": {
        "host": "allbirds.com"
      }
    }
  }),
});
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": "get_agent_facts",
        "arguments": {
            "host": "allbirds.com"
        }
    }
}, timeout=30)
result = res.json()["result"]
print(json.loads(result["content"][0]["text"]))

REST equivalent

GET /api/agent-facts. Documented in openapi.json.

CURL · GET
curl -s 'https://www.arcreport.ai/api/agent-facts?host=allbirds.com'