[FEATURE] Tool Call Limits for functions in a Custom MCP Server

Preflight Checklist

• [x] I have searched existing requests and this feature hasn't been requested yet
• [x] This is a single feature request (not multiple features)

Problem Statement

I often create agents with custom MCP's, and I want to limit the amount of times an agent can call a specific tool during its lifetime. I want the agent to know how many times its called the tool already and how many are left, so it can conserve tool calls accordingly. There is no good way to encourage the agent to think about a problem and the tools it has other than in the prompt. I don't like using the prompt because it isn't a hard enforcement of the rule.

Proposed Solution

I should be able to add an input to ClaudeAgentOptions similar to allowed_tools, but
[{"Read" : 10}, {"Glob" : 15}...] instead. It needs to work on tools defined via Custom MCP's.

Alternative Solutions

_No response_

Priority

High - Significant impact on productivity

Feature Category

MCP server integration

Use Case Example

_No response_

Additional Context

_No response_