Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Azure DevOps

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the Azure DevOps connection

    In AgentKit > Connections, create an Azure DevOps connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • azuredevops_branches_listList the branches (refs) of a Git repository.Read-only

    List 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-only

    List 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-only

    Get 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-only

    Get 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-only

    List 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-only

    List 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-only

    Get 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-only

    List 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