{"id":2273,"date":"2025-07-22T17:34:16","date_gmt":"2025-07-22T17:34:16","guid":{"rendered":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/2025\/07\/22\/mcp-c-sdk-gets-major-update-support-for-protocol-version-2025-06-18\/"},"modified":"2025-07-22T17:34:16","modified_gmt":"2025-07-22T17:34:16","slug":"mcp-c-sdk-gets-major-update-support-for-protocol-version-2025-06-18","status":"publish","type":"post","link":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/2025\/07\/22\/mcp-c-sdk-gets-major-update-support-for-protocol-version-2025-06-18\/","title":{"rendered":"MCP C# SDK Gets Major Update: Support for Protocol Version 2025-06-18"},"content":{"rendered":"

The Model Context Protocol (MCP) continues to evolve, and we\u2019re excited to announce that the MCP C# SDK now supports the latest specification version 2025-06-18<\/a>. This update brings significant new capabilities to .NET developers building AI applications, including an improved authentication protocol, elicitation support, structured tool output, and support for resource links in tool responses.<\/p>\n

Whether you\u2019re building AI assistants, automation tools, or integrating AI capabilities into existing .NET applications, these new features will help you create more robust and secure solutions.<\/p>\n

Here\u2019s a rundown of the new features and how to access them with the MCP C# SDK.<\/p>\n

Improved Authentication Protocol<\/h2>\n

The 2025-06-18 specification introduces a new authentication protocol<\/strong> that enhances security and flexibility for AI applications. The new protocol separates the roles of authentication server and resource server, allowing easier integration with existing OAuth 2.0 and OpenID Connect providers.<\/p>\n

This is a large topic and has already been covered in detail in a separate blog post by Den Delimarsky, OAuth In The MCP C# SDK: Simple, Secure, Standard<\/a>.<\/p>\n

Elicitation: Interactive User Engagement<\/h2>\n

One of the most significant additions is the elicitation<\/strong> feature, which allows servers to request additional information from users during interactions. This enables more dynamic and interactive AI experiences, making it easier to gather necessary context before executing tasks.<\/p>\n

Server Support for Elicitation<\/h3>\n

Servers request structured data from users with the ElicitAsync<\/a> extension method on IMcpServer<\/a>.
\nThe C# SDK registers an instance of IMcpServer<\/a> with the dependency injection container,
\nso tools can simply add a parameter of type IMcpServer<\/a> to their method signature to access it.<\/p>\n

The MCP Server must specify the schema of each input value it is requesting from the user.
\nOnly primitive types (string, number, boolean) are supported for elicitation requests.
\nThe schema may include a description to help the user understand what is being requested.<\/p>\n

The server can request a single input or multiple inputs at once.
\nTo help distinguish multiple inputs, each input has a unique name.<\/p>\n

The following example demonstrates how a server could request a boolean response from the user.<\/p>\n

[McpServerTool, Description(“A simple game where the user has to guess a number between 1 and 10.”)]
\npublic async Task<string> GuessTheNumber(
\n IMcpServer server, \/\/ Get the McpServer from DI container
\n CancellationToken token
\n)
\n{
\n \/\/ First ask the user if they want to play
\n var playSchema = new RequestSchema
\n {
\n Properties =
\n {
\n [“Answer”] = new BooleanSchema()
\n }
\n };<\/p>\n

var playResponse = await server.ElicitAsync(new ElicitRequestParams
\n {
\n Message = “Do you want to play a game?”,
\n RequestedSchema = playSchema
\n }, token);<\/p>\n

\/\/ Check if user wants to play
\n if (playResponse.Action != “accept” || playResponse.Content?[“Answer”].ValueKind != JsonValueKind.True)
\n {
\n return “Maybe next time!”;
\n }<\/p>\n

\/\/ remaining implementation of GuessTheNumber method<\/p>\n

Client Support for Elicitation<\/h3>\n

Elicitation is an optional feature so clients declare their support for it in their capabilities as part of the initialize request. In the MCP C# SDK, this is done by configuring an ElicitationHandler<\/a> in the McpClientOptions<\/a>:<\/p>\n

McpClientOptions options = new()
\n{
\n ClientInfo = new()
\n {
\n Name = “ElicitationClient”,
\n Version = “1.0.0”
\n },
\n Capabilities = new()
\n {
\n Elicitation = new()
\n {
\n ElicitationHandler = HandleElicitationAsync
\n }
\n }
\n};<\/p>\n

The ElicitationHandler is an asynchronous method that will be called when the server requests additional information.
\nThe ElicitationHandler must request input from the user and return the data in a format that matches the requested schema.
\nThis will be highly dependent on the client application and how it interacts with the user.<\/p>\n

If the user provides the requested information, the ElicitationHandler should return an [ElicitResult] with the action set to \u201caccept\u201d and the content containing the user\u2019s input.
\nIf the user does not provide the requested information, the ElicitationHandler should return an [ElicitResult] with the action set to \u201creject\u201d and no content.<\/p>\n

Below is an example of how a console application might handle elicitation requests.
\nHere\u2019s an example implementation:<\/p>\n

async ValueTask<ElicitResult> HandleElicitationAsync(ElicitRequestParams? requestParams, CancellationToken token)
\n{
\n \/\/ Bail out if the requestParams is null or if the requested schema has no properties
\n if (requestParams?.RequestedSchema?.Properties == null)
\n {
\n return new ElicitResult(); \/\/ New ElicitResult with default Action “reject”
\n }<\/p>\n

\/\/ Process the elicitation request
\n if (requestParams?.Message is not null)
\n {
\n Console.WriteLine(requestParams.Message);
\n }<\/p>\n

var content = new Dictionary<string, JsonElement>();<\/p>\n

\/\/ Loop through requestParams.requestSchema.Properties dictionary requesting values for each property
\n foreach (var property in requestParams.RequestedSchema.Properties)
\n {
\n if (property.Value is ElicitRequestParams.BooleanSchema booleanSchema)
\n {
\n Console.Write($”{booleanSchema.Description}: “);
\n var clientInput = Console.ReadLine();
\n bool parsedBool;
\n if (bool.TryParse(clientInput, out parsedBool))
\n {
\n content[property.Key] = JsonSerializer.Deserialize<JsonElement>(JsonSerializer.Serialize(parsedBool));
\n }
\n }
\n else if (property.Value is ElicitRequestParams.NumberSchema numberSchema)
\n {
\n Console.Write($”{numberSchema.Description}: “);
\n var clientInput = Console.ReadLine();
\n double parsedNumber;
\n if (double.TryParse(clientInput, out parsedNumber))
\n {
\n content[property.Key] = JsonSerializer.Deserialize<JsonElement>(JsonSerializer.Serialize(parsedNumber));
\n }
\n }
\n else if (property.Value is ElicitRequestParams.StringSchema stringSchema)
\n {
\n Console.Write($”{stringSchema.Description}: “);
\n var clientInput = Console.ReadLine();
\n content[property.Key] = JsonSerializer.Deserialize<JsonElement>(JsonSerializer.Serialize(clientInput));
\n }
\n }<\/p>\n

\/\/ Return the user’s input
\n return new ElicitResult
\n {
\n Action = “accept”,
\n Content = content
\n };
\n}<\/p>\n

Structured Tool Output<\/h2>\n

Another important addition in the 2025-06-18 spec is support for structured tool output<\/strong>.
\nPreviously, tool results were allowed to contain structured data but the host\/LLM had to perform the parsing and interpretation
\nwithout any guidance from the tool itself.
\nNow, tools can return structured content that is explicitly defined, allowing AI models to better understand and process the output.<\/p>\n

The C# SDK supports this by allowing tools to specify that their output is structured, with the UseStructuredContent<\/a> parameter
\nof the McpServerTool<\/a> attribute.<\/p>\n

[McpServerTool(UseStructuredContent = true), Description(“Gets a list of structured product data with detailed information.”)]
\npublic static List<Product> GetProducts(int count = 5)<\/p>\n

The C# SDK will generate a JSON schema for the tool\u2019s output based on the return type of the method
\nand will include this schema in the tool\u2019s metadata. Here is an example of the response to a tools\/list call
\nthat shows the output schema for the get_products tool:<\/p>\n

{
\n “result”: {
\n “tools”: [
\n {
\n “name”: “get_products”,
\n “description”: “Gets a list of structured product data with detailed information.”,
\n “inputSchema”: {
\n “type”: “object”,
\n “properties”: {
\n “count”: {
\n “type”: “integer”,
\n “default”: 5
\n }
\n }
\n },
\n “outputSchema”: {
\n “type”: “object”,
\n “properties”: {
\n “result”: {
\n “type”: “array”,
\n “items”: {
\n “type”: “object”,
\n “properties”: {
\n “id”: {
\n “description”: “Unique identifier for the product”,
\n “type”: “integer”
\n },
\n “name”: {
\n “description”: “Name of the product”,
\n “type”: “string”
\n },
\n…<\/p>\n

And when the tool is called, the tool response will include the structured output in the result.structuredContent field:<\/p>\n

{
\n “result”: {
\n “content”: [
\n {
\n “type”: “text”,
\n “text”: “<text content>”
\n }
\n ],
\n “structuredContent”: {
\n “result”: [
\n {
\n “id”: 1,
\n “name”: “Laptop Pro”,
\n “description”: “High-quality laptop pro for professional use”,
\n “price”: 278,
\n “category”: “Electronics”,
\n “brand”: “TechCorp”,
\n “inStock”: 24,
\n “rating”: 4.3,
\n “features”: [
\n “Durable construction”,
\n “Modern design”,
\n “Easy to use”
\n ],
\n “specifications”: {
\n “Weight”: “1 lbs”,
\n “Dimensions”: “12x12x2 inches”,
\n “Warranty”: “2 years”
\n }
\n },
\n …
\n ]
\n }
\n },
\n “id”: 2,
\n “jsonrpc”: “2.0”
\n}<\/p>\n

Resource Links in Tool Results<\/h2>\n

Tools can now include resource links<\/strong> in their results, enabling better resource discovery and navigation.
\nThis is particularly useful for tools that create or manage resources, allowing clients to easily access and interact with those resources.<\/p>\n

In the following example, a tool creates a resource with a random value and returns a link to this resource:<\/p>\n

[McpServerTool]
\n[Description(“Creates a resource with a random value and returns a link to this resource.”)]
\npublic async Task<CallToolResult> MakeAResource()
\n{
\n int id = new Random().Next(1, 101); \/\/ 1 to 100 inclusive<\/p>\n

var resource = ResourceGenerator.CreateResource(id);<\/p>\n

var result = new CallToolResult();<\/p>\n

result.Content.Add(new ResourceLinkBlock()
\n {
\n Uri = resource.Uri,
\n Name = resource.Name
\n });<\/p>\n

return result;
\n}<\/p>\n

Schema Improvements<\/h2>\n

Beyond the major features, several schema improvements enhance the developer experience:<\/p>\n

Enhanced Metadata Support<\/h3>\n

The _meta field is now available on more interface types, providing better extensibility:<\/p>\n

public class CustomTool : Tool
\n{
\n public ToolMetadata Meta { get; set; } = new()
\n {
\n [“version”] = “1.0.0”,
\n [“author”] = “Your Name”,
\n [“category”] = “data-analysis”
\n };
\n}<\/p>\n

Human-Friendly Titles<\/h3>\n

<\/p>\n

Tools, Resources, and Prompts all now support separate name and title fields.<\/p>\n

In the MCP C# SDK, you can specify a title for your tool using the Title property of the McpServerTool<\/a> attribute.<\/p>\n

[McpServerToolType]
\npublic class EchoTool
\n{
\n [McpServerTool(Name = “echo”, Title = “Echo Tool”)]
\n [Description(“Echoes the message back to the client.”)]
\n public static string Echo(string message) => $”Echo: {message}”;
\n}<\/p>\n

This produces the following tool metadata in the tools\/list response:<\/p>\n

“tools”: [
\n {
\n “name”: “echo”,
\n “title”: “Echo Tool”,
\n “description”: “Echoes the message back to the client.”,
\n “inputSchema”: {
\n “type”: “object”,
\n “properties”: {
\n “message”: {
\n “type”: “string”
\n }
\n },
\n “required”: [
\n “message”
\n ]
\n },<\/p>\n

The name and title parameters of the McpServerTool<\/a> attribute are optional.
\nIf not specified, the name defaults to the lower snake case form of the method name and the title defaults to an empty string.<\/p>\n

Getting Started with the Updated SDK<\/h2>\n

To start using these new features, update your MCP C# SDK package:<\/p>\n

dotnet add package ModelContextProtocol –prerelease<\/p>\n

When implementing these new capabilities, consider the following best practices:<\/p>\n

Always implement proper OAuth flows for production applications
\nUse resource indicators to prevent token misuse
\nValidate all elicited user input
\nFollow the security best practices<\/a> outlined in the specification<\/p>\n

What\u2019s Next<\/h2>\n

The MCP ecosystem continues to grow, and we\u2019re committed to keeping the C# SDK up-to-date with the latest specification changes.<\/p>\n

The MCP C# SDK is open source and we welcome contributions! Whether you\u2019re reporting bugs, suggesting features, or contributing code, your involvement helps make the SDK better for everyone.<\/p>\n

GitHub Repository<\/strong>: modelcontextprotocol\/csharp-sdk<\/a>
\nDocumentation<\/strong>: MCP C# SDK Docs<\/a>
\nSamples<\/strong>: MCP C# Samples<\/a><\/p>\n

Summary<\/h2>\n

The MCP C# SDK\u2019s support for protocol version 2025-06-18 brings powerful new capabilities to .NET developers building AI applications. With the new authentication protocol, elicitation support, structured tool output, and support for resource links in tool results, you can create more sophisticated and secure AI integrations than ever before.<\/p>\n

Start exploring these new features today by updating your SDK and reviewing the updated documentation. The future of AI application development with .NET just got brighter!<\/p>\n\n

Get Started with MCP C# SDK<\/a><\/div>\n

The post MCP C# SDK Gets Major Update: Support for Protocol Version 2025-06-18<\/a> appeared first on .NET Blog<\/a>.<\/p>","protected":false},"excerpt":{"rendered":"

The Model Context Protocol (MCP) continues to evolve, and we\u2019re excited to announce that the MCP C# SDK now supports […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[7],"tags":[],"class_list":["post-2273","post","type-post","status-publish","format-standard","hentry","category-dotnet"],"_links":{"self":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts\/2273","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/comments?post=2273"}],"version-history":[{"count":0,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts\/2273\/revisions"}],"wp:attachment":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/media?parent=2273"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/categories?post=2273"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/tags?post=2273"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}