Search HTB Machines
htb_machine_searchSearch Hack The Box machine lists by name, OS, difficulty, tags, or points, ranked by relevance. Optionally scan retired machines or match description text.
Instructions
Client-side search over the HTB machine lists, ranked by relevance. Matches id, name, OS, difficulty, tags, makers, points, IP. Use all to also scan retired machines. profiles additionally fetches every scanned machine's profile to match description text — powerful but SLOW (one API request per machine, can take minutes), use it only when list fields are not enough. Follow up with htb_machine_profile on a candidate.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "htb_machine_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | Also scan retired machines | |
| limit | No | Max results (default 20) | |
| query | Yes | Search terms, e.g. 'kerberos', 'windows easy', or a machine name | |
| retired | No | Search only retired machines | |
| maxPages | No | Max list pages to scan (default 10) | |
| profiles | No | Also match machine description text (slow: one request per machine) |