IMcpServerBuilder - EasyAF SI

Definition

Assembly: ModelContextProtocol.dll Namespace: Microsoft.Extensions.DependencyInjection

Syntax

Microsoft.Extensions.DependencyInjection.IMcpServerBuilder

Summary

This type is defined in ModelContextProtocol.

Methods

WithCosmosTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Cosmos_McpServerBuilderExtensions

Enables MCP Tasks backed by CosmosMcpTaskStore for a single user.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithCosmosTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, string userId, System.Action<CloudNimble.McpEssentials.Cosmos.Tasks.CosmosMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`userId`	`string`	The owner stamped on every task this process creates.
`configure`	`System.Action<CloudNimble.McpEssentials.Cosmos.Tasks.CosmosMcpTaskStoreOptions>?`	Optional store options (TTL, database and container ids).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options.

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder is `null`.
`ArgumentException`	Thrown when userId is `null` or whitespace.

WithCosmosTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Cosmos_McpServerBuilderExtensions

Enables MCP Tasks backed by CosmosMcpTaskStore.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithCosmosTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<string> getCurrentUserId, System.Action<CloudNimble.McpEssentials.Cosmos.Tasks.CosmosMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getCurrentUserId`	`System.Func<string?>`	Returns the current user identifier, or `null` when unauthenticated.
`configure`	`System.Action<CloudNimble.McpEssentials.Cosmos.Tasks.CosmosMcpTaskStoreOptions>?`	Optional store options (TTL, database and container ids).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options.

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getCurrentUserId is `null`.

WithCosmosTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Cosmos_McpServerBuilderExtensions

Enables MCP Tasks backed by CosmosMcpTaskStore, resolving the user from a principal.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithCosmosTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.Cosmos.Tasks.CosmosMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getPrincipal`	`System.Func<System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request.
`configure`	`System.Action<CloudNimble.McpEssentials.Cosmos.Tasks.CosmosMcpTaskStoreOptions>?`	Optional store options (TTL, database and container ids).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options.

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

WithCosmosTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Cosmos_McpServerBuilderExtensions

Enables MCP Tasks backed by CosmosMcpTaskStore, resolving the user from services already registered in the built IServiceProvider.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithCosmosTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.Cosmos.Tasks.CosmosMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getPrincipal`	`System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request. ASP.NET Core hosts call
`AddHttpContextAccessor()` and pass
`sp => sp.GetRequiredService<IHttpContextAccessor>().HttpContext?.User`.
`configure`	`System.Action<CloudNimble.McpEssentials.Cosmos.Tasks.CosmosMcpTaskStoreOptions>?`	Optional store options (TTL, database and container ids).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options.

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

WithPostgreSqlTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_PostgreSQL_McpServerBuilderExtensions

Enables MCP Tasks backed by PostgreSqlMcpTaskStore for a single user.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithPostgreSqlTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, string userId, System.Action<CloudNimble.McpEssentials.PostgreSQL.Tasks.PostgreSqlMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`userId`	`string`	The owner stamped on every task this process creates.
`configure`	`System.Action<CloudNimble.McpEssentials.PostgreSQL.Tasks.PostgreSqlMcpTaskStoreOptions>?`	Optional store options (TTL, table, listen channel).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options.

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder is `null`.
`ArgumentException`	Thrown when userId is `null` or whitespace.

WithPostgreSqlTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_PostgreSQL_McpServerBuilderExtensions

Enables MCP Tasks backed by PostgreSqlMcpTaskStore.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithPostgreSqlTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<string> getCurrentUserId, System.Action<CloudNimble.McpEssentials.PostgreSQL.Tasks.PostgreSqlMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getCurrentUserId`	`System.Func<string?>`	Returns the current user identifier, or `null` when unauthenticated.
`configure`	`System.Action<CloudNimble.McpEssentials.PostgreSQL.Tasks.PostgreSqlMcpTaskStoreOptions>?`	Optional store options (TTL, table, listen channel).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options.

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getCurrentUserId is `null`.

WithPostgreSqlTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_PostgreSQL_McpServerBuilderExtensions

Enables MCP Tasks backed by PostgreSqlMcpTaskStore, resolving the user from a ClaimsPrincipal.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithPostgreSqlTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.PostgreSQL.Tasks.PostgreSqlMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getPrincipal`	`System.Func<System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request.
`configure`	`System.Action<CloudNimble.McpEssentials.PostgreSQL.Tasks.PostgreSqlMcpTaskStoreOptions>?`	Optional store options (TTL, table, listen channel).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options.

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

WithPostgreSqlTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_PostgreSQL_McpServerBuilderExtensions

Enables MCP Tasks backed by PostgreSqlMcpTaskStore, resolving the user from services already registered in the built IServiceProvider. Register NpgsqlDataSource as a singleton first.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithPostgreSqlTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.PostgreSQL.Tasks.PostgreSqlMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getPrincipal`	`System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request. ASP.NET Core hosts call
`AddHttpContextAccessor()` and pass
`sp => sp.GetRequiredService<IHttpContextAccessor>().HttpContext?.User`.
`configure`	`System.Action<CloudNimble.McpEssentials.PostgreSQL.Tasks.PostgreSqlMcpTaskStoreOptions>?`	Optional store options (TTL, table, listen channel).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options.

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

WithRedisTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Redis_McpServerBuilderExtensions

Enables MCP Tasks backed by RedisMcpTaskStore for a single user.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithRedisTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, string userId, System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`userId`	`string`	The owner stamped on every task this process creates.
`configure`	`System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions>?`	Optional store options (TTL, key prefix, replica wait).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder is `null`.
`ArgumentException`	Thrown when userId is `null` or whitespace.

WithRedisTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Redis_McpServerBuilderExtensions

Enables MCP Tasks backed by RedisMcpTaskStore.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithRedisTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<string> getCurrentUserId, System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getCurrentUserId`	`System.Func<string?>`	Returns the current user identifier, or `null` when unauthenticated.
`configure`	`System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions>?`	Optional store options (TTL, key prefix, replica wait).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getCurrentUserId is `null`.

WithRedisTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Redis_McpServerBuilderExtensions

Enables MCP Tasks backed by RedisMcpTaskStore, resolving the user from a ClaimsPrincipal.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithRedisTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getPrincipal`	`System.Func<System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request.
`configure`	`System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions>?`	Optional store options (TTL, key prefix, replica wait).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

WithRedisTasks Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Redis_McpServerBuilderExtensions

Enables MCP Tasks backed by RedisMcpTaskStore, resolving the user from services already registered in the built IServiceProvider. Register IConnectionMultiplexer as a singleton first.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithRedisTasks(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getPrincipal`	`System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request. ASP.NET Core hosts call
`AddHttpContextAccessor()` and pass
`sp => sp.GetRequiredService<IHttpContextAccessor>().HttpContext?.User`.
`configure`	`System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions>?`	Optional store options (TTL, key prefix, replica wait).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

Examples

builder.Services.AddHttpContextAccessor();
builder.Services.AddSingleton&lt;IConnectionMultiplexer&gt;(
    _ =&gt; ConnectionMultiplexer.Connect(connectionString));
builder.Services.AddMcpServer()
    .WithHttpTransport()
    .WithRedisTasks(
        sp =&gt; sp.GetRequiredService&lt;IHttpContextAccessor&gt;().HttpContext?.User,
        o =&gt; o.DefaultTimeToLive = TimeSpan.FromMinutes(5));

WithTasksPlus Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Core_McpServerBuilderExtensions

Enables MCP Tasks and selects a plus store provider.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithTasksPlus(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder> configure, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`configure`	`System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder>`	Selects `UseInMemory` or a provider `Use*` method.
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or configure is `null`.
`InvalidOperationException`	Thrown when configure did not call a `Use*` method.

Examples

builder.Services.AddMcpServer()
    .WithHttpTransport()
    .WithTasksPlus(tasks =&gt; tasks.UseInMemory("local-user"));

WithTasksPlus Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Core_McpServerBuilderExtensions

Enables MCP Tasks backed by InMemoryMcpTaskStorePlus for a single user.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithTasksPlus(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, string userId, System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`userId`	`string`	The owner stamped on every task this process creates.
`configure`	`System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions>?`	Optional store options (TTL, poll interval).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder is `null`.
`ArgumentException`	Thrown when userId is `null` or whitespace.

WithTasksPlus Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Core_McpServerBuilderExtensions

Enables MCP Tasks backed by InMemoryMcpTaskStorePlus.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithTasksPlus(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<string> getCurrentUserId, System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getCurrentUserId`	`System.Func<string?>`	Returns the current user identifier, or `null` when unauthenticated.
`configure`	`System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions>?`	Optional store options (TTL, poll interval).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getCurrentUserId is `null`.

WithTasksPlus Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Core_McpServerBuilderExtensions

Enables MCP Tasks backed by InMemoryMcpTaskStorePlus, resolving the user from a ClaimsPrincipal.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithTasksPlus(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getPrincipal`	`System.Func<System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request. Invoked on each client-facing task operation.
Use the McpTasksOptions})
overload when the principal comes from DI.
`configure`	`System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions>?`	Optional store options (TTL, poll interval).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

WithTasksPlus Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Core_McpServerBuilderExtensions

Enables MCP Tasks backed by InMemoryMcpTaskStorePlus, resolving the user from services already registered in the built IServiceProvider.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithTasksPlus(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null)

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getPrincipal`	`System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request. Invoked on each client-facing task operation.
ASP.NET Core hosts call `AddHttpContextAccessor()` and pass
`sp => sp.GetRequiredService<IHttpContextAccessor>().HttpContext?.User`.
`configure`	`System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions>?`	Optional store options (TTL, poll interval).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

Examples

builder.Services.AddHttpContextAccessor();
builder.Services.AddMcpServer()
    .WithHttpTransport()
    .WithTasksPlus(
        sp =&gt; sp.GetRequiredService&lt;IHttpContextAccessor&gt;().HttpContext?.User,
        o =&gt; o.DefaultTimeToLive = TimeSpan.FromMinutes(5));

WithTasksPlus Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_EntityFrameworkCore_McpServerBuilderExtensions

Enables MCP Tasks backed by EFCoreMcpTaskStore1` for a single user.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithTasksPlus<TContext>(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, string userId, System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null) where TContext : Microsoft.EntityFrameworkCore.DbContext

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`userId`	`string`	The owner stamped on every task this process creates.
`configure`	`System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions>?`	Optional store options (TTL, poll interval).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Type Parameters

TContext - The host DbContext that maps McpTaskEntity.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder is `null`.
`ArgumentException`	Thrown when userId is `null` or whitespace.

WithTasksPlus Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_EntityFrameworkCore_McpServerBuilderExtensions

Enables MCP Tasks backed by EFCoreMcpTaskStore1`.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithTasksPlus<TContext>(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<string> getCurrentUserId, System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null) where TContext : Microsoft.EntityFrameworkCore.DbContext

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getCurrentUserId`	`System.Func<string?>`	Returns the current user identifier, or `null` when unauthenticated.
`configure`	`System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions>?`	Optional store options (TTL, poll interval).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Type Parameters

TContext - The host DbContext that maps McpTaskEntity.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getCurrentUserId is `null`.

WithTasksPlus Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_EntityFrameworkCore_McpServerBuilderExtensions

Enables MCP Tasks backed by EFCoreMcpTaskStore1`, resolving the user from a ClaimsPrincipal.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithTasksPlus<TContext>(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null) where TContext : Microsoft.EntityFrameworkCore.DbContext

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getPrincipal`	`System.Func<System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request.
`configure`	`System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions>?`	Optional store options (TTL, poll interval).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Type Parameters

TContext - The host DbContext that maps McpTaskEntity.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

WithTasksPlus Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_EntityFrameworkCore_McpServerBuilderExtensions

Enables MCP Tasks backed by EFCoreMcpTaskStore1`, resolving the user from services already registered in the built IServiceProvider.

Syntax

public static Microsoft.Extensions.DependencyInjection.IMcpServerBuilder WithTasksPlus<TContext>(Microsoft.Extensions.DependencyInjection.IMcpServerBuilder builder, System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions> configure = null, System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions> configureTasks = null) where TContext : Microsoft.EntityFrameworkCore.DbContext

Parameters

Name	Type	Description
`builder`	`Microsoft.Extensions.DependencyInjection.IMcpServerBuilder`	The MCP server builder.
`getPrincipal`	`System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request. ASP.NET Core hosts call
`AddHttpContextAccessor()` and pass
`sp => sp.GetRequiredService<IHttpContextAccessor>().HttpContext?.User`.
`configure`	`System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions>?`	Optional store options (TTL, poll interval).
`configureTasks`	`System.Action<ModelContextProtocol.Extensions.Tasks.McpTasksOptions>?`	Optional SDK Tasks options (execution-mode selector, and so on).

Returns

Type: Microsoft.Extensions.DependencyInjection.IMcpServerBuilder The server builder.

Type Parameters

TContext - The host DbContext that maps McpTaskEntity.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

Examples

builder.Services.AddHttpContextAccessor();
builder.Services.AddDbContext&lt;AppDbContext&gt;(o =&gt; o.UseSqlServer(connectionString));
builder.Services.AddMcpServer()
    .WithHttpTransport()
    .WithTasksPlus(tasks =&gt; tasks.UseEntityFramework&lt;AppDbContext&gt;(
        sp =&gt; sp.GetRequiredService&lt;IHttpContextAccessor&gt;().HttpContext?.User));

​Definition

​Syntax

​Summary

​Methods

​ WithCosmosTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithCosmosTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithCosmosTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithCosmosTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithPostgreSqlTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithPostgreSqlTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithPostgreSqlTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithPostgreSqlTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithRedisTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithRedisTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithRedisTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithRedisTasks Extension

​Syntax

​Parameters

​Returns

​Exceptions

​Examples

​ WithTasksPlus Extension

​Syntax

​Parameters

​Returns

​Exceptions

​Examples

​ WithTasksPlus Extension

​Syntax

​Parameters

​Returns

​Exceptions

​ WithTasksPlus Extension

​Syntax

​Parameters

​Returns

Definition

Syntax

Summary

Methods

WithCosmosTasks Extension

Syntax

Parameters

Returns

Exceptions

WithCosmosTasks Extension

Syntax

Parameters

Returns

Exceptions

WithCosmosTasks Extension

Syntax

Parameters

Returns

Exceptions

WithCosmosTasks Extension

Syntax

Parameters

Returns

Exceptions

WithPostgreSqlTasks Extension

Syntax

Parameters

Returns

Exceptions

WithPostgreSqlTasks Extension

Syntax

Parameters

Returns

Exceptions

WithPostgreSqlTasks Extension

Syntax

Parameters

Returns

Exceptions

WithPostgreSqlTasks Extension

Syntax

Parameters

Returns

Exceptions

WithRedisTasks Extension

Syntax

Parameters

Returns

Exceptions

WithRedisTasks Extension

Syntax

Parameters

Returns

Exceptions

WithRedisTasks Extension

Syntax

Parameters

Returns

Exceptions

WithRedisTasks Extension

Syntax

Parameters

Returns

Exceptions

Examples

WithTasksPlus Extension

Syntax

Parameters

Returns

Exceptions

Examples

WithTasksPlus Extension

Syntax

Parameters

Returns

Exceptions

WithTasksPlus Extension

Syntax

Parameters

Returns