Search for games
mister_search_gamesSearch MiSTer FPGA game libraries by name and optional system, returning launchable game references for subsequent launch calls.
Instructions
<use_case> Search for games across MiSTer FPGA libraries by name query and optional system filter. </use_case> <important_notes>
Returns launchable game refs (e.g. 'Family Room/4812').
The ref encapsulates target host and mediaId for subsequent mister_launch calls.
variant differentiates region/revision/hack versions. </important_notes>
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": "mister_search_games"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | MiSTer name from mister_get_status. Omit when the call already says which (a ref does). | |
| limit | No | Most results per MiSTer. | |
| query | Yes | Words in the game's name, e.g. 'metroid'. | |
| system | No | A system id from mister_list_systems, e.g. 'SNES' or 'Genesis'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| results | Yes | ||
| truncated | Yes | ||
| unavailable | Yes |