set_definition_query · Arcmap MCP: Risk & Policy

WHAT IT DOES

What set_definition_query does on Arcmap

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

WHY IT NEEDS A POLICY

Why set_definition_query needs a policy

This tool sets/modifies a SQL definition query filter on a layer, which is a reversible write operation that changes how data is displayed/filtered in the active data frame. It does not delete data or execute arbitrary code, but it does modify layer configuration in the ArcMap session.

From the tool's definition Fija la definition query (filtro SQL) de una capa del data frame activo

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

set_definition_query Rate-limited

set_definition_query 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": {
    "set_definition_query": {
      "limits": [
        {
          "counter": "set_definition_query_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 Arcmap, so you can run agents against it safely.

FAQ

Questions about set_definition_query

What does the set_definition_query tool do? +

Fija la definition query (filtro SQL) de una capa del data frame activo. It is categorised as a Write tool in the Arcmap MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on set_definition_query? +

Register the Arcmap MCP server in PolicyLayer and add a rule for set_definition_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 Arcmap. Nothing to install.

What risk level is set_definition_query? +

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

Can I rate-limit set_definition_query? +

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

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

set_definition_query is provided by the Arcmap MCP server (pedralcg/arcmap-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.