MCP Tools
Content

list_content

List all content documents visible to you as a single unified array, whether created from scratch or from a blueprint. Use a content_id to fetch full content or to create a share link. Pass a `search` query to sort results by similarity instead of recency; search only re-orders and drops nothing.

Input Schema

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "description": "Optional natural-language query. When provided, every visible row is scored by similarity to it and the list is sorted by that score instead of recency; each row gains a relevance_score. Nothing is dropped, so the response is still all of the team's content. Omit or leave empty for the normal recency-ordered list."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "content"
  ],
  "properties": {
    "content": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "content_id"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Content name."
          },
          "stage": {
            "type": "string",
            "description": "in_progress or ready."
          },
          "web_url": {
            "type": "string",
            "description": "Direct URL to view this content in Marcora."
          },
          "category": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              }
            },
            "description": "{id, name} or null if uncategorized."
          },
          "projects": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Project names this content belongs to."
          },
          "content_id": {
            "type": "string",
            "format": "uuid",
            "description": "Content identifier."
          },
          "created_by": {
            "type": "string",
            "description": "Name of the creator."
          },
          "visibility": {
            "type": "string",
            "description": "private or team."
          },
          "relevance_score": {
            "type": [
              "number",
              "null"
            ],
            "description": "Present only when a `search` query was given. Cosine similarity (0–1; higher = more similar) of the row to the query."
          }
        }
      }
    }
  }
}

Instructions

Lists the team's content that the current user can see, as a single unified array with consistent field names, newest first. Use it to browse and filter the team's content and to find content IDs. The same content_id can be passed to get_content, update_content, and create_external_share.

Optional search: pass a natural-language query to sort the list by similarity instead of recency; each row then carries a relevance_score (cosine 0–1, higher = more similar). Search only re-orders: every visible row is still returned, with no cutoff. To find passages in the reference library that are relevant to a question, use get_relevant_context.

Example prompts

  • "Show me all my content"
  • "List my documents"
  • "What content have I created?"
  • "Find my content about onboarding emails"

Clients that previously read the bare array must now read response.content.

Scroll to Top