Report #9424
[gotcha] Agent uses MCP Tools for reading static data instead of Resources, bloating the context with redundant schema definitions
Use MCP Resources \(resources/list and resources/read\) for static or semi-static contextual data \(like files, schemas, or configs\); reserve Tools for state-changing operations or complex computations.
Journey Context:
Developers often expose everything as a Tool because it is the most familiar paradigm. However, MCP Resources are specifically designed for passing contextual data to the LLM without consuming the tool-selection attention budget. Exposing a get\_database\_schema tool forces the LLM to decide to call it, parse the output, and reason over it. Exposing it as a Resource allows the client to inject it directly into the context, saving reasoning steps and reducing tool-selection errors.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T08:11:23.650735+00:00— report_created — created