workitem.query

Searches work items using Work Item Query Language (WIQL) and returns batch details.

Server Azure DevOps MCP Server varnierg/mcp-for-azure-devops
Category Read
Risk class Low
Parameters 00 required

What workitem.query does on Azure DevOps MCP Server

AI agents call workitem.query to retrieve information from Azure DevOps MCP Server without modifying anything — typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

Why workitem.query needs a policy

This tool performs a search and retrieval operation against work items in Azure DevOps. It queries existing data and returns results without creating, modifying, deleting, or executing any operations. This is a classic Read operation with minimal blast radius—an agent could retrieve unwanted information but cannot cause irreversible harm or financial impact.

From the tool's definition Tool description states it 'Searches work items' and 'returns batch details' using WIQL, which is a query language for retrieval. The verb 'Searches' and 'returns' indicate data retrieval with no modification or side effects.

Questions about workitem.query

What does the workitem.query tool do? +

Searches work items using Work Item Query Language (WIQL) and returns batch details. It is categorised as a Read tool in the Azure DevOps MCP Server MCP Server, which means it retrieves data without modifying state.

How do I enforce a policy on workitem.query? +

Register the Azure DevOps MCP Server MCP server in PolicyLayer and add a rule for workitem.query: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Azure DevOps MCP Server. Nothing to install.

What risk level is workitem.query? +

workitem.query is a Read tool with low risk. Read-only tools are generally safe to allow by default.

Can I rate-limit workitem.query? +

Yes. Add a rate_limit block to the workitem.query rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block workitem.query completely? +

Set action: deny in the PolicyLayer policy for workitem.query. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides workitem.query? +

workitem.query is provided by the Azure DevOps MCP Server MCP server (varnierg/mcp-for-azure-devops). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.