Search works
search_worksSearch the Klavierstuck catalogue of classical keyboard works, like the site's Works page. Combine free text (title words or a catalogue reference such as "BWV 846" or "Op. 28") with filters given in plain words: composer, key, sub-genre, instrument, performing forces, and a difficulty range on one scale. A name that matches nothing or several entries returns an error listing candidates. Each row has its klavierstuck.org URL and slug (pass it to get_work for details); the answer gives the total count and the sources to cite.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_works"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | Key, in English in plain words, e.g. "D minor", "E-flat major" or "F♯ minor". | |
| page | No | Page number, from 1. | |
| limit | No | Works per page: 20 by default, at most 50 (larger values are capped). | |
| query | No | Free text: words of the title or a catalogue reference, e.g. "nocturne" or "Op. 9". | |
| forces | No | Performing forces in plain words, e.g. "Solo", "Four hands" or "Two pianos". | |
| composer | No | Composer in plain words, e.g. "Chopin" or "Clara Schumann". | |
| sub_genre | No | Sub-genre, in English in plain words, e.g. "Nocturne", "Waltz" or "Fugue". | |
| instrument | No | Instrument in plain words, e.g. "Piano", "Organ" or "Harpsichord". | |
| difficulty_max | No | Highest level on difficulty_scale (inclusive). | |
| difficulty_min | No | Lowest level on difficulty_scale (inclusive). | |
| difficulty_scale | No | Difficulty scale the range applies to in plain words, e.g. "PianoSyllabus" (0–10), "RCM", "ABRSM" or "PianoLibrary". |