Your MCP Servers Are Silently Draining Your Context Window: The Hidden Cost of Tool-Heavy AI Agents

I typed a two-word prompt—"Run tests"—into my AI coding agent, and my API billing dashboard immediately registered 28,400 input tokens. I had not attached a single source file. My conversation history was completely empty. Yet nearly 15% of my model's active context window evaporated before the LLM generated its first character.

The culprit wasn't a massive codebase index or a bloated system prompt. It was the seven Model Context Protocol (MCP) servers I had eagerly configured over the previous month.

Connecting GitHub, Jira, Postgres, Sentry, Slack, Docker, and filesystem MCP servers feels like giving your AI agent superpowers. What looks like a productivity upgrade in your config file quietly turns into a tax on every single turn of your conversation—degrading reasoning accuracy, slowing down time-to-first-token, and draining your token budget.

How Tool Definitions Hijack the Prompt

A common misconception is that MCP tools sit idle in the background until the model decides to call them. That is not how LLM tool calling works under the hood.

For an LLM to know when and how to invoke a tool, the host application must inject the complete JSON Schema definition of every single registered tool into the system context of every API request (via the tools parameter in the Anthropic Tool Use API or OpenAI Function Calling).

When you install an all-in-one MCP server—like a full GitHub or cloud provider integration—you rarely get just one or two tools. You get 30 to 60 distinct endpoints (create_issue, update_pull_request, list_workflow_runs, get_commit_status, etc.). Each tool carries:

• A verbose description explaining when to use it and when to avoid it.
• Nested JSON Schema objects defining every parameter, enum, and filter.
• Validation constraints and usage examples embedded in property descriptions.

The Anatomy of Schema Bloat

Let's look at a single, typical tool definition sent over the wire when using a comprehensive third-party MCP server:

{ "name": "search_project_issues_advanced", "description": "Search and filter project issues across repositories. Use this tool whenever the user asks about bugs, tasks, sprints, or ticket statuses. Supports pagination, sorting by creation or update date, and filtering by assignee, label, milestone, or state.", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "description": "Full-text search string matching issue title or body markdown." }, "state": { "type": "string", "enum": ["open", "closed", "all"], "description": "Filter issues by their current lifecycle state. Defaults to open." }, "labels": { "type": "array", "items": { "type": "string" }, "description": "List of exact label names to filter by (AND logic applied)." }, "sortBy": { "type": "string", "enum": ["created", "updated", "comments"], "description": "Field used to sort the returned issue list." } }, "required": ["query"] } } 

That single schema costs roughly 180–220 tokens. Now multiply that across a realistic developer setup:

1. GitHub MCP Server: ~35 tools (~8,500 tokens)
2. Issue Tracker / Docs MCP: ~25 tools (~6,200 tokens)
3. Database & Observability MCPs: ~20 tools (~4,800 tokens)
4. Browser / Filesystem / Git MCPs: ~25 tools (~5,500 tokens)

Before you even ask a question, 25,000 tokens of rigid JSON schemas are injected at the top of your prompt. And because agentic workflows operate in loops—reading a file, running a command, checking an error, editing a line—a 10-step task doesn't pay that 25,000-token penalty once. Even with prompt caching mitigating part of the dollar cost, the model's attention mechanism still has to attend to 250,000 tokens of cumulative schema noise across those 10 steps.

Context Rot and Tool Confusion

Paying for extra input tokens is annoying, but the real damage happens to your agent's intelligence:

1. Tool Selection Hallucinations: When an LLM is presented with 80+ overlapping tools (e.g., read_file, get_file_contents, inspect_repo_file, search_code), its ability to pick the right tool drops sharply. It starts passing parameters meant for one tool into another, or enters infinite retry loops due to schema validation errors.
2. Attention Dilution ("Lost in the Middle"): Every token spent describing a Jira sprint filter you never use competes for attention with your actual code, stack traces, and architectural rules.
3. Uncontrolled Output Dumps: Many monolithic MCP tools return raw, unpaginated API responses directly into the context window—dumping 15,000 tokens of raw JSON metadata when all you needed was a 3-line status summary.

Auditing Your MCP Token Tax in TypeScript

To see exactly how much context my tool definitions were eating, I wrote a zero-bloat TypeScript auditor that measures the serialized token footprint of tool schemas and compares a bloated multi-server setup against a minimal, focused toolkit.

You can run this script directly using Node.js native TypeScript execution (node --experimental-strip-types audit-tools.ts on Node 22.6+ or directly node audit-tools.ts on Node 23.6+):

// audit-tools.ts export interface ToolDefinition { name: string; description: string; inputSchema: Record<string, unknown>; } export interface AuditReport { toolCount: number; rawBytes: number; estimatedTokensPerTurn: number; tokensPer10StepLoop: number; } /** * Estimates LLM token usage for JSON schemas (~3.6 chars per token for structured JSON) * and calculates cumulative context pressure across multi-step agent loops. */ export function auditToolFootprint(tools: ToolDefinition[]): AuditReport { const serialized = JSON.stringify(tools); const rawBytes = Buffer.byteLength(serialized, "utf8"); const estimatedTokensPerTurn = Math.ceil(serialized.length / 3.6); return { toolCount: tools.length, rawBytes, estimatedTokensPerTurn, tokensPer10StepLoop: estimatedTokensPerTurn * 10, }; } // Simulate a bloated 45-tool MCP setup vs. a focused 3-tool micro-setup const bloatedSetup: ToolDefinition[] = Array.from({ length: 45 }, (_, i) => ({ name: `enterprise_integration_action_${i + 1}`, description: "Comprehensive enterprise integration endpoint supporting filtering, pagination, sorting, metadata expansion, and audit logging across workspaces.", inputSchema: { type: "object", properties: { workspaceId: { type: "string", description: "Target workspace UUID" }, filterQuery: { type: "string", description: "Lucene-compatible filter syntax" }, includeMetadata: { type: "boolean", description: "Include full audit trail" }, limit: { type: "number", description: "Max records to return (1-500)" }, cursor: { type: "string", description: "Pagination cursor from previous call" }, }, required: ["workspaceId", "filterQuery"], }, })); const microToolSetup: ToolDefinition[] = [ { name: "run_focused_check", description: "Run local project verification and return concise failure lines only.", inputSchema: { type: "object", properties: { scope: { type: "string", enum: ["types", "tests", "lint"] }, }, required: ["scope"], }, }, ]; console.table({ "Bloated MCP Stack (45 tools)": auditToolFootprint(bloatedSetup), "Focused Micro-Tool (1 tool)": auditToolFootprint(microToolSetup), }); 

Benchmark Results

When I compared my default "connect everything" profile against a stripped-down, task-specific workflow across 50 real debugging sessions, the difference was immediate:

Small, Composable Micro-Tools

Instead of loading massive, general-purpose MCP servers that expose an entire REST API to your LLM, build and use small, single-purpose open-source tools designed specifically for agent consumption.

1. Prefer Focused CLI Scripts Over Bloated Schemas

If your agent already has a single bash/terminal execution tool, it does not need a 30-tool GitHub MCP server. A 40-line TypeScript CLI utility that wraps your exact workflow, strips out JSON noise, and prints only actionable lines saves thousands of tokens on both input (zero schema bloat) and output (curated stdout).

#!/usr/bin/env node // scripts/pr-summary.ts — Zero-bloat alternative to a full GitHub MCP server import { execFileSync } from "node:child_process"; const prNumber = process.argv[2]; if (!prNumber) { console.error("Usage: pr-summary <pr-number>"); process.exit(1); } // Fetch only the exact fields the AI actually needs to reason const raw = execFileSync( "gh", ["pr", "view", prNumber, "--json", "title,state,body,files"], { encoding: "utf8" } ); const data = JSON.parse(raw); console.log(`PR: ${data.title} [${data.state}]`); console.log(`Changed Files (${data.files.length}):`); for (const file of data.files) { console.log(` - ${file.path} (+${file.additions}/-${file.deletions})`); } 

2. Design "Narrow Waist" MCP Tools

When you do build or use an MCP server, follow the Unix philosophy:

• Consolidate CRUD sprawl: Instead of exposing 12 separate tools for listing, filtering, and reading issues, expose 1 or 2 tightly scoped read-only tools.
• Trim property descriptions: Write concise, high-signal schema descriptions. The LLM does not need a three-paragraph essay explaining what a limit integer does.
• Truncate and format outputs at the boundary: Never return raw 50 KB API payloads to the model. Filter and format the response inside your TypeScript tool handler before returning it to the agent.

How to Equip Your AI Agent

Bookmark this matrix to decide whether a workflow belongs in an MCP server, a lightweight CLI script, or a project skill:

Pre-Flight Checklist for Lean AI Workflows

Before starting your next coding session, run through this 60-second audit:

• [ ] Disable global MCP servers: Never load Jira, Slack, or database MCPs globally. Enable them per-project or per-session only when actively needed.
• [ ] Cap active tools at 15: If your agent has more than 15–20 tools active at once, audit and disable the ones you haven't triggered in the past week.
• [ ] Filter read vs. write tools: Disable destructive or write-heavy MCP endpoints (delete_repo, merge_pr, drop_table)—they waste context tokens and introduce security risks.
• [ ] Replace chatty MCPs with lightweight TypeScript CLIs: If a tool just wraps a REST endpoint or local command, turn it into a small, composable script that returns clean, summarized text.

The Takeaway

The power of an AI agent isn't measured by how many tools you attach to it—it's measured by how much clean, unpolluted context remains for actual reasoning. By ditching bloated, monolithic MCP servers in favor of small, sharp, single-purpose TypeScript tools, you cut token costs, eliminate tool hallucinations, and make your agent noticeably faster.

How many MCP tools are currently active in your editor right now, and have you noticed your agent getting slower as you added more integrations?

Connect with Us

If you found this article helpful, check out our open-source tools and let's connect!

• 🛠️ Necoz Open Source: necoz-oss on GitHub | @necoz on DEV
• 💻 Author GitHub: johnnylemonny

𝗝𝗼𝗵𝗻Follow

Freelance fullstack developer creating fast, modern, and refined applications. I focus on simplicity, performance, and real value for users. I also write tech-related articles here.