Context & Resources

list_context_items

List context items in the team’s library, with the option to filter to only the unattached reference library.

Input Schema

{
  "type": "object",
  "properties": {
    "reference_library_only": {
      "type": "boolean",
      "description": "When true, returns only items not in any project or collection (Reference Library only). Default false returns everything."
    }
  }
}

Output Schema

{
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "id",
      "name"
    ],
    "properties": {
      "id": {
        "type": "string",
        "format": "uuid",
        "description": "Context item ID. Pass to get_context_item to fetch full markdown."
      },
      "name": {
        "type": "string"
      },
      "added_by": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          }
        },
        "description": "{id: integer, name: string} — the user who added the item."
      },
      "created_at": {
        "type": "integer",
        "description": "Unix timestamp of creation."
      },
      "project_id": {
        "type": [
          "string",
          "null"
        ],
        "format": "uuid",
        "description": "Project this item is associated with, or null."
      },
      "updated_at": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Unix timestamp of last update."
      },
      "word_count": {
        "type": "integer"
      },
      "content_type": {
        "type": "string",
        "description": "One of manual, webpage, canvas, deliverable, integration_data, call_transcript, file."
      },
      "collection_id": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Collection this item lives in, or null."
      },
      "content_intro": {
        "type": "string",
        "description": "Short truncation of the content for previews."
      },
      "relevancy_processed_status": {
        "type": "string",
        "description": "RAG indexing status. One of unprocessed, provisional, complete."
      }
    }
  }
}

Instructions

Lists context items from the team’s context library.

By default returns ALL context items the user can see (across projects, collections, and the reference library). Set reference_library_only=true to return only items that are NOT in any project or collection — these are the items shown in the “Reference Library” section of the MarketCore web app.

Each returned item carries its own collection_id and project_id (both nullable), so you always know where it lives. To get the full markdown content of any item, pass its id to get_context_item.

Privacy: items in private collections (where you are not the creator) and items in private projects (where you are not a member) are filtered out — they will not appear in the response.

Other ways to discover context-item IDs:

get_project(project_id).context_items — items attached to a specific project
list_context_collections — items grouped by collection
get_relevant_context — returns context_item_ids of parent items for matched chunks

Example prompts:

“What context items do I have in MarketCore?”
“Show me everything in my reference library”
“List the context items I haven’t filed into a collection or project”