# MCP Structured Tool Output

> Tool results sent as neat data in a set shape. Code can read them.

**Field:** Artificial Intelligence  
**Category:** MCP  
**Also known as:** structuredContent, MCP outputSchema, Structured Tool Output, Structured Content (MCP)

## Think of it like

It is like a shop receipt. It has a friendly note for you and neat rows of numbers for the till.

## Definition

MCP structured tool output is data a tool returns in a set shape, not just as text. The tool can declare an output schema that says what that shape is. Its result then carries the data in a field called structuredContent. For older clients, the tool should also return the same data as text. Code can read the data straight away, with no guessing from words.

## Example

A weather tool returns the text "It is 22 degrees". It also returns structuredContent with temperature 22, so the app can draw a chart.

## Example code

```json
{
  "content": [{ "type": "text", "text": "{\"temp\": 22}" }],
  "structuredContent": { "temp": 22 }
}
```

The same answer twice: as text for older clients, and as data.

## Why it matters

Programs need data they can check, not sentences. A schema lets a client test the result before it uses it.

## Common mistake

Mixing it up with a model's structured output. This is data from a tool, not JSON written by the model.

## Three principles

- **A set shape.** The output schema defines it.
- **Data, not words.** Code reads it without guessing.
- **Text too.** Older clients still get an answer.

## Related terms

- [MCP Tool](https://learn.benibix.com/term/ai/mcp-tool)
- [Structured Output (LLM)](https://learn.benibix.com/term/ai/structured-output)
- [JSON Schema](https://learn.benibix.com/term/development/json-schema)
- [MCP Apps](https://learn.benibix.com/term/ai/mcp-apps)
- [Tool Use (Function Calling)](https://learn.benibix.com/term/ai/tool-use)

## Told apart from

- [Structured Output vs MCP Structured Tool Output](https://learn.benibix.com/compare/structured-output-vs-mcp-structured-tool-output): People think both mean the model writes neat JSON. Only one does. Structured output is a model's own answer, forced into a set shape. MCP structured tool output is data a tool sends back after it runs, in a field called structuredContent. The model did not write it at all. One shapes what the model says, the other shapes what a tool returns.

![On the left, a tool's description with annotation hints such as readOnlyHint and an output schema. In the middle, the tool's result holding a text block for the model and a structuredContent block for code. On the right, an MCP App: a small web page from a ui:// resource drawn in a walled box inside the chat.](https://learn.benibix.com/diagrams/ai8-mcp-tool-result.svg)

---

Source: https://learn.benibix.com/term/ai/mcp-structured-tool-output
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-18
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
