The Azure DevOps connector lets your AI agent work with Azure DevOps. Scalekit handles authentication for every call, so your agent never handles credentials. It comes with 27 tools.
- Tools
- 27
- What they doRead · write · destructive
- 19 · 7 · 119 read7 write1 destructive
- Users sign in with
- Username and password
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Azure DevOps connection
In AgentKit > Connections, create an Azure DevOps connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_toolazuredevops_branches_listList the branches (refs) of a Git repository.Read-onlyList Branches
List the branches (refs) of a Git repository. Returns each ref's name (for example refs/heads/main), objectId (commit) and creator. Use this to find branch names for pull requests or commit history.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
repository_idstringrequired- Name or ID of the Git repository in the project. Example: fabrikam-web
continuation_tokenstring- Continuation token from the x-ms-continuationtoken header or continuationToken field of the previous page. Example: 5
filterstring- Only refs whose name starts with this, after refs/. Defaults to heads/ (branches); use tags/ for tags. Example: heads/feature/default
heads/ filter_containsstring- Only refs whose name contains this text. Example: login
topinteger- Maximum number of refs to return. Example: 100
azuredevops_commits_listList commits in a Git repository, newest first, optionally on one branch, by author, for a path or in a date range.Read-onlyList Commits
List commits in a Git repository, newest first, optionally on one branch, by author, for a path or in a date range. Returns each commit's commitId, comment, author, committer and changeCounts. Use this to review recent changes.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
repository_idstringrequired- Name or ID of the Git repository in the project. Example: fabrikam-web
authorstring- Only commits by this author (name or email). Example: alex@fabrikam.com
branchstring- Branch name to list commits from, without refs/heads/. Defaults to the default branch. Example: main
from_datestring- Only commits after this date. Example: 2026-11-01T00:00:00Z
item_pathstring- Only commits that touched this file or folder path. Example: /src/login
skipinteger- Number of commits to skip, for paging. Example: 50
to_datestring- Only commits before this date. Example: 2026-11-15T00:00:00Z
topinteger- Maximum number of commits to return. Example: 50
azuredevops_file_getGet a file's metadata and content from a Git repository, at a branch, tag or commit.Read-onlyGet File
Get a file's metadata and content from a Git repository, at a branch, tag or commit. Returns the item's path, objectId, commitId and content (text files) as JSON. Use this to read source files or docs from a repository.
Inputs
pathstringrequired- Path of the file in the repository, starting with /. Example: /README.md
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
repository_idstringrequired- Name or ID of the Git repository in the project. Example: fabrikam-web
versionstring- Branch name, tag or commit ID to read from. Defaults to the default branch. Example: main
version_typestring- What version is: branch, tag or commit. Defaults to branch. Example: branchone of
branchtagcommit
azuredevops_pipeline_run_getGet one run of a pipeline.Read-onlyGet Pipeline Run
Get one run of a pipeline. Returns its state (inProgress, completed), result (succeeded, failed, canceled), resources, templateParameters and dates. Use this to follow a run started with azuredevops_pipeline_run.
Inputs
pipeline_idintegerrequired- ID of the pipeline. Get it from azuredevops_pipelines_list. Example: 12
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
run_idintegerrequired- ID of the run. Example: 1201
azuredevops_pipeline_runs_listList the most recent runs of a pipeline (up to 10,000).Read-onlyList Pipeline Runs
List the most recent runs of a pipeline (up to 10,000). Returns each run's id, name, state, result, createdDate and finishedDate. Use this to check recent results. Use azuredevops_pipeline_run_get for one run.
Inputs
pipeline_idintegerrequired- ID of the pipeline. Get it from azuredevops_pipelines_list. Example: 12
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
azuredevops_pipelines_listList the pipelines in an Azure DevOps project.Read-onlyList Pipelines
List the pipelines in an Azure DevOps project. Returns each pipeline's id, name, folder and revision. Use this to find a pipeline_id. Use azuredevops_pipeline_runs_list for its run history.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
continuation_tokenstring- Continuation token from the x-ms-continuationtoken header or continuationToken field of the previous page. Example: 5
order_bystring- Sort expression. Example: name asc
topinteger- Maximum number of pipelines to return. Example: 100
azuredevops_project_getGet one Azure DevOps project by name or ID.Read-onlyGet Project
Get one Azure DevOps project by name or ID. Returns the project's id, name, description, state, visibility and default team; with include_capabilities, also its process template and version control type. Use this when you know the project. Use azuredevops_projects_list to browse.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
include_capabilitiesboolean- Include the process template and source control capabilities. Example: true
azuredevops_projects_listList the projects in the Azure DevOps organization.Read-onlyList Projects
List the projects in the Azure DevOps organization. Returns each project's id, name, description, state and visibility, plus a continuation token header when there are more. Use this to find a project name. Use azuredevops_project_get for one project's details.
Inputs
continuation_tokenstring- Continuation token from the x-ms-continuationtoken header or continuationToken field of the previous page. Example: 5
skipinteger- Number of projects to skip, for paging. Example: 50
state_filterstring- Only return projects in this state: wellFormed (default), createPending, deleting, new or all. Example: wellFormedone of
wellFormedcreatePendingdeletingnewall topinteger- Maximum number of projects to return. Example: 100
azuredevops_pull_request_getGet one pull request in a Git repository.Read-onlyGet Pull Request
Get one pull request in a Git repository. Returns its title, description, status, mergeStatus, sourceRefName, targetRefName, reviewers and votes, and optionally linked work items and commits. Use this for one pull request's details. Use azuredevops_pull_request_threads_list for its comments.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
pull_request_idintegerrequired- ID of the pull request. Example: 17
repository_idstringrequired- Name or ID of the Git repository in the project. Example: fabrikam-web
include_commitsboolean- Include the pull request's commits. Example: false
include_work_item_refsboolean- Include the linked work items. Example: true
azuredevops_pull_request_threads_listList the comment threads on a pull request.Read-onlyList Pull Request Threads
List the comment threads on a pull request. Returns each thread's id, status, threadContext (file and line, for code comments) and comments with author and content. Use this to read review feedback. Use azuredevops_pull_request_thread_create to comment.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
pull_request_idintegerrequired- ID of the pull request. Example: 17
repository_idstringrequired- Name or ID of the Git repository in the project. Example: fabrikam-web
azuredevops_pull_requests_listList pull requests in a Git repository, filtered by status, branch, creator or reviewer.Read-onlyList Pull Requests
List pull requests in a Git repository, filtered by status, branch, creator or reviewer. Returns each pull request's pullRequestId, title, status, createdBy, sourceRefName, targetRefName, reviewers and isDraft. Use this to browse pull requests. Use azuredevops_pull_request_get for one.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
repository_idstringrequired- Name or ID of the Git repository in the project. Example: fabrikam-web
creator_idstring- Only pull requests created by this user ID. Example: d6245f20-2af8-44f4-9451-8107cb2767db
reviewer_idstring- Only pull requests with this reviewer ID. Example: d6245f20-2af8-44f4-9451-8107cb2767db
skipinteger- Number of pull requests to skip, for paging. Example: 50
source_ref_namestring- Only pull requests from this branch. Example: refs/heads/feature/login
statusstring- Pull request status: active (default), completed, abandoned or all. Example: activeone of
activecompletedabandonedallnotSet target_ref_namestring- Only pull requests into this branch. Example: refs/heads/main
topinteger- Maximum number of pull requests to return. Example: 50
azuredevops_repositories_listList the Git repositories in an Azure DevOps project.Read-onlyList Repositories
List the Git repositories in an Azure DevOps project. Returns each repository's id, name, defaultBranch, remoteUrl, webUrl and size. Use this to find a repository. Use azuredevops_repository_get for one repository.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
azuredevops_repository_getGet one Git repository by name or ID.Read-onlyGet Repository
Get one Git repository by name or ID. Returns its id, name, defaultBranch, remoteUrl, webUrl, size and project. Use this when you know the repository. Use azuredevops_repositories_list to browse.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
repository_idstringrequired- Name or ID of the Git repository in the project. Example: fabrikam-web
azuredevops_teams_listList the teams in an Azure DevOps project.Read-onlyList Teams
List the teams in an Azure DevOps project. Returns each team's id, name and description. Use this to find a team name, for example for area paths or WIQL @currentIteration queries.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
mineboolean- Only return teams the user belongs to. Example: true
skipinteger- Number of teams to skip, for paging. Example: 50
topinteger- Maximum number of teams to return. Example: 100
azuredevops_work_item_comments_listList the discussion comments on an Azure DevOps work item.Read-onlyList Work Item Comments
List the discussion comments on an Azure DevOps work item. Returns each comment's id, text, createdBy and createdDate, plus a continuationToken. Use this to read the discussion. Use azuredevops_work_item_comment_add to post one.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
work_item_idintegerrequired- ID of the work item. Example: 42
continuation_tokenstring- Continuation token from the x-ms-continuationtoken header or continuationToken field of the previous page. Example: 5
orderstring- Sort order by date: asc or desc. Example: descone of
ascdesc topinteger- Maximum number of comments to return. Example: 50
azuredevops_work_item_getGet one Azure DevOps work item by ID.Read-onlyGet Work Item
Get one Azure DevOps work item by ID. Returns its id, rev, fields and, with expand, its relations (parent, children, links) and _links. Use this for one item's full details. Use azuredevops_work_items_get for several at once.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
work_item_idintegerrequired- ID of the work item. Example: 42
expandstring- Extra data to include: none, relations, fields, links or all. Example: relationsone of
nonerelationsfieldslinksall
azuredevops_work_item_types_listList the work item types of an Azure DevOps project, such as Bug, Task or User Story.Read-onlyList Work Item Types
List the work item types of an Azure DevOps project, such as Bug, Task or User Story. Returns each type's name, referenceName, description, states and fields. Use this to find the exact type name and field names before azuredevops_work_item_create.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
azuredevops_work_items_getGet up to 200 work items by ID in one call.Read-onlyGet Work Items
Get up to 200 work items by ID in one call. Returns each work item's id, rev and fields (title, state, assigned to, and so on). Use this after azuredevops_work_items_query. Use azuredevops_work_item_get for one item with its relations.
Inputs
idsstringrequired- Comma-separated work item IDs, at most 200. Example: 42,43,57
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
error_policystring- fail (default) stops on a missing ID; omit returns null for it instead. Example: omitone of
failomit fieldsstring- Comma-separated field reference names to return. Cannot be combined with expand. Example: System.Id,System.Title,System.State,System.AssignedTo
azuredevops_work_items_queryFind work items with a WIQL query, such as all active bugs assigned to me.Read-onlyQuery Work Items (WIQL)
Find work items with a WIQL query, such as all active bugs assigned to me. Returns the matching work item IDs (and URLs) in workItems, not their fields. Use this to search. Then pass the IDs to azuredevops_work_items_get to read the fields.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
querystringrequired- WIQL query text. Example: SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @project AND [System.State] = 'Active' AND [System.AssignedTo] = @me ORDER BY [System.ChangedDate] DESC
topinteger- Maximum number of work items to return. Example: 200
azuredevops_pipeline_runStart a run of a pipeline, optionally on a specific branch and with template parameters or variables.WriteRun Pipeline
Start a run of a pipeline, optionally on a specific branch and with template parameters or variables. Returns the new run with its id and state. Use this to trigger a build or deployment. Use azuredevops_pipeline_run_get to follow it. Set preview_run to only render the final YAML.
Inputs
pipeline_idintegerrequired- ID of the pipeline. Get it from azuredevops_pipelines_list. Example: 12
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
branchstring- Branch of the pipeline's own repository to run, as a full ref. Example: refs/heads/main
preview_runboolean- Do not start a run; only return the final YAML. Example: false
template_parametersobject- Values for the pipeline's runtime parameters. Example: {"environment": "staging"}
variablesobject- Values for variables marked settable at queue time, keyed by name. Example: {"logLevel": "debug"}
azuredevops_pull_request_createOpen a pull request from one branch into another in a Git repository.WriteCreate Pull Request
Open a pull request from one branch into another in a Git repository. Returns the new pull request with its pullRequestId and URL. Use this to propose changes. Use azuredevops_pull_request_update to complete, abandon or edit it.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
repository_idstringrequired- Name or ID of the Git repository in the project. Example: fabrikam-web
source_ref_namestringrequired- Branch with the changes, as a full ref. Example: refs/heads/feature/login
target_ref_namestringrequired- Branch to merge into, as a full ref. Example: refs/heads/main
titlestringrequired- Title of the pull request. Example: Fix Safari login
descriptionstring- Description in Markdown. Example: Fixes AB#42
is_draftboolean- Create as a draft pull request. Example: false
reviewer_idsarray- User or group IDs to add as reviewers. Example: ["d6245f20-2af8-44f4-9451-8107cb2767db"]
work_item_idsarray- Work item IDs to link. Example: ["42"]
azuredevops_pull_request_thread_createStart a comment thread on a pull request, either general or on a line of a file.WriteComment on Pull Request
Start a comment thread on a pull request, either general or on a line of a file. Returns the new thread with its id and first comment. Use this to leave review feedback. Use azuredevops_pull_request_threads_list to read existing threads.
Inputs
contentstringrequired- Comment text in Markdown. Example: Please add a test for Safari.
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
pull_request_idintegerrequired- ID of the pull request. Example: 17
repository_idstringrequired- Name or ID of the Git repository in the project. Example: fabrikam-web
file_pathstring- File to comment on, starting with /. Omit for a general comment. Example: /src/login.ts
lineinteger- Line number in the new version of the file (needs file_path). Example: 27
statusstring- Thread status: active (default), fixed, wontFix, closed, byDesign or pending. Example: activeone of
activefixedwontFixclosedbyDesignpendingdefaultactive
azuredevops_pull_request_updateUpdate a pull request: edit its title or description, publish a draft, abandon or reactivate it, or complete (merge) it.WriteUpdate Pull Request
Update a pull request: edit its title or description, publish a draft, abandon or reactivate it, or complete (merge) it. Returns the updated pull request. Use this to change or merge a pull request. To complete it, set status to completed and pass last_merge_source_commit_id from azuredevops_pull_request_get.
- Idempotent
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
pull_request_idintegerrequired- ID of the pull request. Example: 17
repository_idstringrequired- Name or ID of the Git repository in the project. Example: fabrikam-web
delete_source_branchboolean- Delete the source branch after completing. Example: true
descriptionstring- New description in Markdown. Example: Fixes AB#42 and AB#43
is_draftboolean- Set to false to publish a draft pull request. Example: false
last_merge_source_commit_idstring- Required when status is completed: the source branch commit the merge is based on, from lastMergeSourceCommit.commitId of azuredevops_pull_request_get. Example: 6c5b0bb3d7f9e7b5f0a3c2c1e1f3b5a8d9e0f1a2
merge_strategystring- How to merge when completing: noFastForward, squash, rebase or rebaseMerge. Example: squashone of
noFastForwardsquashrebaserebaseMerge statusstring- New status: active (reactivate), abandoned or completed (merge). Example: completedone of
activeabandonedcompleted titlestring- New title. Example: Fix Safari login (v2)
azuredevops_work_item_comment_addPost a discussion comment on an Azure DevOps work item.WriteAdd Work Item Comment
Post a discussion comment on an Azure DevOps work item. Returns the new comment with its id. Use this to comment. Use azuredevops_work_item_update to change fields.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
textstringrequired- Comment text, in Markdown or HTML according to format. Example: Reproduced on Safari 17.1
work_item_idintegerrequired- ID of the work item. Example: 42
formatstring- Format of the text: markdown or html. Defaults to markdown. Example: markdownone of
markdownhtmldefaultmarkdown
azuredevops_work_item_createCreate a work item, such as a bug, task or user story, in an Azure DevOps project.WriteCreate Work Item
Create a work item, such as a bug, task or user story, in an Azure DevOps project. Returns the new work item with its id and fields. Use this to file new work. Use azuredevops_work_item_update to change an existing item.
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
titlestringrequired- Title of the work item. Example: Login button does nothing on Safari
work_item_typestringrequired- Work item type to create, as named in the project's process. Example: Bug
fieldsobject- Work item fields to set, as an object keyed by field reference name. Common fields: System.Title, System.Description (HTML), System.State, System.AssignedTo (user email), System.AreaPath, System.IterationPath, System.Tags (semicolon-separated) and Microsoft.VSTS.Common.Priority (1-4). Example: {"System.Description": "<p>Steps to reproduce...</p>", "Microsoft.VSTS.Common.Priority": 2, "System.Tags": "web; login"}
parent_urlstring- URL of a parent work item to link to. Example: https://dev.azure.com/fabrikam/_apis/wit/workItems/40
validate_onlyboolean- Only check the request without saving the work item. Example: false
azuredevops_work_item_updateUpdate fields of an Azure DevOps work item, such as its state, assignee or title, and optionally add a discussion comment.WriteUpdate Work Item
Update fields of an Azure DevOps work item, such as its state, assignee or title, and optionally add a discussion comment. Returns the updated work item. Use this to change an item. Use azuredevops_work_item_comment_add to only post a comment.
- Idempotent
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
work_item_idintegerrequired- ID of the work item. Example: 42
commentstring- Comment added to the work item's discussion history with this change. Example: Fixed in PR 17
fieldsobject- Work item fields to set, as an object keyed by field reference name. Common fields: System.Title, System.Description (HTML), System.State, System.AssignedTo (user email), System.AreaPath, System.IterationPath, System.Tags (semicolon-separated) and Microsoft.VSTS.Common.Priority (1-4). Example: {"System.State": "Resolved", "System.AssignedTo": "alex@fabrikam.com"}
parent_urlstring- URL of a parent work item to link to. Example: https://dev.azure.com/fabrikam/_apis/wit/workItems/40
titlestring- New title. Example: Login button does nothing on Safari 17
azuredevops_work_item_deleteDelete an Azure DevOps work item by moving it to the recycle bin.DestructiveDelete Work Item
Delete an Azure DevOps work item by moving it to the recycle bin. Returns the deleted work item reference. Use this to remove an item; it can be restored from the recycle bin. Use azuredevops_work_item_update to close it instead.
- Idempotent
Inputs
projectstringrequired- Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
work_item_idintegerrequired- ID of the work item. Example: 42
No tools match.