ARC · DEVELOPERS · MCP TOOLS · READ THE DATA

list_category_agent_facts

Agent facts by category

The latest typed agent facts for every store in a category.

NO LOGIN

What it does

List free ARC agent facts by category (beauty, footwear, apparel, …) with no login. Ranked by newest real Jev scores. JSON: GET /api/agent-facts?category=beauty

Limits: Daily read limit per network.

Arguments

Name	Type	Required	Description
category	string	no	Category id or words, e.g. beauty, running shoes
limit	number	no	1–50, default 20

Full input JSON Schema

INPUT SCHEMA

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Category id or words, e.g. beauty, running shoes"
    },
    "limit": {
      "type": "number",
      "description": "1–50, default 20"
    }
  }
}

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":"list_category_agent_facts","arguments":{"category":"beauty","limit":10}}}'

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": "list_category_agent_facts",
      "arguments": {
        "category": "beauty",
        "limit": 10
      }
    }
  }),
});
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": "list_category_agent_facts",
        "arguments": {
            "category": "beauty",
            "limit": 10
        }
    }
}, 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?category=beauty&limit=10'