search-comments - SureFeedback API Docs

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

Parameters

Parameter	Type	Description
`search`	string	Search in comment content, page title, or page URL
`status`	string	Filter by status: `open`, `in_progress`, `resolved`, `closed`
`priority`	string	Filter by priority: `low`, `medium`, `high`, `urgent`
`site_id`	string	Filter by site UUID
`page_url`	string	Filter by page URL (partial match)
`is_resolved`	boolean	Filter by resolved state
`per_page`	integer	Results per page (default: 20, max: 100)
`page`	integer	Page 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’”