What are the runtime dependencies?

You need the .NET 9 SDK, Visual Studio Code with C# Dev Kit, node.js LTS, Docker Desktop or Podman Desktop, and an Azure subscription with an Azure AI Foundry instance.

Where does the data live?

The to‑do data is managed by the remote MCP server, which is deployed in your own Azure Container Apps environment. No data is stored outside your Azure subscription.

What credentials does it need?

It reads `AOAI_USE_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

.NET OpenAI MCP Agent MCP Server

Sample to create an AI Agent using OpenAI models with any MCP server running on Azure Container Apps

Local serverstdioTypeScript

What is the .NET OpenAI MCP Agent MCP Server?

Sample to create an AI Agent using OpenAI models with any MCP server running on Azure Container Apps

What the server does

This is an MCP agent app written in .NET, using Azure OpenAI, with a remote MCP server written in TypeScript.

The MCP host + MCP client app is written in .NET Blazor
The MCP client app connects to a to-do MCP server written in TypeScript
Both MCP client and server apps are running on Azure Container Apps (ACA)
The MCP client app is secured by the built-in auth of ACA
The MCP server app is only accessible from the MCP client app

Credentials and setup notes

.NET 9 SDK - Visual Studio Code + C# Dev Kit - node.js LTS - Docker Desktop or Podman Desktop -

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
csharp	bicep
azure-openai	azure-container-apps

Configuration

.NET 9 SDK - Visual Studio Code + C# Dev Kit - node.js LTS - Docker Desktop or Podman Desktop -

Variable	Description	Required
AOAI_USE_API_KEY	Credential the server authenticates with.	Yes

Example prompts to try

“Use .NET OpenAI MCP Agent to csharp.”
“Use .NET OpenAI MCP Agent to azure-openai.”

Frequently asked questions

This agent provides a full C#/.NET MCP host and client that talks to a remote TypeScript MCP server. It is a sample to illustrate the MCP pattern using Azure OpenAI and Azure Container Apps.

Alternatives to the .NET OpenAI MCP Agent MCP Server

n8n

Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.

Developer ToolsRemoteTypeScript★ 22.5k

AWS

Official

AWS Labs' official server suite — current AWS docs, CDK guidance, cost analysis and service tools.

Cloud & DevOpsPython★ 7.0k

Use Aws MCP

🌟 amazon-q-cli is great, and it is great because it has `use_aws` MCP tool to interact with AWS API.

Cloud & DevOps

Mcp-kubernetes

A Model Context Protocol server for Kubernetes. It lets an MCP-capable client (Claude Desktop, Claude Code, etc.) inspect and operate Kubernetes clusters across multiple contexts — with behaviour…