Context & Resources

create_context_collection

Create a new context collection to group related reference materials for easier management and targeted retrieval. Use the returned ID with add_context to add items to the collection.

Parameters

Name	Type	Required	Default	Description
`name`	`string`	Yes	—	Display name for the collection, shown wherever collections are listed and picked. Required. Make it specific — "Q2 Product Research" rather than "Research" — since it is the only label anyone sees when filing reference material into it.
`description`	`string`	Yes	—	Free-text note on what belongs in this collection, so you and teammates file material consistently later. It is stored for display only and has no effect on search, retrieval, or generation. An empty string is accepted if there is nothing useful to say.
`is_private`	`boolean`	Yes	false	true makes the collection visible only to you: material filed in it is hidden from every other team member, including from their list_context_items and get_context_item calls. false shares it with the whole team, which is the default and the right choice unless the user explicitly asks to keep it to themselves.

Input Schema

{
  "type": "object",
  "required": [
    "name",
    "description",
    "is_private"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name for the collection, shown wherever collections are listed and picked. Required. Make it specific — \"Q2 Product Research\" rather than \"Research\" — since it is the only label anyone sees when filing reference material into it."
    },
    "is_private": {
      "type": "boolean",
      "description": "true makes the collection visible only to you: material filed in it is hidden from every other team member, including from their list_context_items and get_context_item calls. false shares it with the whole team, which is the default and the right choice unless the user explicitly asks to keep it to themselves."
    },
    "description": {
      "type": "string",
      "description": "Free-text note on what belongs in this collection, so you and teammates file material consistently later. It is stored for display only and has no effect on search, retrieval, or generation. An empty string is accepted if there is nothing useful to say."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Collection ID. Pass this as collection_id to add_context to add items to this collection."
    },
    "name": {
      "type": "string",
      "description": "Collection name."
    },
    "link_url": {
      "type": "string",
      "format": "uri",
      "description": "Direct URL to view this collection in the Marcora app."
    },
    "created_at": {
      "type": "integer",
      "description": "Unix timestamp of creation."
    },
    "is_private": {
      "type": "boolean",
      "description": "Whether this collection is private to the creator."
    },
    "description": {
      "type": "string",
      "description": "Collection description."
    }
  }
}

Instructions

Create a new context collection to organize your reference materials.

Parameters:

name: A descriptive name for the collection (e.g., "Brand Guidelines", "Product Research Q2")
description: A short description of what this collection contains
is_private: If true, only you can see this collection. If false, all team members can access it.

After creating a collection, use the returned id with the add_context tool (pass it as collection_id) to add context items to this collection. You can also use list_context_collections to see all existing collections and their IDs.