list_simulations

List recent AI simulation sessions — tests that check how AI platforms respond to queries about your brand.

Parameters

Example Request

curl -X POST https://socialcrm.com/api/mcp-app \
  -H "Authorization: Bearer sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/call",
    "params": {
      "name": "list_simulations",
      "arguments": {
        "limit": 5
      }
    }
  }'

Example Response

Parsed from result.content[0].text:

[
  {
    "id": "sim_abc123",
    "platform": "ChatGPT",
    "brandName": "Ace Auto Repair",
    "query": "best brake repair shop near Dallas",
    "status": "completed",
    "score": 85,
    "createdAt": "2026-03-09T15:30:00.000Z"
  },
  {
    "id": "sim_def456",
    "platform": "Claude",
    "brandName": "Ace Auto Repair",
    "query": "affordable oil change DFW",
    "status": "completed",
    "score": 62,
    "createdAt": "2026-03-08T10:15:00.000Z"
  }
]

Output Schema

Returns an array of simulation summary objects:

Notes

• Simulations are created through the dashboard's AI Simulator or via workflow runs.
• Use this tool to review how your brand performs across different queries and platforms.
• Results are ordered by most recent first.