Azure DevOps Remote MCP Server: Setup for VS Code, Cursor and Other Apps

• Lists your Azure DevOps organizations

  Shows the organizations your account can reach.

  Try: “Which Azure DevOps organizations do I have?”

  Read · core_list_orgs

• Lists projects

  Lists the projects in an organization.

  Try: “List the projects in Contoso.”

  Read · core_list_projects

• Lists teams in a project

  Lists the teams of one project.

  Try: “List teams in the Contoso project.”

  Read · core_list_project_teams

• Lists members of a group

  Lists direct members and child groups. Only in the Insiders preview.

  Try: “Who is in the Release Managers group?”

  Read · core_list_group_members

• Reads work items

  Gets work items by ID, your own items, comments, revisions, items in an iteration, and work item types.

  Try: “Show my open work items in the Contoso project.”

  Read · wit_work_item

• Runs saved work item queries

  Gets, searches, lists and runs saved queries.

  Try: “Run my saved query for open bugs.”

  Read · wit_query

• Runs a WIQL query

  Runs a query written in WIQL and returns the matching work items. Only in the Insiders preview.

  Try: “Find all bugs assigned to me that changed this week.”

  Read · wit_query_by_wiql

• Browses team backlogs

  Lists backlog levels and the work items inside them.

  Try: “List the work items in the Contoso team backlog.”

  Read · wit_backlog

• Searches work items by text

  Full-text search across work items.

  Try: “Search work items that mention payment timeout.”

  Read · search_workitem

• Creates and edits work items

  Creates work items, updates fields, updates many at once and adds child items.

  Try: “Create a bug called Login fails on Safari.”

  Write · wit_work_item_write

• Adds or edits work item comments

  Adds a comment to a work item or changes an existing one.

  Try: “Comment on work item 4521 that the fix is in review.”

  Write · wit_work_item_comment_write

• Links work items and code

  Links work items together, unlinks them, links a pull request, or adds a repo, branch, commit, build or wiki link.

  Try: “Link work item 4521 to pull request 88.”

  Write · wit_work_item_link_write

• Downloads a work item attachment

  Fetches an attachment by ID.

  Try: “Download the screenshot attached to work item 4521.”

  Read · wit_work_item_attachment

• Uploads a file for attaching

  Uploads file content up to 20 MB without attaching it yet.

  Try: “Upload this log file so I can attach it.”

  Write · wit_work_item_attachment_upload

• Attaches an uploaded file to a work item

  Links a file you uploaded earlier to a work item.

  Try: “Attach the uploaded log to work item 4521.”

  Write · wit_work_item_attachment_link

• Looks up repositories

  Gets one repository or lists repositories in a project.

  Try: “List the repos in the Contoso project.”

  Read · repo_repository

• Looks up branches

  Gets a branch, lists branches, or lists branches you pushed to.

  Try: “Which branches have I pushed to?”

  Read · repo_branch

• Reads files from a repo

  Gets file text at a branch, tag or commit, or lists a folder.

  Try: “Show README.md on the main branch of web-app.”

  Read · repo_file

• Searches commits

  Finds commits by text, author, date range and more.

  Try: “Find commits by Dana in the last two weeks.”

  Read · repo_search_commits

• Searches code

  Full-text code search across repos.

  Try: “Search the code for calls to getCustomer.”

  Read · search_code

• Reads pull requests

  Gets or lists pull requests, finds ones by commit, and shows file changes and diffs.

  Try: “What pull requests need my review?”

  Read · repo_pull_request

• Reads pull request comments

  Lists comment threads and the comments in a thread.

  Try: “Show the open comments on pull request 88.”

  Read · repo_pull_request_thread

• Creates and updates pull requests

  Creates or updates a pull request, changes reviewers and casts a vote.

  Try: “Open a pull request from fix-login into main.”

  Write · repo_pull_request_write

• Comments on pull requests

  Starts a thread, replies, or changes a thread's status.

  Try: “Reply to the first comment on PR 88 and resolve it.”

  Write · repo_pull_request_thread_write

• Creates a branch

  Creates a new branch in a repository.

  Try: “Create a branch called fix-login from main.”

  Write · repo_create_branch

• Reads builds

  Lists builds, gets status and issues, and shows commits and work items in a build.

  Try: “Did the last build of web-app pass?”

  Read · pipelines_build

• Reads build logs

  Lists the logs of a build and gets the text of one log.

  Try: “Show me the error in the last failed build log.”

  Read · pipelines_build_log

• Reads pipeline definitions

  Lists pipeline definitions and their revision history.

  Try: “List the pipelines in the Contoso project.”

  Read · pipelines_definition

• Reads pipeline runs

  Gets one run or lists the runs of a pipeline.

  Try: “List the last 5 runs of the deploy pipeline.”

  Read · pipelines_run

• Lists and downloads build artifacts

  Lists the artifacts of a build and downloads one by name.

  Try: “Download the test report artifact from build 1204.”

  Read · pipelines_artifact

• Runs and changes pipelines

  Queues a pipeline run, creates a YAML pipeline, or cancels, retries or runs a stage on a running build.

  Try: “Run the deploy pipeline on main.”

  Write · pipelines_write

• Reads wikis

  Lists wikis, gets a wiki, lists pages and gets page content.

  Try: “Show the Getting Started page in the team wiki.”

  Read · wiki

• Searches wikis

  Full-text search across wiki pages.

  Try: “Search the wiki for onboarding steps.”

  Read · search_wiki

• Creates or edits a wiki page

  Creates a wiki page or updates an existing one.

  Try: “Update the Getting Started page with the new setup steps.”

  Write · wiki_upsert_page

• Reads test plans

  Lists test plans, suites and test cases.

  Try: “List the test plans in Contoso.”

  Read · testplan

• Shows test results for a build

  Gets test results for a build.

  Try: “Which tests failed in build 1204?”

  Read · testplan_show_test_results_from_build_id

• Reads test run results

  Gets results for a test run, with optional filters.

  Try: “Show the failed results of test run 77.”

  Read · testplan_test_run

• Creates test plans

  Creates a test plan.

  Try: “Create a test plan called Release 5.”

  Write · testplan_test_plan_write

• Creates test suites

  Creates a suite or adds test cases to one.

  Try: “Add these test cases to the Login suite.”

  Write · testplan_test_suite_write

• Creates and edits test cases

  Creates a test case or updates its steps.

  Try: “Create a test case for password reset.”

  Write · testplan_test_case_write

• Records manual test runs

  Creates a run, updates results, completes or aborts a run, and updates test point outcomes.

  Try: “Mark test point 12 as passed.”

  Write · testplan_test_run_write

• Reads iterations and capacity

  Lists iterations, team settings and team capacity.

  Try: “What is the capacity of the Fabrikam team this iteration?”

  Read · work

• Creates and assigns iterations

  Creates iterations and assigns them to a team.

  Try: “Create a sprint called Sprint 24 for the Fabrikam team.”

  Write · work_iteration_write

• Updates team capacity

  Changes one team member's capacity for an iteration.

  Try: “Set Dana's capacity for Sprint 24 to 4 hours a day.”

  Write · work_capacity_write

• Reads Advanced Security alerts

  Lists alerts for a repository or gets one alert.

  Try: “List the open security alerts for web-app.”

  Read · advsec_alerts

• Reads repo migrations to GitHub

  Lists migrations, shows status, cutover review items, and pipeline rewiring. Preview feature.

  Try: “What is the migration status of web-app?”

  Read · enterprise_live_migration

• Manages repo migrations to GitHub

  Creates, pauses, resumes, schedules or cancels cutover, approves cutover, and can permanently delete a migration. Preview feature.

  Try: “Pause the web-app migration.”

  Delete · enterprise_live_migration_write

• Submits pipelines for migration

  Submits pipelines as part of a migration. Preview feature.

  Try: “Submit the build pipelines for migration.”

  Write · enterprise_live_migration_pipelines_write

Watch out for

• It can write to almost everything in Azure DevOps

  Write tools cover work items, pull requests, pipelines, wikis and test plans. Turn on the read-only header unless you need changes. learn.microsoft.com

• It can start pipelines and change branches

  It can queue a pipeline run, create a branch and cast a pull request vote. Require approval for tool calls in your assistant. learn.microsoft.com

• A repo migration can be deleted

  In the preview migration tools, an abandon action permanently deletes a migration. Exclude the migration group with the toolsets header if you do not use it. learn.microsoft.com

Security advisories