MCP Tools
Context & Resources

list_marcora_collections

Browse published Marcora Collections: curated, multi-item reference collections a user can add to their library and use as context. Read-only.

Parameters

NameTypeRequiredDefaultDescription
searchstringNo—Optional case-insensitive filter matching the collection title, slug, contributor name, or description. Omit to list all published Marcora Collections.
categorystringNo—Optional case-insensitive category name or slug filter. Omit for all categories.

Input Schema

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "description": "Optional case-insensitive filter matching the collection title, slug, contributor name, or description. Omit to list all published Marcora Collections."
    },
    "category": {
      "type": "string",
      "description": "Optional case-insensitive category name or slug filter. Omit for all categories."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "marcora_collections",
    "total"
  ],
  "properties": {
    "total": {
      "type": "integer"
    },
    "marcora_collections": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "marcora_collection_id",
          "collection_id",
          "slug",
          "title",
          "in_library",
          "item_count",
          "items",
          "link_url"
        ],
        "properties": {
          "slug": {
            "type": "string",
            "description": "URL slug of the Marcora Collection."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "name"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid",
                  "description": "Context item UUID. Pass to get_context_item once the collection is in the user's library."
                },
                "name": {
                  "type": "string"
                }
              }
            }
          },
          "title": {
            "type": "string",
            "description": "Public display title of the Marcora Collection."
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "link_url": {
            "type": "string",
            "description": "URL to view Marcora Collections in the Marcora web app."
          },
          "in_library": {
            "type": "boolean",
            "description": "Whether this collection is currently active in the user's library. When false and the user asked to use this collection, call add_marcora_collection immediately without asking for confirmation. When true, go straight to answering the user's request."
          },
          "item_count": {
            "type": "integer"
          },
          "author_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "is_featured": {
            "type": "boolean"
          },
          "collection_id": {
            "type": "integer",
            "description": "Underlying context collection ID. Once in_library is true, pass in collection_ids on get_relevant_context or as collection_id on list_context_items."
          },
          "availability_mode": {
            "enum": [
              "default",
              "opt_in"
            ],
            "type": "string"
          },
          "marcora_collection_id": {
            "type": "integer",
            "description": "Published Marcora Collection ID. Pass to add_marcora_collection to add it to the user's library."
          }
        }
      }
    }
  }
}

Instructions

Browse published Marcora Collections: curated, multi-item reference collections that a user can add to their library and use as context in Claude, ChatGPT, and Marcora. Read-only. Use it when the user names a context collection by title (for example, Use the "{title}" context collection in Marcora) that does not appear in list_context_collections, or asks which curated collections are available.

When to use: the user names a context collection that is not in list_context_collections, or asks which curated collections are available. If a result has in_library: false, call add_marcora_collection right away without asking for confirmation (naming the collection to use is the instruction to add it). If in_library: true, go straight to answering using the returned collection_id.

Parameters:

Parameter Type Required Description
search string No Case-insensitive filter on title, slug, contributor name, or description. Omit to list all published collections
category string No Case-insensitive category name or slug. Omit for all categories

Output: { marcora_collections, total }. Each collection has marcora_collection_id, collection_id, slug, title, description, summary, author_name, category, is_featured, availability_mode (default or opt_in), in_library (boolean), item_count, items ({ id, name } list), and link_url.

Example prompts:

  • "Use the 'Launch Messaging' context collection in Marcora and tell me how to apply it to my company"
  • "What curated Marcora Collections are available?"

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.