Tool Schema Tax

Tool Schema Tax

The fixed context cost paid when an agent runtime injects tool schemas into every prompt, regardless of whether those tools are used in the current turn.

Key points

  • Native MCP can be token-efficient per operation, but expensive across a full session when tool schemas are always loaded [src-041].
  • In Marco Mornati’s GitHub experiment, Native MCP had the lowest per-interaction cost at 207 tokens, but the GitHub server added about 3,062 fixed schema tokens per prompt [src-041].
  • In a 20-prompt session with only two GitHub operations, the article estimates Native GitHub MCP at 61,654 tokens, with 61,240 tokens coming from repeated schema overhead [src-041].
  • The same session costs 448 tokens with raw CLI, 968 with on-demand CLI plus skill, and 892 with a gateway MCP [src-041].
  • The schema tax is most damaging for low-frequency tools that are loaded throughout long coding sessions but called only at the start or end [src-041].

Related concepts

Source references

  • [src-041] Marco Mornati — “The Future of Agentic Tooling: MCP Servers vs. CLI A Data-Driven Comparison” (2026-04-27)

Robin Cartier perspective

This page is part of Robin Cartier's working AI knowledge graph: a practical research layer for production AI, recommendation systems, experimentation, GEO, and agentic web readiness.

The useful next step is to connect this concept back to applied product leadership and operating models.

Recommended next

Keep reading from this thread

From 491 indexed pages and articles.

  1. Wiki concept Progressive Context Loading (Skills) The three-level loading pattern Claude Code uses to keep skills lightweight. Level 1: initial search only reads the YAML frontmatter (name + Readers have engaged with this next
  2. Wiki concept Claude Code Context Management Discipline The set of practices for keeping Claude Code context windows lean: /clear between unrelated tasks, /compact at ~60% capacity with targeted Related by context
  3. Insight Generative Engine Optimization for AI Search A practical GEO guide for becoming visible in AI-generated answers through machine-scannable content, authority, schema, and monitoring Related by schema