Skip to main content
Search comments in the active project with optional filters. Results are ordered newest first. Requires: read permission

Parameters

ParameterTypeDescription
searchstringSearch in comment content, page title, or page URL
statusstringFilter by status: open, in_progress, resolved, closed
prioritystringFilter by priority: low, medium, high, urgent
site_idstringFilter by site UUID
page_urlstringFilter by page URL (partial match)
is_resolvedbooleanFilter by resolved state
per_pageintegerResults per page (default: 20, max: 100)
pageintegerPage number (default: 1)

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search-comments",
    "arguments": {
      "status": "open",
      "priority": "urgent",
      "per_page": 10
    }
  }
}

Response

{
  "project": { "id": "...", "name": "My Project" },
  "comments": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "task_key": "SSL-042",
      "content": "The checkout button is broken on mobile",
      "status": "OPEN",
      "priority": "URGENT",
      "is_resolved": false,
      "page_url": "https://example.com/checkout",
      "page_title": "Checkout",
      "site": { "id": "...", "name": "My Site", "url": "example.com" },
      "author": { "id": "...", "name": "Jane Smith", "email": "[email protected]" },
      "created_at": "2026-03-01T10:00:00Z",
      "updated_at": "2026-03-01T10:00:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total": 24,
    "per_page": 10,
    "last_page": 3
  }
}

Example prompts

  • “Find all urgent open comments”
  • “Show comments on the checkout page”
  • “Search for comments mentioning ‘login’”