Azure DevOps MCP Server

search_work_items

Search for work items across Azure DevOps projects using filters, sorting, and faceting for precise results.

Instructions

Search for work items across projects in Azure DevOps

Input Schema

NameRequiredDescriptionDefault
filtersNoOptional filters to narrow search results
includeFacetsNoWhether to include faceting in results (default: true)
orderByNoOptions for sorting search results
projectIdYesThe ID or name of the project to search in
searchTextYesThe text to search for in work items
skipNoNumber of results to skip for pagination (default: 0)
topNoNumber of results to return (default: 100, max: 1000)

Input Schema (JSON Schema)

{ "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "filters": { "additionalProperties": false, "description": "Optional filters to narrow search results", "properties": { "System.AreaPath": { "description": "Filter by area paths", "items": { "type": "string" }, "type": "array" }, "System.AssignedTo": { "description": "Filter by assigned users", "items": { "type": "string" }, "type": "array" }, "System.State": { "description": "Filter by work item states (New, Active, Closed, etc.)", "items": { "type": "string" }, "type": "array" }, "System.TeamProject": { "description": "Filter by project names", "items": { "type": "string" }, "type": "array" }, "System.WorkItemType": { "description": "Filter by work item types (Bug, Task, User Story, etc.)", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "includeFacets": { "default": true, "description": "Whether to include faceting in results (default: true)", "type": "boolean" }, "orderBy": { "description": "Options for sorting search results", "items": { "additionalProperties": false, "properties": { "field": { "description": "Field to sort by", "type": "string" }, "sortOrder": { "description": "Sort order (ASC/DESC)", "enum": [ "ASC", "DESC" ], "type": "string" } }, "required": [ "field", "sortOrder" ], "type": "object" }, "type": "array" }, "projectId": { "description": "The ID or name of the project to search in", "type": "string" }, "searchText": { "description": "The text to search for in work items", "type": "string" }, "skip": { "default": 0, "description": "Number of results to skip for pagination (default: 0)", "minimum": 0, "type": "integer" }, "top": { "default": 100, "description": "Number of results to return (default: 100, max: 1000)", "maximum": 1000, "minimum": 1, "type": "integer" } }, "required": [ "searchText", "projectId" ], "type": "object" }

You must be authenticated.

Other Tools from Azure DevOps MCP Server

Related Tools

ID: vbqbnnzcdd