Skip to main content

Collections

MCP tools for the Collections module. See the Collections module docs for permissions and data model.

list-collections​

List collections

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoProject public ID (proj_ prefix)
limitnumbernoResults per page. Above the maximum it is clamped; below 1 or not an integer it is 400 VALIDATION_FAILED.
cursorstringnoThe previous page's next_cursor; omit it for the first page. Send it with the same filters as the request that returned it: a malformed cursor, or one sent with other filters, is 400 INVALID_CURSOR.

create-collection​

Create a collection

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoProject the collection belongs to. Optional for a project-scoped API key, which supplies it.
namestringyesUnique within the project.
schemaobject | nullnoA JSON Schema every item's data must satisfy, stored as written. null removes it.

get-collection​

Get a collection

Arguments​

ArgumentTypeRequiredDescription
collection_idstringyesThe collection's public ID (coll_ prefix).

update-collection​

Update a collection

Arguments​

ArgumentTypeRequiredDescription
collection_idstringyesThe collection's public ID (coll_ prefix).
namestringnoUnique within the project.
schemaobject | nullnoA JSON Schema every item's data must satisfy, stored as written. null removes it.

delete-collection​

Delete a collection

Arguments​

ArgumentTypeRequiredDescription
collection_idstringyesThe collection's public ID (coll_ prefix).

list-collection-items​

List items

Arguments​

ArgumentTypeRequiredDescription
collection_idstringyesThe collection's public ID (coll_ prefix).
datastringnoA StructuredFilter over an item's data, as JSON, url-encoded. Equality and in are answered by an index; a range is evaluated on the rows the other conditions leave.
tagsarraynoFilter by tag pairs, written key:value (split on the first colon, so a value may contain colons). Repeat the parameter for several pairs; all must be present with exactly that value.
limitnumbernoResults per page. Above the maximum it is clamped; below 1 or not an integer it is 400 VALIDATION_FAILED.
cursorstringnoThe previous page's next_cursor; omit it for the first page. Send it with the same filters as the request that returned it: a malformed cursor, or one sent with other filters, is 400 INVALID_CURSOR.

get-collection-item​

Get an item

Arguments​

ArgumentTypeRequiredDescription
collection_idstringyesThe collection's public ID (coll_ prefix).
keystringyesThe item's key, unique in its collection: 1–256 letters, digits and . _ : @ -, starting with a letter or digit.

put-collection-item​

Create or replace an item

Arguments​

ArgumentTypeRequiredDescription
collection_idstringyesThe collection's public ID (coll_ prefix).
keystringyesThe item's key, unique in its collection: 1–256 letters, digits and . _ : @ -, starting with a letter or digit.
dataobjectyesThe item's JSON object, at most 64 KB serialized. Stored as jsonb, so key order is not kept.
tagsanynoReplaces the item's tags; null clears them.
expected_versionanynoRefuses the write unless the item is at this version.

update-collection-item​

Update an item

Arguments​

ArgumentTypeRequiredDescription
collection_idstringyesThe collection's public ID (coll_ prefix).
keystringyesThe item's key, unique in its collection: 1–256 letters, digits and . _ : @ -, starting with a letter or digit.
dataanynoThe merge patch applied to the item's data.
tagsanynoReplaces the item's tags; null clears them.
expected_versionanynoRefuses the write unless the item is at this version.

delete-collection-item​

Delete an item

Arguments​

ArgumentTypeRequiredDescription
collection_idstringyesThe collection's public ID (coll_ prefix).
keystringyesThe item's key, unique in its collection: 1–256 letters, digits and . _ : @ -, starting with a letter or digit.

get-collection-item-tags​

Get item tags

Arguments​

ArgumentTypeRequiredDescription
collection_idstringyesThe collection's public ID (coll_ prefix).
keystringyesThe item's key, unique in its collection: 1–256 letters, digits and . _ : @ -, starting with a letter or digit.

replace-collection-item-tags​

Replace item tags

Arguments​

ArgumentTypeRequiredDescription
collection_idstringyesThe collection's public ID (coll_ prefix).
keystringyesThe item's key, unique in its collection: 1–256 letters, digits and . _ : @ -, starting with a letter or digit.

merge-collection-item-tags​

Merge item tags

Arguments​

ArgumentTypeRequiredDescription
collection_idstringyesThe collection's public ID (coll_ prefix).
keystringyesThe item's key, unique in its collection: 1–256 letters, digits and . _ : @ -, starting with a letter or digit.