Intellectus.AIAgent.MCPServer 1.0.0

Intellectus AI Agent MCP Server

Packages	Version	Downloads
Intellectus.AIAgent.Framework
Intellectus.AIAgent.MCPServer
Intellectus.AIAgent.MCPServer.Client
ts-intellectus-aiagent-mcpserver-client

Overview

Library provides an OpenAI Agent for .NET applications.

The agent is designed to facilitate communication between your application and OpenAI's large language models (LLMs),

enabling you to build intelligent conversational interfaces.

You can tell the Agent about your tools & the Agent can figure out which tool to use, given a natural language input.

Model Context Protocol (MCP) Server

You can use the Intellectus.AIAgent.MCPServer package to build an MCP Server.

All your Tools reside in your Server. The Server communicates with OpenAI LLMs.

The Clients talk to the Server using HTTP/stdio and get a response back.

Sample Server

Create a Console project.

In the .csproj,

change the SDK to Web as shown below:

<Project Sdk="Microsoft.NET.Sdk.Web">

and add below properties in the PropertyGroup.

<RuntimeIdentifiers>win-x64;win-arm64;osx-arm64;linux-x64;linux-arm64;linux-musl-x64</RuntimeIdentifiers>


<SelfContained>true</SelfContained>
<PublishSelfContained>true</PublishSelfContained>


<PublishSingleFile>true</PublishSingleFile>

Then, hook up your server in Program.cs as shown below:

using Intellectus.AIAgent.Framework;
using Intellectus.AIAgent.MCPServer;
using MCPServer.Sample;

Console.WriteLine("Intellectus AI Agent MCP Server...");

var builder = WebApplication.CreateBuilder(args);

var apiKey = Environment.GetEnvironmentVariable("OPENAI_API_KEY");

// Register tools with DI
builder.Services.AddScoped<ITool, SalesTool>();
builder.Services.AddScoped<ITool, ProductTool>();

// Register the server and configure settings
builder.Services.AddIntellectusMCPServer(settings =>
{
    settings.OpenAIAPIKey = apiKey;
    settings.OpenAILLMModel = "gpt-4o-mini";
    settings.ReasoningResult = @"<ProductName>:<Year>
                                    Year is optional.
                                ";
    //Add tools without using DI
    //settings.Tools = new List<ITool> { new SalesTool(), new ProductTool() };
});

var app = builder.Build();

app.UseIntellectusMCPServer();

await app.RunAsync();

To call the MCP Server using HTTP, use a JSON request like below:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ai_agent_respond",
    "arguments": {
      "userInput": "<--Your input here-->"
    }
  }
}

Sample MCP Server

Sample Client

Tests