Constraint Collections

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

search_constraint_collections read-only

Search or list constraint collections (named, curated sets of constraints). A collection groups related constraints 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_constraint_collections",
  "arguments": {}
}

get_constraint_collection read-only

Fetch one constraint collection by id, including its full list of constraints.

ParameterTypeRequiredDescription
idstringyesConstraint collection id.
 
{
  "name": "get_constraint_collection",
  "arguments": {
    "id": "..."
  }
}

create_constraint_collection write · non-destructive

Create a constraint collection. Optionally seed it with constraint ids via itemIds; items can also be set later with set_constraint_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[]noConstraint ids to seed the collection with. Obtainable from search_constraints or create_constraint.
 
{
  "name": "create_constraint_collection",
  "arguments": {
    "name": "...",
    "isPublic": false
  }
}

update_constraint_collection write · non-destructive

Update a constraint collection's metadata. Takes the full new state: name is required even when unchanged. Use set_constraint_collection_items to change the constraints inside.

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

set_constraint_collection_items write · idempotent

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

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