# Available Tools

Reading Data

| Tool                        | Description                                                            |
| --------------------------- | ---------------------------------------------------------------------- |
| `list_companies`            | Discover all companies you have access to                              |
| `list_programs`             | List all programs for a company                                        |
| `get_program_info`          | Scopes, rewards, rules, poc\_required, dual\_defence flag              |
| `get_program_stats`         | Report counts and SLA status                                           |
| `list_reports`              | Search and filter reports with pagination                              |
| `get_report_sizes`          | Preview field sizes before fetching full content                       |
| `get_report_details`        | Full report content (truncated by default, use `fields` for full text) |
| `get_reports_details_batch` | Fetch multiple reports in one call                                     |
| `get_comments`              | Get comments on a report                                               |
| `list_comments_summary`     | Comment metadata without text (author, role, date)                     |
| `search_comments`           | Search comment text across all reports in a program                    |
| `get_attachments`           | List report attachments                                                |
| `fetch_attachment`          | Download attachment content                                            |
| `list_labels`               | All available labels for a company                                     |

Writing Data

####

| Tool                      | Description                                                 |
| ------------------------- | ----------------------------------------------------------- |
| `add_comment`             | Post a markdown comment                                     |
| `comment_with_attachment` | Post a comment with file attachment(s)                      |
| `screenshot_and_comment`  | Take authenticated screenshot and post as attachment        |
| `update_comment`          | Edit a comment (within 15 min)                              |
| `delete_comment`          | Delete a comment (within 15 min)                            |
| `change_state`            | Change report state (auto-handles intermediate transitions) |
| `change_severity`         | Set severity (Low, Medium, High, Critical)                  |
| `add_labels`              | Add labels (creates new ones if needed)                     |
| `remove_labels`           | Remove labels from a report                                 |

\ <br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hackenproof.com/dashboard/mcp-server/available-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.