@achieveai/azuredevops-mcp 1.2.0 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +28 -1
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -27,7 +27,7 @@ The integration is organized into eight main tool categories:
27
27
  - Add comments to work items
28
28
  - Update work item state
29
29
  - Assign work items
30
- - Create links between work items
30
+ - Create links between work items and artifacts (PRs, builds, branches, commits)
31
31
  - Bulk create/update work items
32
32
 
33
33
  ### Boards & Sprints Tools
@@ -406,6 +406,33 @@ Once the server is running, you can interact with it using the MCP protocol. The
406
406
  }
407
407
  ```
408
408
 
409
+ ### Example: Link a Work Item to a Pull Request
410
+
411
+ The `createLink` tool supports linking work items to other work items or artifacts using prefix notation in the `targetId` field:
412
+
413
+ | Prefix | Target Type | Example | Requires `repository`? |
414
+ |--------|------------|---------|----------------------|
415
+ | `PR#` | Pull Request | `PR#456` | Yes |
416
+ | `BUILD#` | Build | `BUILD#789` | No |
417
+ | `BRANCH#` | Branch | `BRANCH#main` | Yes |
418
+ | `COMMIT#` | Commit | `COMMIT#abc123` | Yes |
419
+ | `WI#` or plain number | Work Item | `WI#123` or `123` | No |
420
+
421
+ ```json
422
+ {
423
+ "tool": "createLink",
424
+ "params": {
425
+ "sourceId": 17086,
426
+ "targetId": "PR#10619",
427
+ "linkType": "System.LinkTypes.Related",
428
+ "repository": "MyRepo",
429
+ "comment": "Linked PR with fix"
430
+ }
431
+ }
432
+ ```
433
+
434
+ Artifact links are bidirectional -- the PR will appear on the work item's Links tab, and the work item will appear in the PR's Work Items section.
435
+
409
436
  ## Architecture
410
437
 
411
438
  The project is structured as follows:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@achieveai/azuredevops-mcp",
3
- "version": "1.2.0",
3
+ "version": "1.2.1",
4
4
  "main": "dist/index.js",
5
5
  "scripts": {
6
6
  "build": "tsc",