Tone Collections

Named, curated sets of tones for grouping and reuse across prompts.

search_tone_collections read-only

Search or list tone collections (named, curated sets of tones). A collection groups related tones for reuse across prompts.

ParameterTypeRequiredDescription
pageintegerno1-based page number. Default: 1.
pageSize6 | 12 | 24 | 48 | 100noItems per page. The server only accepts these exact values. Default: 12.
sort"newest" | "most-upvoted" | "most-favorited"noSort order. Default: newest.
scope"public" | "mine" | "favorites" | "all"nopublic = community items, mine = the user's own items, favorites = items the user favorited, all = everything accessible to the user. Default: public.
searchstringnoFull-text search over title and description. Max 200 characters.
tagstringnoFilter by a single tag (exact match).
 
{
  "name": "search_tone_collections",
  "arguments": {}
}

get_tone_collection read-only

Fetch one tone collection by id, including its full list of tones.

ParameterTypeRequiredDescription
idstringyesTone collection id.
 
{
  "name": "get_tone_collection",
  "arguments": {
    "id": "..."
  }
}

create_tone_collection write · non-destructive

Create a tone collection. Optionally seed it with tone ids via itemIds; items can also be set later with set_tone_collection_items.

ParameterTypeRequiredDescription
namestringyesCollection name.
isPublicbooleanyestrue publishes the item to the public community feed; false keeps it private to the user. Required: choose deliberately, server defaults are not applied.
descriptionstringnoWhat this collection groups.
tagsstring[]noTags for categorisation and tag-filtered search.
itemIdsstring[]noTone ids to seed the collection with. Obtainable from search_tones or create_tone.
 
{
  "name": "create_tone_collection",
  "arguments": {
    "name": "...",
    "isPublic": false
  }
}

update_tone_collection write · non-destructive

Update a tone collection's metadata. Takes the full new state: name is required even when unchanged. Use set_tone_collection_items to change the tones inside.

ParameterTypeRequiredDescription
idstringyesTone collection id.
namestringyesCollection name (required even when unchanged).
descriptionstringnoNew description.
isPublicbooleannoOptionally change visibility.
tagsstring[]noTags for categorisation and tag-filtered search.
 
{
  "name": "update_tone_collection",
  "arguments": {
    "id": "...",
    "name": "..."
  }
}

set_tone_collection_items write · idempotent

Replace the full list of tones in a tone collection. The provided itemIds become the complete set; tones not in the list are removed from the collection.

ParameterTypeRequiredDescription
idstringyesTone collection id.
itemIdsstring[]yesComplete list of tone ids the collection should contain after this call.
 
{
  "name": "set_tone_collection_items",
  "arguments": {
    "id": "...",
    "itemIds": [
      "..."
    ]
  }
}