Tool Reference

get_monitoring_results

Get the latest monitoring script results for a brand.

Parameters

Parameter Type Required Description
brandId string Yes The brand ID (UUID) or brand name (e.g., "Ace Auto Repair")

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": "get_monitoring_results",
      "arguments": {
        "brandId": "brand_abc123"
      }
    }
  }'

Example Response

Parsed from result.content[0].text:

[
  {
    "scriptName": "AI Platform Scanner",
    "lastRunAt": "2026-02-17T15:00:00.000Z",
    "status": "success",
    "metrics": {
      "platformsCovered": 4,
      "mentionsFound": 23,
      "accuracyScore": 72
    },
    "alerts": [
      "Incorrect hours listed on ChatGPT",
      "Missing EV service mention on Gemini"
    ]
  },
  {
    "scriptName": "Crawler Access Monitor",
    "lastRunAt": "2026-02-17T15:05:00.000Z",
    "status": "warning",
    "metrics": {
      "crawlersBlocked": 1,
      "crawlersAllowed": 3
    },
    "alerts": [
      "GPTBot is blocked by robots.txt"
    ]
  }
]

Output Schema

Returns an array of monitoring result objects (one per script, latest run only):

Field Type Description
scriptName string Name of the monitoring script
lastRunAt string ISO 8601 timestamp of the most recent run
status string "success", "error", or "warning"
metrics object Key-value pairs of numeric metrics from the run
alerts string[] List of alert messages generated by the run

Notes

  • Returns the latest run result for each monitoring script associated with the brand.
  • If no monitoring scripts have been configured or run, an empty array is returned.