list_context_items
List context items from the team's library, each with its collection, project, and a link to open it in Marcora. By default it returns all items you can see; private items you don't have access to are filtered out. Pass a `search` query to rank items by semantic relevance instead of recency.
Input Schema
{
"type": "object",
"properties": {
"search": {
"type": "string",
"description": "Optional natural-language query. When provided, context-library items are ranked by SEMANTIC relevance to this query (by each item's best-matching chunk) instead of recency, and each item gains a relevance_score. Omit or leave empty for the normal list."
},
"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": "object",
"required": [
"context_items"
],
"properties": {
"context_items": {
"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."
},
"source_url": {
"type": [
"string",
"null"
],
"description": "For webpage items, the tracked page URL (re-pull it with update_context refresh_webpage); null for all other item types."
},
"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."
},
"relevance_score": {
"type": [
"number",
"null"
],
"description": "Present only when a `search` query was given. A number (cosine similarity 0–1; higher = more relevant) when the item was scored against embeddings, or null when the item is not embedded yet and could not be scored (sorts last). Absent entirely when no search was provided. Cross-comparable with list_content relevance_score."
},
"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 Marcora 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.
Semantic search (search)
Pass a natural-language search query to rank items by SEMANTIC relevance instead of recency — ranking is by each item's best-matching chunk. Each returned item then carries a relevance_score:
- Absent (field not present) — no
searchwas given; the list is ordered by recency. - A number (cosine similarity 0–1, higher = more relevant) — the item was scored against embeddings.
null— the item is not embedded yet and could not be scored; it sorts LAST.
Scores are cross-comparable with list_content. To find the best reference material across both context and content, call both tools with the SAME search, merge the results, and take the top matches by relevance_score. A typical flow: search → present the top matches to the user for confirmation → fetch full text with get_context_item / get_content → feed the chosen content content_ids into create_content's reference_content_ids to generate from them. reference_library_only composes with search.
Use search when the user asks to find or surface context by topic or meaning rather than browse the recency list.
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 projectlist_context_collections— items grouped by collectionget_relevant_context— returnscontext_item_idsof parent items for matched chunks
Example prompts:
- “What context items do I have in Marcora?”
- “Show me everything in my reference library”
- “List the context items I haven’t filed into a collection or project”
- “Find context about our competitors’ pricing”
Clients that previously read the bare array must now read response.context_items.
