> ## Documentation Index
> Fetch the complete documentation index at: https://developer.surefeedback.com/llms.txt
> Use this file to discover all available pages before exploring further.

# search-comments

> Search and filter feedback comments by status, priority, site, page URL, or text.

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

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

## Response

```json theme={null}
{
  "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": "jane@example.com" },
      "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'"*