feat: Add list_vistas tool for listing DevRev vistas

- Add list_vistas tool definition with comprehensive input schema
- Implement handler with support for all API parameters
- Support filtering by type, flavor, state, created_by, members
- Include pagination support with cursor and mode parameters
- Add limit and sorting capabilities
- Enable default vista filtering and item skipping options

Author: Anoushka Kumar

src/devrev_mcp/server.py

@@ -46,6 +46,26 @@ async def handle_list_tools() -> list[types.Tool]:
                  "required": ["id"]
             },
          ),
+         types.Tool(
+            name="list_vistas",
+            description="List all available vistas (filtered views) from DevRev with optional filtering",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "type": {"type": "array", "items": {"type": "string", "enum": ["curated", "dynamic", "grouped"]}, "description": "Filters for vistas of the specific type"},
+                    "cursor": {"type": "string", "description": "The cursor to resume iteration from. If not provided, iteration begins from the first page"},
+                    "created_by": {"type": "array", "items": {"type": "string"}, "description": "Filters for vistas created by any of these users"},
+                    "flavor": {"type": "array", "items": {"type": "string", "enum": ["nnl", "sprint_board", "support_inbox"]}, "description": "Filters for vistas of specific flavor"},
+                    "is_default": {"type": "boolean", "description": "Whether the default vistas should be fetched or not"},
+                    "limit": {"type": "integer", "description": "The maximum number of vistas to return. The default is 50, the maximum is 100"},
+                    "members": {"type": "array", "items": {"type": "string"}, "description": "Filters for vistas accessible to the input members"},
+                    "mode": {"type": "string", "enum": ["after", "before"], "description": "The iteration mode to use. If 'after', then entries after the provided cursor will be returned. If 'before', then entries before the provided cursor will be returned"},
+                    "sort_by": {"type": "array", "items": {"type": "string"}, "description": "Fields to sort the vistas by and the direction to sort them"},
+                    "state": {"type": "array", "items": {"type": "string", "enum": ["active", "completed", "planned"]}, "description": "Denotes the state of the vista group item"},
+                    "skip_items": {"type": "boolean", "description": "Denotes whether to skip items of vista_group_item in response"}
+                }
+            },
+         ),
         types.Tool(
             name="search",
             description="Search DevRev using the provided query",
@@ -487,6 +507,77 @@ async def handle_call_tool(
             )
         ]
 
+    elif name == "list_vistas":
+        if not arguments:
+            arguments = {}
+
+        payload = {}
+
+        # Optional parameters from the API
+        vista_type = arguments.get("type")
+        if vista_type:
+            payload["type"] = vista_type
+
+        cursor = arguments.get("cursor")
+        if cursor:
+            payload["cursor"] = cursor
+
+        created_by = arguments.get("created_by")
+        if created_by:
+            payload["created_by"] = created_by
+
+        flavor = arguments.get("flavor")
+        if flavor:
+            payload["flavor"] = flavor
+
+        is_default = arguments.get("is_default")
+        if is_default is not None:
+            payload["is_default"] = is_default
+
+        limit = arguments.get("limit")
+        if limit:
+            payload["limit"] = limit
+
+        members = arguments.get("members")
+        if members:
+            payload["members"] = members
+
+        mode = arguments.get("mode")
+        if mode:
+            payload["mode"] = mode
+
+        sort_by = arguments.get("sort_by")
+        if sort_by:
+            payload["sort_by"] = sort_by
+
+        state = arguments.get("state")
+        if state:
+            payload["state"] = state
+
+        skip_items = arguments.get("skip_items")
+        if skip_items is not None:
+            payload["skip_items"] = skip_items
+
+        response = make_devrev_request(
+            "vistas.list",
+            payload
+        )
+
+        if response.status_code != 200:
+            error_text = response.text
+            return [
+                types.TextContent(
+                    type="text",
+                    text=f"List vistas failed with status {response.status_code}: {error_text}"
+                )
+            ]
+
+        return [
+            types.TextContent(
+                type="text",
+                text=f"Vistas listed successfully:\n{response.json()}"
+            )
+        ]
 
     elif name == "search":
         if not arguments: