# MentorHostedTools enum

> Provider-hosted tools the coordinator may use (roadmap #15 — Agent Framework hosted tools).

- URL: https://docs.mentoragent.net/api/novior-mentoragent-abstractions-models/mentorhostedtools
- Verified with: MentorAgent 1.2.0
- Last updated: 2026-10-27
- Packages: Novior.MentorAgent.Abstractions

Unlike `[MentorAction]` function tools, these are **not** executed by your application: they run on the model provider's infrastructure during inference. MentorAgent only declares them, which is exactly what the Agent Framework does (`HostedWebSearchTool`, `HostedCodeInterpreterTool`, `HostedFileSearchTool`, `HostedImageGenerationTool`, `HostedMcpServerTool` from `Microsoft.Extensions.AI`).

⚠️ **Availability depends on the provider.** Azure OpenAI / OpenAI *Responses* clients support the full set; the *Chat Completions* client supports web search only. Enabling a tool the provider does not support makes the provider reject the call — see the package README.

## Definition

Namespace: `Novior.MentorAgent.Abstractions.Models`. Package: `Novior.MentorAgent.Abstractions`.

`public enum MentorHostedTools`

```shell
dotnet add package Novior.MentorAgent.Abstractions
```

## Values

| Value | Number | Description |
|---|---|---|
| `None` | 0 | No hosted tools (default). |
| `WebSearch` | 1 | Web search — the provider searches the web for up-to-date information (current events, documentation, anything past the model's training cut-off). |
| `CodeInterpreter` | 2 | Code interpreter — the provider writes and runs code in its own sandbox for exact computation, data analysis and file processing. The code never runs on your servers. |
| `FileSearch` | 4 | File search — the provider searches documents you uploaded to its vector store(s). Requires `MentorOptions.FileSearchVectorStoreIds`. |
| `ImageGeneration` | 8 | Image generation — the provider generates images from the conversation and returns them inline. The generated images are rendered in the message bubble. |
| `HostedMcp` | 16 | Hosted MCP — the **provider** connects to a remote MCP server and calls its tools during inference (as opposed to `MentorOptions.McpServers`, where *your* process is the MCP client). Requires `MentorOptions.HostedMcpServers`. |

---

- Previous: [MentorCardField record](https://docs.mentoragent.net/api/novior-mentoragent-abstractions-models/mentorcardfield.md)
- Next: [MentorLanguage enum](https://docs.mentoragent.net/api/novior-mentoragent-abstractions-models/mentorlanguage.md)