add_marcora_collection
Add a published Marcora Collection to your library so its items can be searched and read. Idempotent.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
marcora_collection_id | integer | No | — | Published Marcora Collection ID from list_marcora_collections. Provide marcora_collection_id, slug, or title. |
slug | string | No | — | Slug of the published Marcora Collection (or a full https://marcora.ai/collections/<slug> URL). Provide marcora_collection_id, slug, or title. |
title | string | No | — | Exact public title of the Marcora Collection (case-insensitive), for example from a user's prompt. Provide marcora_collection_id, slug, or title. |
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Slug of the published Marcora Collection (or a full https://marcora.ai/collections/<slug> URL). Provide marcora_collection_id, slug, or title."
},
"title": {
"type": "string",
"description": "Exact public title of the Marcora Collection (case-insensitive), for example from a user's prompt. Provide marcora_collection_id, slug, or title."
},
"marcora_collection_id": {
"type": "integer",
"description": "Published Marcora Collection ID from list_marcora_collections. Provide marcora_collection_id, slug, or title."
}
}
}Output Schema
{
"type": "object",
"required": [
"marcora_collection_id",
"collection_id",
"slug",
"title",
"in_library",
"already_in_library",
"status",
"state",
"message",
"item_count",
"items",
"link_url"
],
"properties": {
"slug": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Context item UUID. Pass to get_context_item to read full markdown."
},
"name": {
"type": "string"
}
}
}
},
"state": {
"enum": [
"added",
"default_visible"
],
"type": "string"
},
"title": {
"type": "string"
},
"status": {
"enum": [
"added",
"already_in_library"
],
"type": "string",
"description": "\"already_in_library\" when the collection was already active in the user's library; \"added\" when this call added or un-hid it."
},
"message": {
"type": "string",
"description": "Plain-text status and next-step instruction (states whether the collection was already in the library or newly added, and which collection_id to pass to get_relevant_context)."
},
"link_url": {
"type": "string",
"description": "URL to view Marcora Collections in the Marcora web app."
},
"in_library": {
"type": "boolean"
},
"item_count": {
"type": "integer"
},
"description": {
"type": [
"string",
"null"
]
},
"collection_id": {
"type": "integer",
"description": "Context collection ID to pass in collection_ids on get_relevant_context or as collection_id on list_context_items."
},
"availability_mode": {
"enum": [
"default",
"opt_in"
],
"type": "string"
},
"already_in_library": {
"type": "boolean",
"description": "True when the collection was already active in the user's library before this call (for example, attached at signup or previously added); false when this call newly added or un-hid it. When true, go straight to answering the user's request."
},
"marcora_collection_id": {
"type": "integer"
}
}
}Instructions
Add a published Marcora Collection to the current user's library so its items can be searched with get_relevant_context and read with list_context_items and get_context_item. Idempotent: safe to call when the collection is already in the library.
When to use: list_marcora_collections shows the collection the user named with in_library: false. Call it without asking for confirmation, then use the returned collection_id.
Parameters: provide one of the following.
| Parameter | Type | Required | Description |
|---|---|---|---|
marcora_collection_id |
integer | One of three | Published Marcora Collection ID from list_marcora_collections |
slug |
string | One of three | Collection slug, or a full https://marcora.ai/collections/<slug> URL |
title |
string | One of three | Exact public title (case-insensitive) |
Output: marcora_collection_id, collection_id (pass this as collection_ids to get_relevant_context, or collection_id to list_context_items), slug, title, description, availability_mode, in_library, already_in_library, status (added or already_in_library), state (added or default_visible), message, item_count, items, link_url. When already_in_library is true, do not tell the user it was just added; answer from the collection's content.
Example prompts:
- "Add the 'Launch Messaging' collection from Marcora to my library"
Links: present link_url to the user exactly as returned — copy it character for character. Never retype, shorten, or rebuild a link or the IDs inside it.