List Components

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Project ID (optional, uses session default if not provided)"
    },
    "query": {
      "type": "string",
      "description": "Natural language search query for semantic search. Uses AI-powered vector search to find relevant components based on meaning, not just keywords.",
      "minLength": 1,
      "maxLength": 500,
      "example": "layout for product listings"
    },
    "type": {
      "type": "string",
      "enum": ["view", "layout", "assetCatalog"],
      "description": "Filter by component type (optional)"
    },
    "status": {
      "type": "string",
      "enum": ["draft", "published", "deleted"],
      "default": "published",
      "description": "Filter by component status (optional)"
    },
    "collectionId": {
      "type": "string",
      "description": "Filter by collection ID (optional)"
    },
    "page": {
      "type": "number",
      "default": 1,
      "description": "Page number for paginated results (1-based indexing)"
    },
    "limit": {
      "type": "number",
      "default": 20,
      "maximum": 100,
      "description": "Maximum items to return per page"
    }
  }
}

{
  "query": "layout for product listings"
}

{
  "components": [
    {
      "id": "comp_product_layout_001",
      "name": "Product Listing Layout",
      "description": "Layout component for displaying product listings with grid or list view options",
      "type": "layout",
      "status": "published",
      "version": 2,
      "excerpt": "...Layout component for displaying product listings with grid or list view options...",
      "similarity": 0.94
    },
    {
      "id": "comp_product_grid_001",
      "name": "Product Grid",
      "description": "Grid layout for showcasing multiple products",
      "type": "layout",
      "status": "published",
      "version": 1,
      "excerpt": "...Grid layout for showcasing multiple products in a responsive grid...",
      "similarity": 0.87
    }
  ],
  "total": 2
}

{
  "type": "layout",
  "status": "published"
}

{
  "components": [
    {
      "id": "comp_product_layout_001",
      "name": "Product Listing Layout",
      "description": "Layout component for displaying product listings",
      "type": "layout",
      "status": "published",
      "version": 2
    },
    {
      "id": "comp_article_layout_001",
      "name": "Article Layout",
      "description": "Layout for long-form article content",
      "type": "layout",
      "status": "published",
      "version": 3
    }
  ],
  "total": 2
}

{
  "collectionId": "coll_marketing_001"
}

// List all view components
const views = await mcp.call("list_components", {
  type: "view"
});

// List all layout components
const layouts = await mcp.call("list_components", {
  type: "layout"
});

// Search for hero components within views
const result = await mcp.call("list_components", {
  query: "hero banner",
  type: "view"
});