{"rewrite":{"id":"r_79e94b50dd7810b283fc5827","clusterId":"c_abc663b62eb635ea655e246f","slug":"mcp-design-pitfall-exposing-apis-as-is-wastes-context-window","model":"deepseek-v4-flash","headline":"MCP Design Pitfall: Exposing APIs As-Is Wastes Context Window","summary":"A new article from CData, re-edited on ASCII.jp, warns that directly mapping existing API endpoints to MCP tools degrades AI agent performance. Each tool consumes 200-600 tokens, and 150 tools can eat 25-30% of a 200k context window before any task data. Cursor and GitHub Copilot enforce tool limits of 40 and 128 respectively, based on measured degradation. The piece advocates for scoped tool design to reduce context tax.","whyItMatters":"The article provides concrete evidence that naive MCP server design undermines AI agent accuracy, with measurable context window costs that developers must account for.","webCardHtml":"\u003cp\u003eEach MCP tool adds 200 to 600 tokens to the context window just for its name, description, and parameter schema. With five servers each offering 30 tools, that is 150 tools occupying a quarter to a third of a 200,000-token context before any user message or retrieved data arrives. Cursor caps MCP tools at 40, and GitHub Copilot enforces a hard limit of 128-both thresholds derived from observed performance drops beyond those counts.\u003c/p\u003e\u003cp\u003eThe article, originally published on the CData Blog and re-edited on ASCII.jp, identifies the root cause: developers wrap existing REST endpoints as MCP tools without scoping, carrying over API redundancy into the LLM\u0026#39;s context. Fine-grained CRUD operations that could be combined into one tool instead multiply the overhead. The fix is scoped tool design that minimizes the manifest size per request.\u003c/p\u003e","blueskyPost":"MCP servers that expose existing API endpoints as-is are burning context window tokens. Each tool costs 200-600 tokens; 150 tools eat 25-30% of a 200k window. Cursor and Copilot already enforce tool limits. Scoped design is the fix.","twitterPost":"MCP servers that wrap existing APIs as-is are wasting context window. Each tool costs 200-600 tokens; 150 tools eat 25-30% of a 200k window. Cursor limits to 40, Copilot to 128. Scoped design is the fix.","threadsPost":null,"newsletterBlurb":"A CData article re-edited on ASCII.jp warns that directly mapping API endpoints to MCP tools degrades AI agent performance by consuming context window tokens. Each tool adds 200-600 tokens, and 150 tools can occupy a quarter of a 200k context. The piece recommends scoped tool design to reduce overhead.","attributionJson":"[{\"source\":\"ASCII.jp\",\"url\":\"https://ascii.jp/elem/000/004/414/4414800/?rss\",\"title\":\"Explaining Pitfalls in MCP Design! Are You Converting Existing APIs to MCP As-Is?\"}]","lintFlagsJson":null,"lintHits":0,"costUsd":0,"inputTokens":4230,"outputTokens":1377,"status":"published","repairAttempts":0,"nextRepairAt":null,"factsAttemptedAt":1783475072,"createdAt":"2026-07-08T01:39:35.000Z","publishedAt":"2026-07-08T01:43:32.000Z","updatedAt":"2026-07-08T01:39:35.000Z"},"cluster":{"id":"c_abc663b62eb635ea655e246f","canonicalTitle":"MCP設計時の落とし穴を解説！既存のAPI、そのままMCP化してませんか？","representativeArticleId":"a_b238ec7c637446c4a9641c85","sourceCount":1,"writtenSourceCount":1,"writeAttempts":0,"isSolo":true,"entitiesJson":"{\"anime_titles\":[],\"manga_titles\":[],\"work_titles\":[],\"studios\":[],\"people\":[],\"type\":\"op_ed\",\"domain\":\"other\",\"is_roundup\":false}","contentType":"news","status":"published","firstSeenAt":"2026-07-08T01:00:00.000Z","lastSeenAt":"2026-07-08T01:00:00.000Z","updatedAt":"2026-07-08T01:43:32.000Z"},"attribution":[{"source":"ASCII.jp","url":"https://ascii.jp/elem/000/004/414/4414800/?rss","title":"MCP設計時の落とし穴を解説！既存のAPI、そのままMCP化してませんか？"}],"entities":{"anime_titles":[],"manga_titles":[],"work_titles":[],"studios":[],"people":[],"type":"op_ed","domain":"other","is_roundup":false},"keyFacts":null}