get_ai_visibility_score | SocialCRM API Docs

Get the AI visibility score for a brand — the core metric showing how well the brand appears across AI platforms (ChatGPT, Claude, Gemini, Perplexity).

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_ai_visibility_score",
      "arguments": {
        "brandId": "Ace Auto Repair"
      }
    }
  }'

Example Response

Parsed from result.content[0].text:

{
  "score": 78,
  "scoreChange": 5,
  "factors": {
    "content": 80,
    "technical": 76,
    "authority": 72,
    "freshness": 85
  },
  "issueCount": 3,
  "criticalIssueCount": 1,
  "lastCalculated": "2026-03-10T08:30:00.000Z"
}

Output Schema

Field	Type	Description
`score`	number \| null	Overall AI visibility score (0–100). `null` if never calculated.
`scoreChange`	number	Change from the previous score calculation.
`factors`	object \| null	Breakdown by scoring factor (content, technical, authority, etc.).
`issueCount`	number	Total number of open visibility issues.
`criticalIssueCount`	number	Number of critical-severity issues.
`lastCalculated`	string \| null	ISO 8601 timestamp of the most recent score calculation.

Notes

This tool reads the most recent calculated score. It does not trigger a recalculation.
A null score means no score has been calculated yet — run an AI visibility workflow first.
Use get_metric_trend with metricName: "visibilityScore" to see how the score has changed over time.