Libraries
Named collections of prompts, with membership management.
search_librariesget_librarylist_library_promptscreate_libraryupdate_libraryadd_prompt_to_libraryremove_prompt_from_library
search_libraries read-only
Search or list libraries (named collections of prompts, e.g. "Marketing prompts").
| 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_libraries",
"arguments": {}
}
get_library read-only
Fetch one library by id, including its prompt count.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Library id. |
{
"name": "get_library",
"arguments": {
"id": "..."
}
}
list_library_prompts read-only
List the prompts inside a library, including each prompt's compiled text. The default scope (public) hides the user's own private member prompts - pass scope "all" to see every prompt accessible to the user.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Library id. |
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": "list_library_prompts",
"arguments": {
"id": "..."
}
}
create_library write · non-destructive
Create a library for organising prompts. Add prompts with add_prompt_to_library.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | Library name. |
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. |
description | string | no | What this library collects. |
tags | string[] | no | Tags for categorisation and tag-filtered search. |
{
"name": "create_library",
"arguments": {
"name": "...",
"isPublic": false
}
}
update_library write · non-destructive
Update a library's metadata. Takes the full new state: name is required even when unchanged.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Library id. |
name | string | yes | Library name (required even when unchanged). |
description | string | no | New description. |
isPublic | boolean | no | Optionally change visibility. |
tags | string[] | no | Tags for categorisation and tag-filtered search. |
{
"name": "update_library",
"arguments": {
"id": "...",
"name": "..."
}
}
add_prompt_to_library write · idempotent
Add a prompt to a library. Reversible with remove_prompt_from_library.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Library id. |
promptId | string | yes | Prompt id to add. |
{
"name": "add_prompt_to_library",
"arguments": {
"id": "...",
"promptId": "..."
}
}
remove_prompt_from_library write · idempotent
Remove a prompt from a library. Only the library membership is removed; the prompt itself is not deleted. Reversible with add_prompt_to_library.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Library id. |
promptId | string | yes | Prompt id to remove. |
{
"name": "remove_prompt_from_library",
"arguments": {
"id": "...",
"promptId": "..."
}
}