// MCP TOOL REFERENCE

AZURE BOARDS MCP TOOLS

52 tools from the Azure Boards MCP MCP Server, categorised by risk level.

// ALL 52 AZURE BOARDS MCP TOOLS

READ 44 tools

Read check_permissions Check what your PAT token is allowed to do — probes work items, builds, releases, repos, and boards and ret... Read get_backlog Get backlog items for a team at a specific level (default: Stories/Requirements). Read get_board Get board details including columns, item limits, and state-to-column mappings. Read get_build Get full details of a specific build run including timing and requester. Read get_build_log_content Fetch the raw text content of a specific build log. Read get_build_logs List log files available for a build (each log has an ID you can fetch content for). Read get_build_timeline Get the stage/job/step timeline of a build to see which steps passed or failed. Read get_current_iteration Get the currently active sprint for a team. Read get_my_profile Get the authenticated user Read get_project_info Get project details including the process template (Agile/Scrum/CMMI) and VCS type. Read get_pull_request Get full details of a pull request including reviewers and their votes. Read get_release Get full details of a specific release including all environment deployment statuses. Read get_release_definition Get full details of a release pipeline definition. Read get_repository Get full details of a repository by ID or name. Read get_team_members List members of a team including team admin status. Read get_work_item Get full details of a work item by ID, including all fields, relations, and links. Read get_work_item_children Get all direct child work items of a parent (hierarchy-forward links). Read get_work_item_history Get full revision history of a work item — every field change with old/new values and timestamps. Read get_work_item_type_fields Get all fields for a specific work item type, including which are required, their allowed values, and defau... Read get_work_item_type_states Get valid states for a work item type (e.g. New, Active, Resolved, Closed) including their colours and cate... Read list_all_fields List every field defined in the project (reference name, type, required, read-only). Useful for building cu... Read list_area_paths List all area paths in the project (flattened tree). Use these values for areaPath when creating work items. Read list_backlog_levels List available backlog levels for a team (e.g. Epics, Stories, Tasks). Read list_boards List all boards for a team. Read list_branches List all branches in a repository with ahead/behind counts relative to the default branch. Read list_builds List build runs. Filter by pipeline, branch, status (inProgress, completed, …), or result (succeeded, faile... Read list_comments List all discussion comments on a work item. Read list_commits List recent commits in a repository. Optionally filter by branch. Read list_iteration_paths List all iteration paths in the project (sprints, releases). Use these for iterationPath when creating work... Read list_iterations List all sprints/iterations for a team with start/end dates and timeframe (current/past/future). Read list_pipelines List all CI/CD pipelines defined in the project. Read list_projects List all Azure DevOps projects the PAT has access to in this organization. Read list_pull_requests List pull requests in a repository filtered by status. Read list_recent_work_items List the most recently updated work items in the project, optionally filtered by type. Read list_release_definitions List all release pipeline definitions with their environments. Read list_releases List release instances with environment deployment statuses. Filter by definition, status, or top N. Read list_repositories List all Git repositories in the project with remote URLs, default branch, and size. Read list_teams List all teams in the project. Read list_work_item_types List all available work item types (Task, Bug, User Story, Epic, Feature, etc.) in the project. Read query_by_state List work items filtered by state (Active, New, Resolved, Closed, etc.) with optional work item type filter. Read query_current_sprint List all work items in the current active sprint / iteration. Read query_my_work_items List all open work items assigned to me (the authenticated user). Read query_wiql Execute a raw WIQL query for advanced filtering and custom reports. WIQL syntax: SELECT [System.Id] FROM Wo... Read search_work_items Full-text search across work item titles and descriptions. Supports optional type, state, and assignee filt...

WRITE 5 tools

Write add_comment Add a discussion comment to a work item. Write create_release Create (trigger) a new release from a release definition. Write create_work_item Create a work item (Task, Bug, User Story, Epic, Feature, etc.). Supports story points, estimates, acceptan... Write link_work_items Create a link between two work items. Common link types: System.LinkTypes.Hierarchy-Reverse (parent), Syste... Write update_work_item Update a work item — change title, state, assignee, priority, sprint, story points, estimates, tags, accept...

DESTRUCTIVE 2 tools

Destructive cancel_build Cancel a running build. Destructive delete_work_item Delete a work item. Moves to recycle bin by default; set destroy=true to permanently delete.

EXECUTE 1 tools

Execute queue_build Trigger (queue) a pipeline run. Optionally specify branch and pipeline variables.

// RUNNING THIS SERVER

The managed route: connect Azure Boards MCP through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y azure-board-mcp

// FAQ

How many tools does the Azure Boards MCP MCP server have? +

The Azure Boards MCP MCP server exposes 52 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Azure Boards MCP tools? +

Route the Azure Boards MCP server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Azure Boards MCP tools fall into? +

Azure Boards MCP tools are categorised as Read (44), Write (5), Destructive (2), Execute (1). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.