> ## Documentation Index
> Fetch the complete documentation index at: https://easyaf.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# IMcpToolFactory

> Factory for creating MCP tools dynamically from OData metadata.

export function DocsBadge({text, variant = 'neutral'}) {
  const variantClasses = {
    success: 'mint-bg-green-500/10 mint-text-green-600 dark:mint-text-green-400 mint-border-green-500/20',
    neutral: 'mint-bg-slate-500/10 mint-text-slate-600 dark:mint-text-slate-400 mint-border-slate-500/20',
    info: 'mint-bg-blue-500/10 mint-text-blue-600 dark:mint-text-blue-400 mint-border-blue-500/20',
    warning: 'mint-bg-amber-500/10 mint-text-amber-600 dark:mint-text-amber-400 mint-border-amber-500/20',
    danger: 'mint-bg-red-500/10 mint-text-red-600 dark:mint-text-red-400 mint-border-red-500/20'
  };
  const classes = variantClasses[variant] || variantClasses.neutral;
  return <span className={`mint-inline-flex mint-items-center mint-px-2 mint-py-0.5 mint-rounded-full mint-text-xs mint-font-medium mint-tracking-wide mint-border mint-ml-1.5 mint-align-middle mint-whitespace-nowrap ${classes}`}>
      {text}
    </span>;
}

## Definition

**Assembly:** Microsoft.OData.Mcp.Core.dll

**Namespace:** Microsoft.OData.Mcp.Core.Tools

## Syntax

```csharp theme={"dark"}
Microsoft.OData.Mcp.Core.Tools.IMcpToolFactory
```

## Summary

Factory for creating MCP tools dynamically from OData metadata.

## Remarks

This factory generates MCP tools based on the parsed OData model, creating tools for
CRUD operations, queries, and navigation between entities. The tools are generated
dynamically to match the structure and capabilities of the OData service.

## Methods

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} style={{ paddingRight: '8px' }} />  FilterToolsForUser <DocsBadge text="Abstract" variant="warning" />

Filters tools based on user authorization context.

#### Syntax

```csharp theme={"dark"}
System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition> FilterToolsForUser(System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition> tools, System.Collections.Generic.IEnumerable<string> userScopes, System.Collections.Generic.IEnumerable<string> userRoles, Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions options = null)
```

#### Parameters

| Name         | Type                                                                                       | Description                          |
| ------------ | ------------------------------------------------------------------------------------------ | ------------------------------------ |
| `tools`      | `System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>` | The tools to filter.                 |
| `userScopes` | `System.Collections.Generic.IEnumerable<string>`                                           | The user's OAuth2 scopes.            |
| `userRoles`  | `System.Collections.Generic.IEnumerable<string>`                                           | The user's roles.                    |
| `options`    | `Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions?`                                 | Options for authorization filtering. |

#### Returns

Type: `System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>`
A collection of tools the user is authorized to access.

#### Exceptions

| Exception               | Description                  |
| ----------------------- | ---------------------------- |
| `ArgumentNullException` | Thrown when *tools* is null. |

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} style={{ paddingRight: '8px' }} />  GenerateCrudToolsAsync <DocsBadge text="Abstract" variant="warning" />

Generates CRUD operation tools for a specific entity type.

#### Syntax

```csharp theme={"dark"}
System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>> GenerateCrudToolsAsync(Microsoft.OData.Mcp.Core.Models.EdmEntityType entityType, Microsoft.OData.Mcp.Core.Models.EdmModel model, Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions options = null)
```

#### Parameters

| Name         | Type                                                       | Description                                 |
| ------------ | ---------------------------------------------------------- | ------------------------------------------- |
| `entityType` | `Microsoft.OData.Mcp.Core.Models.EdmEntityType`            | The entity type to generate CRUD tools for. |
| `model`      | `Microsoft.OData.Mcp.Core.Models.EdmModel`                 | The complete OData model for context.       |
| `options`    | `Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions?` | Options for tool generation.                |

#### Returns

Type: `System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>>`
A collection of CRUD tool definitions.

#### Exceptions

| Exception               | Description                                  |
| ----------------------- | -------------------------------------------- |
| `ArgumentNullException` | Thrown when *entityType* or *model* is null. |

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} style={{ paddingRight: '8px' }} />  GenerateEntitySetToolsAsync <DocsBadge text="Abstract" variant="warning" />

Generates tools for entity set operations (collection-level operations).

#### Syntax

```csharp theme={"dark"}
System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>> GenerateEntitySetToolsAsync(Microsoft.OData.Mcp.Core.Models.EdmEntitySet entitySet, Microsoft.OData.Mcp.Core.Models.EdmModel model, Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions options = null)
```

#### Parameters

| Name        | Type                                                       | Description                           |
| ----------- | ---------------------------------------------------------- | ------------------------------------- |
| `entitySet` | `Microsoft.OData.Mcp.Core.Models.EdmEntitySet`             | The entity set to generate tools for. |
| `model`     | `Microsoft.OData.Mcp.Core.Models.EdmModel`                 | The complete OData model for context. |
| `options`   | `Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions?` | Options for tool generation.          |

#### Returns

Type: `System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>>`
A collection of entity set tool definitions.

#### Exceptions

| Exception               | Description                                 |
| ----------------------- | ------------------------------------------- |
| `ArgumentNullException` | Thrown when *entitySet* or *model* is null. |

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} style={{ paddingRight: '8px' }} />  GenerateEntityToolsAsync <DocsBadge text="Abstract" variant="warning" />

Generates MCP tools for a specific entity type.

#### Syntax

```csharp theme={"dark"}
System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>> GenerateEntityToolsAsync(Microsoft.OData.Mcp.Core.Models.EdmEntityType entityType, Microsoft.OData.Mcp.Core.Models.EdmModel model, Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions options = null)
```

#### Parameters

| Name         | Type                                                       | Description                            |
| ------------ | ---------------------------------------------------------- | -------------------------------------- |
| `entityType` | `Microsoft.OData.Mcp.Core.Models.EdmEntityType`            | The entity type to generate tools for. |
| `model`      | `Microsoft.OData.Mcp.Core.Models.EdmModel`                 | The complete OData model for context.  |
| `options`    | `Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions?` | Options for tool generation.           |

#### Returns

Type: `System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>>`
A collection of generated MCP tool definitions for the entity type.

#### Exceptions

| Exception               | Description                                  |
| ----------------------- | -------------------------------------------- |
| `ArgumentNullException` | Thrown when *entityType* or *model* is null. |

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} style={{ paddingRight: '8px' }} />  GenerateNavigationToolsAsync <DocsBadge text="Abstract" variant="warning" />

Generates navigation tools for entity relationships.

#### Syntax

```csharp theme={"dark"}
System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>> GenerateNavigationToolsAsync(Microsoft.OData.Mcp.Core.Models.EdmEntityType entityType, Microsoft.OData.Mcp.Core.Models.EdmModel model, Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions options = null)
```

#### Parameters

| Name         | Type                                                       | Description                                       |
| ------------ | ---------------------------------------------------------- | ------------------------------------------------- |
| `entityType` | `Microsoft.OData.Mcp.Core.Models.EdmEntityType`            | The entity type to generate navigation tools for. |
| `model`      | `Microsoft.OData.Mcp.Core.Models.EdmModel`                 | The complete OData model for context.             |
| `options`    | `Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions?` | Options for tool generation.                      |

#### Returns

Type: `System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>>`
A collection of navigation tool definitions.

#### Exceptions

| Exception               | Description                                  |
| ----------------------- | -------------------------------------------- |
| `ArgumentNullException` | Thrown when *entityType* or *model* is null. |

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} style={{ paddingRight: '8px' }} />  GenerateQueryToolsAsync <DocsBadge text="Abstract" variant="warning" />

Generates query tools for the OData model.

#### Syntax

```csharp theme={"dark"}
System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>> GenerateQueryToolsAsync(Microsoft.OData.Mcp.Core.Models.EdmModel model, Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions options = null)
```

#### Parameters

| Name      | Type                                                       | Description                                  |
| --------- | ---------------------------------------------------------- | -------------------------------------------- |
| `model`   | `Microsoft.OData.Mcp.Core.Models.EdmModel`                 | The OData model to generate query tools for. |
| `options` | `Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions?` | Options for tool generation.                 |

#### Returns

Type: `System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>>`
A collection of query tool definitions.

#### Exceptions

| Exception               | Description                  |
| ----------------------- | ---------------------------- |
| `ArgumentNullException` | Thrown when *model* is null. |

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} style={{ paddingRight: '8px' }} />  GenerateToolsAsync <DocsBadge text="Abstract" variant="warning" />

Generates all MCP tools for the specified OData model.

#### Syntax

```csharp theme={"dark"}
System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>> GenerateToolsAsync(Microsoft.OData.Mcp.Core.Models.EdmModel model, Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions options = null)
```

#### Parameters

| Name      | Type                                                       | Description                            |
| --------- | ---------------------------------------------------------- | -------------------------------------- |
| `model`   | `Microsoft.OData.Mcp.Core.Models.EdmModel`                 | The OData model to generate tools for. |
| `options` | `Microsoft.OData.Mcp.Core.Tools.McpToolGenerationOptions?` | Options for tool generation.           |

#### Returns

Type: `System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>>`
A collection of generated MCP tool definitions.

#### Exceptions

| Exception               | Description                  |
| ----------------------- | ---------------------------- |
| `ArgumentNullException` | Thrown when *model* is null. |

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} style={{ paddingRight: '8px' }} />  GetAvailableToolNames <DocsBadge text="Abstract" variant="warning" />

Gets all available tool names.

#### Syntax

```csharp theme={"dark"}
System.Collections.Generic.IEnumerable<string> GetAvailableToolNames()
```

#### Returns

Type: `System.Collections.Generic.IEnumerable<string>`
A collection of all tool names that have been generated.

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} style={{ paddingRight: '8px' }} />  GetTool <DocsBadge text="Abstract" variant="warning" />

Gets the tool definition by name.

#### Syntax

```csharp theme={"dark"}
Microsoft.OData.Mcp.Core.Tools.McpToolDefinition GetTool(string toolName)
```

#### Parameters

| Name       | Type     | Description                       |
| ---------- | -------- | --------------------------------- |
| `toolName` | `string` | The name of the tool to retrieve. |

#### Returns

Type: `Microsoft.OData.Mcp.Core.Tools.McpToolDefinition?`
The tool definition if found; otherwise, null.

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} style={{ paddingRight: '8px' }} />  ValidateTools <DocsBadge text="Abstract" variant="warning" />

Validates that the generated tools are compatible with the MCP specification.

#### Syntax

```csharp theme={"dark"}
System.Collections.Generic.IEnumerable<string> ValidateTools(System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition> tools)
```

#### Parameters

| Name    | Type                                                                                       | Description            |
| ------- | ------------------------------------------------------------------------------------------ | ---------------------- |
| `tools` | `System.Collections.Generic.IEnumerable<Microsoft.OData.Mcp.Core.Tools.McpToolDefinition>` | The tools to validate. |

#### Returns

Type: `System.Collections.Generic.IEnumerable<string>`
A collection of validation errors, or empty if all tools are valid.

#### Exceptions

| Exception               | Description                  |
| ----------------------- | ---------------------------- |
| `ArgumentNullException` | Thrown when *tools* is null. |