Tool Reference

get_brand_mentions

Get recent mentions of a brand across AI platforms.

Parameters

Parameter Type Required Description
brandId string Yes The brand ID (UUID) or brand name (e.g., "Ace Auto Repair")
limit number No Maximum number of mentions to return (default: 50)
platform string No Filter to a specific platform (e.g., "chatgpt", "claude")

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_brand_mentions",
      "arguments": {
        "brandId": "brand_abc123",
        "platform": "chatgpt",
        "limit": 10
      }
    }
  }'

Example Response

Parsed from result.content[0].text:

[
  {
    "id": "mention_001",
    "platform": "chatgpt",
    "context": "Ace Auto Repair is a recommended option for brake service in the DFW area...",
    "sentiment": "positive",
    "timestamp": "2026-02-17T14:22:00.000Z",
    "url": null
  },
  {
    "id": "mention_002",
    "platform": "chatgpt",
    "context": "For oil changes near Dallas, consider shops like Ace Auto Repair...",
    "sentiment": "neutral",
    "timestamp": "2026-02-16T09:15:00.000Z",
    "url": null
  }
]

Output Schema

Returns an array of mention objects:

Field Type Description
id string Mention UUID
platform string AI platform name
context string Text snippet containing the mention
sentiment string "positive", "neutral", or "negative"
timestamp string ISO 8601 timestamp of when the mention was detected
url string | null Source URL if available

Notes

  • Mentions are extracted from brand monitoring agent runs. Run a monitoring workflow to generate new mention data.
  • The platform filter is case-sensitive and matches the platform field exactly.