list_notifications

List recent notifications and alerts for the company: bot access events, crawler errors, content gaps, AI mentions, and system alerts.

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_notifications",
      "arguments": {
        "onlyUnread": true,
        "limit": 5
      }
    }
  }'

Example Response

Parsed from result.content[0].text:

[
  {
    "id": "notif_abc123",
    "type": "ai_mention",
    "title": "New AI mention detected",
    "message": "ChatGPT mentioned Ace Auto Repair in response to 'best brake repair Dallas'",
    "severity": "medium",
    "timestamp": "2026-03-10T12:00:00.000Z",
    "isRead": false
  },
  {
    "id": "notif_def456",
    "type": "crawler_error",
    "title": "Crawler blocked on acme.com",
    "message": "The AI bot crawler was blocked by robots.txt on acme.com/pricing",
    "severity": "high",
    "timestamp": "2026-03-09T18:45:00.000Z",
    "isRead": false
  }
]

Output Schema

Returns an array of notification objects:

Notes

• This tool is read-only. To mark notifications as read, use the dashboard UI.
• Use onlyUnread: true to get actionable items only.
• Notifications are ordered by most recent first.