title	description	ms.date	ms.topic	author
Quickstart - Create a minimal MCP client using .NET	Learn to create a minimal MCP client and connect it to an MCP server using .NET	05/27/2025	quickstart	alexwolfmsft

Create a minimal MCP client using .NET

In this quickstart, you build a minimal Model Context Protocol (MCP) client using the C# SDK for MCP. You also learn how to configure the client to connect to an MCP server, such as the one created in the Build a minimal MCP server quickstart.

Prerequisites

.NET 8.0 SDK or higher
Visual Studio Code

Note

The MCP client you build in the sections ahead connects to the sample MCP server from the Build a minimal MCP server quickstart. You can also use your own MCP server if you provide your own connection configuration.

Create the .NET host app

Complete the following steps to create a .NET console app. The app acts as a host for an MCP client that connects to an MCP server.

Create the project

In a terminal window, navigate to the directory where you want to create your app, and create a new console app with the dotnet new command:
```
dotnet new console -n MCPHostApp
```
Navigate into the newly created project folder:
```
cd MCPHostApp
```

Run the following commands to add the necessary NuGet packages:

dotnet add package Azure.AI.OpenAI --prerelease
dotnet add package Azure.Identity
dotnet add package Microsoft.Extensions.AI
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
dotnet add package ModelContextProtocol --prerelease

Open the project folder in your editor of choice, such as Visual Studio Code:
```
code .
```

Add the app code

Replace the contents of Program.cs with the following code:

:::code language="csharp" source="snippets/mcp-client/program.cs" :::

The preceding code accomplishes the following tasks:

Initializes an IChatClient abstraction using the Microsoft.Extensions.AI libraries.
Creates an MCP client and configures it to connect to your MCP server.
Retrieves and displays a list of available tools from the MCP server, which is a standard MCP function.
Implements a conversational loop that processes user prompts and utilizes the tools for responses.

Run and test the app

Complete the following steps to test your .NET host app:

In a terminal window open to the root of your project, run the following command to start the app:
```
dotnet run
```
Once the app is running, enter a prompt to run the ReverseEcho tool:
```
Reverse the following: "Hello, minimal MCP server!"
```
Verify that the server responds with the echoed message:
```
!revres PCM laminim ,olleH
```

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!