MCP Tools
Context & Resources

add_marcora_collection

Add a published Marcora Collection to your library so its items can be searched and read. Idempotent.

Parameters

NameTypeRequiredDefaultDescription
marcora_collection_idintegerNo—Published Marcora Collection ID from list_marcora_collections. Provide marcora_collection_id, slug, or title.
slugstringNo—Slug of the published Marcora Collection (or a full https://marcora.ai/collections/<slug> URL). Provide marcora_collection_id, slug, or title.
titlestringNo—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.