Guide: How to Build Production-Ready MCP Tool Schemas Under 2026 Spec

·1 views

A new developer guide published on DEV Community explains how to correctly build and validate Model Context Protocol (MCP) tool schemas following the July 28, 2026 specification revision, described as the protocol's largest rework since launch. The guide warns that a schema can pass validation while still producing bad model calls if descriptions are vague, required fields are misconfigured, or object properties are left open-ended. It walks developers through constructing a practical tool definition — covering stable naming conventions, precise descriptions, and a well-structured inputSchema using JSON Schema Draft 2020-12. The guide also highlights that tools/list results are now cacheable under the new spec, meaning a renamed tool can remain broken in client caches even after redeployment. Developers are advised to use a browser-based MCP Tool Schema Generator as an editable starting point rather than a finished contract.

Read the full story at DEV Community

This is an AI-generated summary. ShortSingh links to the original source for the complete article.

Discussion (0)

Why AI Agents Need Evaluation Loops, Not Just Better Prompts

Repeatedly tweaking prompts to fix AI agent behavior is a flawed approach because agents are complex multi-step systems involving tool calls, memory, retrieval, permissions, and model reasoning — not just text instructions. A single prompt change may resolve one issue while silently breaking several others across the system. Engineers building production-grade agents need a structured evaluation loop that tests the full interaction trace, not merely the final output. This loop should include an agent contract, real-incident-based test cases, deterministic assertions, regression tests, and model-based judging only after rule-based checks pass. Releasing agent updates safely also requires shadow traffic, canary deployments, and metric gates — with production failures continuously fed back into the evaluation set.

0 comments Read more at DEV Community

ProgrammingDEV Community ·

Claude Code Bug Deleted 1,068 Files via Encoding Mismatch in Windows Batch Script

A GitHub issue filed on September 5, 2026, reports that Claude Code 2.1.224 deleted 1,068 files from a repository root on a Windows 11 system running a Japanese locale. The AI tool generated a .cmd batch script in UTF-8 with LF-only line endings, but Windows' cmd.exe parsed it using the system's OEM codepage CP932, causing a trailing full-width Japanese period in a comment to consume the following newline. This silently merged two lines, preventing a variable assignment from executing and leaving the WORK variable unset. When the deletion command ran with the empty variable, it expanded to delete every file in the working directory instead of failing safely. Of the 1,068 deleted files, 123 were unrecoverable, and the issue remained open with no maintainer response at the time of publication.

0 comments Read more at DEV Community

ProgrammingDEV Community ·

Why AI Agents Require Evaluation Loops, Not Just Better Prompts

AI agents are complex multi-step systems that rely on model reasoning, tool calls, memory, retrieved context, and permissions — meaning a single prompt change can silently break multiple behaviors while fixing one. Developers often fall into a cycle of prompt tweaking that amounts to manual trial and error without any systemic visibility into what actually improved. An evaluation loop is the engineering framework that tracks whether a change truly improved the agent overall, checking tool use, policy citations, trajectory decisions, and cost metrics across the full trace. Building such a loop involves writing an agent contract, creating eval cases from real incidents, running deterministic checks before model-based judging, and using shadow traffic and canary releases before full deployment. Without an evaluation loop, teams cannot safely iterate on production agents or catch regressions before they reach end users.

0 comments Read more at DEV Community

ProgrammingDEV Community ·

Why Smart RAG Systems Must Learn When to Skip Retrieval Entirely

A growing challenge in production RAG (Retrieval-Augmented Generation) systems is not poor retrieval quality but the failure to decide when retrieval should not happen at all. Engineers at DEV Community highlight that blindly retrieving documents for every query adds latency, cost, and context noise while often producing confidently wrong answers. For example, a query about a live order status should route to an API tool, not a static policy document. Experts recommend building a routing layer that can choose between direct answers, tool calls, RAG retrieval, clarification requests, or refusals based on question type. Teams are also urged to treat retrieval similarity scores as evidence thresholds rather than truth signals, and to evaluate whether retrieval was even necessary — not just whether the final answer appeared correct.

0 comments Read more at DEV Community