DEV Community

Cover image for How to Reduce MCP Token Waste with Skills
baboon
baboon

Posted on

How to Reduce MCP Token Waste with Skills

#ai

MCP tools flood your context window with token-heavy definitions. Learn why converting MCP tools into......

Every MCP tool your AI agent connects to sends its full schema into the context window — before the agent even does anything. Connect a dozen servers, each exposing 20+ tools, and you're burning hundreds of thousands of tokens on definitions alone. Anthropic's own engineering team found that this overhead can balloon to 150,000 tokens in tool-heavy setups, slowing response times and inflating costs on every single call.

The solution isn't fewer tools. It's a smarter loading strategy. This is where Skills come in — and where MCP2Skill bridges the gap between raw MCP exposure and token-efficient agent workflows.

When you connect an AI agent directly to MCP servers, two things consume tokens:

  1. Tool definition bloat. Every tool's name, description, input schema, and output schema is injected into the context window upfront. The GitHub MCP server alone exposes ~80 tools. Add filesystem, browser, and database servers, and your agent is carrying a massive tool surface it will never fully use in a single task.

  2. Intermediate result accumulation. Each tool call returns results that stay in context. Large file reads, search results, and API responses pile up across multi-step workflows.

The result: your agent spends more tokens thinking about tools than actually completing the task. Latency rises. Costs climb. And in extreme cases, the context window fills up before the work is done.

A Skill is a packaging layer that sits between the model and the underlying capability. Instead of dumping every tool definition into context at once, a Skill exposes a concise description — a small front door. The deeper instructions, scripts, and references only load when the task actually matches.

Here's the difference in practice:

Approach What enters context When it loads
Raw MCP Full tool schemas for every connected server Always, on every request
Skill-based A short description per Skill Only when the agent decides the Skill is relevant

Anthropic demonstrated this pattern with their code execution MCP: by having the agent discover tools on demand rather than loading all definitions upfront, they reduced token usage from 150,000 to 2,000 tokens — a 98.7% reduction.

MCP2Skill automates the conversion from raw MCP tools to token-efficient Skills. The workflow has three steps:

1. Define the capability boundary

Start from a service or a workspace. MCP2Skill lets you filter tools at the workspace level, so the Skill only packages the capability that matters for a specific workflow — not the entire tool surface of the source server.

2. Generate and preview

MCP2Skill generates the Skill files (SKILL.md, scripts, references) and shows you a preview before anything is written to disk. You can inspect the file tree, check the instructions, and adjust the boundary before exporting.

3. Install into the agent

Once the Skill looks right, install it directly into your target AI agent client. The agent now has a focused, on-demand capability that loads only when relevant — instead of a raw tool surface it carries on every call.

Skills aren't a replacement for MCP — they're a complement. Use the Skill path when:

  • You run the same workflow repeatedly (e.g., "fetch the meeting transcript and summarize it").
  • The capability boundary is stable — the instructions don't change between invocations.
  • You want to reduce token cost on high-frequency tasks.

Keep the MCP gateway path when:

  • The agent needs live, changing data from external systems.
  • You want one managed endpoint that multiple clients can reuse.
  • The task is exploratory and doesn't fit a repeatable pattern.

Token waste from MCP isn't a theoretical problem — it's a direct hit to your API bill and agent latency. By converting high-value MCP workflows into Skills, you get the same capability with a fraction of the token cost. MCP2Skill makes this conversion automatic: define the boundary, preview the output, install the Skill.

Start with one workflow. Measure the before-and-after token usage. Then decide which capabilities to convert next.

Top comments (0)