Adaptive-MCP-System

> A production-ready, multi-agent AI chat system built with .NET C#, Microsoft Orleans, and MCP — your own scalable ChatGPT alternative using free API tiers.

[](https://dotnet.microsoft.com) [](https://learn.microsoft.com/dotnet/orleans) [](https://github.com/modelcontextprotocol/csharp-sdk) [](LICENSE)

---

<p align="center"> </p>

• Multi-Agent Architecture — Route messages to specialized agents (coder, analyst, general)
• Microsoft Orleans — Scalable, distributed actor model with per-user grain state
• Persistent Chat History — Each user's conversation stored in Orleans grain storage
• MCP Tool Integration — Plug-and-play tools: web search, datetime, code execution
• Free LLM Providers — Google Gemini Flash (free tier) + Groq/Llama3 fallback
• Agentic Loop — LLM autonomously calls tools until it has a final answer
• REST API — Clean ASP.NET Core endpoints for chat, history, and agent selection

---

User Request
     │
     ▼
ASP.NET Core API  (/api/chat/{userId})
     │
     ▼
Orleans Silo (in-process)
 ├── ChatGrain          ← per-user state & history (IGrainWithStringKey)
 └── AgentOrchestratorGrain
      ├── GeneralAgentGrain
      ├── CoderAgentGrain
      └── AnalystAgentGrain
           │
           ▼
      MCP Client Layer
       ├── web_search  (Tavily API — free)
       ├── get_datetime
       └── code_runner
           │
           ▼
      LLM Provider
       ├── Google Gemini 1.5 Flash  (primary — free tier)
       └── Groq / Llama3-70B        (fallback — free tier)

<p align="center"> <img s