create_work_item
Create new Azure DevOps work items (Bugs, Tasks, User Stories) by applying JSON patch operations to define fields and properties.
Instructions
Create a new work item using JSON patch operations
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | Work item type (e.g., "Bug", "Task", "User Story") | |
| document | Yes | Array of JSON patch operations to apply |
Implementation Reference
- src/tools/work-item/create.ts:6-30 (handler)The main handler function `createWorkItem` that executes the tool logic: validates parameters, sets up Azure DevOps connection, creates the work item using the API, and formats the response as MCP content.export async function createWorkItem(args: { type: string; document: JsonPatchOperation[] }, config: AzureDevOpsConfig) { if (!args.type || !args.document || !args.document.length) { throw new McpError(ErrorCode.InvalidParams, 'Work item type and patch document are required'); } AzureDevOpsConnection.initialize(config); const connection = AzureDevOpsConnection.getInstance(); const workItemTrackingApi = await connection.getWorkItemTrackingApi(); const workItem = await workItemTrackingApi.createWorkItem( undefined, args.document, config.project, args.type ); return { content: [ { type: 'text', text: JSON.stringify(workItem, null, 2), }, ], }; }
- src/tools/work-item/index.ts:63-98 (schema)Input schema and metadata (name, description) for the 'create_work_item' tool.{ name: 'create_work_item', description: 'Create a new work item using JSON patch operations', inputSchema: { type: 'object', properties: { type: { type: 'string', description: 'Work item type (e.g., "Bug", "Task", "User Story")', }, document: { type: 'array', items: { type: 'object', properties: { op: { type: 'string', enum: ['add', 'remove', 'replace', 'move', 'copy', 'test'], description: 'The patch operation to perform', }, path: { type: 'string', description: 'The path for the operation (e.g., /fields/System.Title)', }, value: { description: 'The value for the operation', }, }, required: ['op', 'path'], }, description: 'Array of JSON patch operations to apply', }, }, required: ['type', 'document'], }, },
- src/tools/work-item/index.ts:137-144 (registration)Registers the `createWorkItem` handler within the `workItemTools` object, which is used by the MCP server for tool execution and provides definitions for listing tools.export const workItemTools = { initialize: (config: AzureDevOpsConfig) => ({ getWorkItem: (args: WorkItemBatchGetRequest) => getWorkItem(args, config), listWorkItems: (args: Wiql) => listWorkItems(args, config), createWorkItem: (args: { type: string; document: JsonPatchOperation[] }) => createWorkItem(args, config), updateWorkItem: (args: { id: number; document: JsonPatchOperation[] }) => updateWorkItem(args, config), definitions, }),
- src/index.ts:73-90 (registration)Top-level initialization of tool instances including workItemTools (which contains create_work_item), and combines definitions from all tool groups for MCP server registration.const toolInstances = { workItem: workItemTools.initialize(this.config), board: boardTools.initialize(this.config), wiki: wikiTools.initialize(this.config), project: projectTools.initialize(this.config), pipeline: pipelineTools.initialize(this.config), pullRequest: pullRequestTools.initialize(this.config), }; // Combine all tool definitions this.toolDefinitions = [ ...toolInstances.workItem.definitions, ...toolInstances.board.definitions, ...toolInstances.wiki.definitions, ...toolInstances.project.definitions, ...toolInstances.pipeline.definitions, ...toolInstances.pullRequest.definitions, ];