cosmosdb_item_replace · Azure MCP Server MCP: Risk & Policy

WHAT IT DOES

What cosmosdb_item_replace does on Azure MCP Server

AI agents use cosmosdb_item_replace to create or update resources in Azure MCP Server — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Azure MCP Server environment.

WHY IT NEEDS A POLICY

Why cosmosdb_item_replace needs a policy

The tool modifies data reversibly by replacing items in Cosmos DB. While 'replace' could potentially overwrite data, it is a standard update operation that can be undone via subsequent writes or backups, distinguishing it from irreversible deletion.

From the tool's definition Tool name 'cosmosdb_item_replace' and description 'Replace an item in a Cosmos DB container' indicate modification of existing data in a database.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

cosmosdb_item_replace Rate-limited

cosmosdb_item_replace stays usable, but capped — an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "cosmosdb_item_replace": {
      "limits": [
        {
          "counter": "cosmosdb_item_replace_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

LIMIT THIS TOOL →

Instant setup, no code required.

PolicyLayer is an MCP gateway: every tool call is checked against your rule before it reaches Azure MCP Server, so you can run agents against it safely.

FAQ

Questions about cosmosdb_item_replace

What does the cosmosdb_item_replace tool do? +

Replace an item in a Cosmos DB container. It is categorised as a Write tool in the Azure MCP Server MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on cosmosdb_item_replace? +

Register the Azure MCP Server MCP server in PolicyLayer and add a rule for cosmosdb_item_replace: 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 MCP Server. Nothing to install.

What risk level is cosmosdb_item_replace? +

cosmosdb_item_replace is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit cosmosdb_item_replace? +

Yes. Add a rate_limit block to the cosmosdb_item_replace 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 cosmosdb_item_replace completely? +

Set action: deny in the PolicyLayer policy for cosmosdb_item_replace. 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 cosmosdb_item_replace? +

cosmosdb_item_replace is provided by the Azure MCP Server MCP server (mashriram/azure_mcp_server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.