# Too Many Tool Calls

## Ontology Metadata

Code: ISS-0061
Version: ISS-0061@0.1.0
Ontology release: 0.1.0
Updated: 2026-05-10T00:00:00Z
Canonical URL: /workbench/issues/too-many-tool-calls/

## Summary

The AI or agent makes more tool calls, searches, retrievals, API calls, or integration actions than the task requires or permits.

## Category

- CAT-0040 — MCP, Tools & Integrations
  - URL: /workbench/categories/mcp-tools-and-integrations/
  - Summary: Problems involving tool calls, MCP surfaces, integration contracts, required tool inputs, tool results, parser consumers, or downstream systems that depend on AI output.

## Primary Pattern

- PAT-0400 — Unbounded Scope
  - URL: /workbench/patterns/unbounded-scope/
  - Summary: A structural condition where an operation, authority, rule, or expansion has no declared upper bound, boundary, or termination condition.

## Declared Patterns

- PAT-0400 — Unbounded Scope
  - URL: /workbench/patterns/unbounded-scope/
  - Summary: A structural condition where an operation, authority, rule, or expansion has no declared upper bound, boundary, or termination condition.
- PAT-0300 — Escalation Growth
  - URL: /workbench/patterns/escalation-growth/
  - Summary: A structural condition where impact, authority, scope, or consequence increases across sequential states without a declared limiting mechanism.
- PAT-0340 — Overreach
  - URL: /workbench/patterns/overreach/
  - Summary: A structural condition where actions, effects, authority, or modifications extend beyond declared scope without authorization.

## Derived Primary Lenses

- LEN-0120 — Boundary Compliance Lens
  - URL: /workbench/lenses/boundary-compliance-lens/
  - Summary: Evaluates observed structure against declared boundary posture, including allow, block, and exception rules.
- LEN-0160 — Constraint Sufficiency Lens
  - URL: /workbench/lenses/constraint-sufficiency-lens/
  - Summary: Evaluates whether declared constraints are sufficient to eliminate structural degrees of freedom.
- LEN-0190 — Escalation Gradient Lens
  - URL: /workbench/lenses/escalation-gradient-lens/
  - Summary: Measures structural growth or intensification across sequential executions, states, or transitions.
- LEN-0220 — Isolation Boundary Lens
  - URL: /workbench/lenses/isolation-boundary-lens/
  - Summary: Evaluates whether structural constraints, effects, and regions remain contained within declared boundaries.
- LEN-0240 — Overreach Lens
  - URL: /workbench/lenses/overreach-lens/
  - Summary: Detects structure that exceeds declared scope or authority reach.
- LEN-0290 — Variance / Entropy Lens
  - URL: /workbench/lenses/variance-entropy-lens/
  - Summary: Measures structural variability across repeated or comparable evaluations and identifies divergence beyond expected bounds.

## Derived Secondary Lenses

- LEN-0250 — Propagation Lens
  - URL: /workbench/lenses/propagation-lens/
  - Summary: Traces how structural declarations, effects, or state changes propagate across boundaries or stages.

## Search Intents

- too many tool calls
- AI called tools too many times
- agent keeps calling tools
- excessive MCP tool calls
- AI overuses search tools
- tool loop too many calls