Visibility

list_alerts

Current alerts for the project (drops, losses, setup problems).

readReads only. Annotated read-only, so a client can call it without asking.

Plan: Grow and above
Rate cost: 1 unit
REST: GET /projects/{project_id}/alerts

Try asking

“Anything urgent in Vidrys today?”

list_alerts

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_alerts",
    "arguments": {
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  }
}

structuredContent

{
  "content": [
    {
      "type": "text",
      "text": "…the same JSON, as text…"
    }
  ],
  "structuredContent": {
    "alerts": [
      {
        "message": "3 platforms not recommending you for 'best invoicing software for freelancers in India'",
        "tone": "warning",
        "platform": "chatgpt"
      },
      {
        "message": "Win rate dropped to 0% — content needs attention",
        "tone": "warning",
        "platform": "gemini"
      },
      {
        "message": "AEO: AI crawlers blocked in robots.txt",
        "tone": "warning",
        "platform": null
      }
    ]
  },
  "isError": false
}

Arguments

Passed as the tool call's arguments.

project_idstringrequired

The project to read, from list_projects.

Result

The same object as List alerts, returned as structured output.

alertsobject[]

Newest run's alerts, at most 8.

+Show child attributes

messagestring

The alert, as the dashboard shows it.

tonestringnullable

Severity.

Values:warning

platformstringnullable

The engine it concerns. Null for site-audit alerts.

Values:chatgptperplexitygeminicopilotai_overviewsclaude

Errors

404 not_found	The project or item doesn't exist in this workspace. A project from another workspace also returns 404, never 403.
422 invalid_request	A parameter or body field is missing or has the wrong type or value. The message names the field. Also returned when a write would pass the plan's prompt limit.
401 unauthorized	No key was sent, or the key is unknown, revoked or expired, or the member who created it has left the workspace or been deactivated.
402 plan_required	The workspace's plan doesn't include API access. It's included on Grow, Scale and Custom.
403 workspace_not_approved	The workspace is still waiting for approval, or wasn't approved.
429 rate_limited	Too many requests this minute. Wait for the number of seconds in the `Retry-After` header, then retry.

Every code, and what to retry, is in Errors.

Failures arrive as a tool error — isError: true with code: message as text. See Using the tools.