tool execution error
An MCP tool failure reported as a normal result with isError set to true, as opposed to a protocol error with a JSON-RPC error code.
In more detail
Protocol errors cover malformed requests: invalid params (which includes an unknown tool), method not found and an unsupported protocol version. Execution errors, such as "no task has that id", should be passed to the model so it can correct itself.
Related terms
- actionable error — An error message written for the model that says what failed and how to fix the call, so its retry can succeed.
- JSON-RPC — A lightweight protocol for remote calls encoded as JSON objects, with requests, results, errors and notifications matched by id.
- MCP tool — A function an MCP server offers for the model to call, described by a name, description and input schema.
Taught in
- What MCP Is — AI Engineering: LLM Apps, RAG & Agents
- Build An MCP Server — AI Engineering: LLM Apps, RAG & Agents
- Connect An Agent To MCP — AI Engineering: LLM Apps, RAG & Agents
- Capstone: The Tasks Assistant — AI Engineering: LLM Apps, RAG & Agents
References
- MCP 2026-07-28: Tools
- MCP 2026-07-28: Base protocol overview (messages, _meta, error codes, statelessness)