claim_plan_step

What claim_plan_step does on Todos

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

Why claim_plan_step is rated Medium

The tool modifies task/plan state by claiming and starting a step, which changes data (ownership, status flags). This is Write rather than Execute because it doesn't directly run arbitrary code—it transitions workflow state. Severity is medium because misclaiming steps could block other agents or create workflow conflicts, but the impact is limited to task coordination and reversible.

From the tool's definition Tool name 'claim_plan_step' and description 'Claim and start the next ready plan step' indicate state modification—claiming a plan step changes its ownership/status from unclaimed to claimed, and 'start' implies initiating execution state.

The rule that runs claim_plan_step safely

PolicyLayer is an MCP gateway: it sits between your AI agents and Todos, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For claim_plan_step, this is the rule to start with:

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

Questions about claim_plan_step