Tones
Short style descriptors referenced as toneIds in prompts.
search_tones read-only
Search or list tones (short style descriptors like "professional" or "playful"). Tone ids can be referenced as toneIds in create_prompt / update_prompt.
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | no | 1-based page number. Default: 1. |
pageSize | 6 | 12 | 24 | 48 | 100 | no | Items per page. The server only accepts these exact values. Default: 12. |
sort | "newest" | "most-upvoted" | "most-favorited" | no | Sort order. Default: newest. |
scope | "public" | "mine" | "favorites" | "all" | no | public = community items, mine = the user's own items, favorites = items the user favorited, all = everything accessible to the user. Default: public. |
search | string | no | Full-text search over title and description. Max 200 characters. |
tag | string | no | Filter by a single tag (exact match). |
{
"name": "search_tones",
"arguments": {}
}
get_tone read-only
Fetch one tone by id.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Tone id. |
{
"name": "get_tone",
"arguments": {
"id": "..."
}
}
create_tone write · non-destructive
Create a tone. The returned id can be referenced as a toneId in prompts.
| Parameter | Type | Required | Description |
|---|---|---|---|
label | string | yes | The tone descriptor, e.g. "direct" or "playful". |
isPublic | boolean | yes | true publishes the item to the public community feed; false keeps it private to the user. Required: choose deliberately, server defaults are not applied. |
tags | string[] | no | Tags for categorisation and tag-filtered search. |
{
"name": "create_tone",
"arguments": {
"label": "...",
"isPublic": false
}
}
update_tone write · non-destructive
Update a tone in place. Tones are not versioned: the previous label is overwritten without history.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Tone id. |
label | string | yes | New tone descriptor. |
isPublic | boolean | no | Optionally change visibility. |
tags | string[] | no | Tags for categorisation and tag-filtered search. |
{
"name": "update_tone",
"arguments": {
"id": "...",
"label": "..."
}
}