# `OzMcp.Structs.CallToolResult`
[🔗](https://github.com/oz-elixir/oz_mcp/blob/v0.9.0/lib/oz_mcp/structs/call_tool_result.ex#L1)

Helper module used to build `CallToolResult` structure.

_(MCP protocol: 2025-11-25)_

## Short example:

```elixir
%CallToolResult{}
  |> CallToolResult.content([
    %TextContent{}
    |> TextContent.text("Hello, world!")
  ])
  |> CallToolResult.build()
```

Result:

```elixir
%{content: [%{type: "text", text: "Hello, world!"}]}
```

## Long example:

```elixir
%CallToolResult{}
  |> CallToolResult.content([
    %TextContent{}
    |> TextContent.text("Hello, world!"),
    %ImageContent{}
    |> ImageContent.data("iVBORw0KGgoAAAANSUhEUg==")
    |> ImageContent.mime_type("image/png")
  ])
  |> CallToolResult.structured_content(%{"result" => "ok"})
  |> CallToolResult.is_error(false)
  |> CallToolResult._meta(%{"key" => "value"})
  |> CallToolResult.extras(%{"durationMs" => 12, "cost" => 0.25})
  |> CallToolResult.build()
```

Result:

```elixir
%{
  :content => [
    %{type: "text", text: "Hello, world!"},
    %{
      data: "iVBORw0KGgoAAAANSUhEUg==",
      type: "image",
      mimeType: "image/png"
    }
  ],
  :_meta => %{"key" => "value"},
  :structuredContent => %{"result" => "ok"},
  :isError => false,
  "cost" => 0.25,
  "durationMs" => 12
}
```

Specification: [CallToolResult](https://modelcontextprotocol.io/specification/2025-11-25/schema#calltoolresult)

## Fields

| Field | Setter | Type | Required |
|---|---|---|---|
| `content` | `content/2` | [content()] | yes |
| `_meta` | `_meta/2` | map | no |
| `structuredContent` | `structured_content/2` | map | no |
| `isError` | `is_error/2` | boolean | no |
| `extras` | `extras/2` | map | no |

# `content`

```elixir
@type content() :: OzMcp.Structs.ContentBlock.t()
```

# `t`

```elixir
@type t() :: %OzMcp.Structs.CallToolResult{
  _meta: map() | nil,
  content: [content()],
  extras: map() | nil,
  isError: boolean() | nil,
  structuredContent: map() | nil
}
```

# `build`

```elixir
@spec build(t()) :: map()
```

# `content`

```elixir
@spec content(t(), [content()]) :: t()
```

# `extras`

```elixir
@spec extras(t(), map() | nil) :: t()
```

# `is_error`

```elixir
@spec is_error(t(), boolean() | nil) :: t()
```

# `structured_content`

```elixir
@spec structured_content(t(), map() | nil) :: t()
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*
