README.md

🚀 IntegraChat

Multi-Tenant Autonomous MCP Platform

Enterprise-grade AI with autonomous agents, secure multi-tenant RAG, real-time web search, red-flag governance, and analytics.

---

📑 Table of Contents

• Overview
• Purpose
• Key Features
• Technology Stack
• System Architecture
• Project Structure
• Getting Started
• Why IntegraChat Stands Out
• Submission Metadata
• License

---

📌 Overview

IntegraChat is an enterprise-ready, multi-tenant AI platform built to demonstrate the full capabilities of the Model Context Protocol (MCP) in a real production-style environment.

It combines autonomous tool-using agents, RAG retrieval, live web search, and admin governance under strict tenant isolation, powered by Groq's Llama-3.1-8B.

IntegraChat is a complete "MCP in Action" ecosystem — ideal for enterprise demos, research, production scaffolds, and governance-focused AI deployments.

---

🎯 Purpose

IntegraChat showcases how MCP can power intelligent, governed, multi-tenant AI systems with real-world requirements:

• 🔒 Isolation & Access Control - Strict tenant separation
• 🛡️ Compliance & Red-Flag Detection - Automated safety monitoring
• 🤖 Tool-Aware Autonomous Reasoning - Dynamic tool selection
• 🔍 RAG + Web Search Hybrid AI - Best of both worlds
• 📊 Analytics & Observability - Full system insights
• ⚙️ Admin Governance Workflows - Enterprise-ready controls

---

🧩 Key Features

1. 🤖 Autonomous MCP Agents

Agents can intelligently:

• ✅ Analyze user intent and context
• ✅ Detect sensitive or unsafe content
• ✅ Dynamically select tools (RAG, Web, Admin, etc.)
• ✅ Retrieve tenant-private knowledge
• ✅ Pull real-time data from the internet
• ✅ Trigger admin alerts when needed
• ✅ Respond using Groq's Llama-3.1-8B

2. 📚 Enterprise RAG System

• MiniLM embeddings for semantic search
• Supabase + pgvector for vector storage
• Strict multi-tenant RLS enforcement for security
• Multiple format support: PDF / DOCX / TXT / URL ingestion
• Intelligent chunking + semantic search

3. 🌐 Live Web Search Tool

• Real-time news and information
• General web search capabilities
• Fact-checking & fresh data retrieval
• Multiple provider support (DuckDuckGo, SerpAPI, Bing)

4. 🚨 Red-Flag Governance Engine

Admins configure rules to:

• ⛔ Block unsafe queries automatically
• 📝 Log violations for audit trails
• 🔔 Trigger admin alerts in real-time

Example rules: salary, delete all data, confidential client info

5. 📊 Analytics Dashboard

Comprehensive insights for:

• 📈 Query volume and trends
• 🔧 Tool usage statistics
• 🎯 RAG performance metrics
• 🚨 Red-flag violation tracking
• 🧠 Agent reasoning traces
• 👥 Tenant activity monitoring

6. 🏢 Multi-Tenant Isolation

Each tenant gets:

• 🔐 Private agents
• 📦 Private knowledge base
• ⚙️ Private admin rules
• 📊 Private analytics

Isolation is guaranteed via Supabase Row-Level Security (RLS).

---

🛠 Technology Stack

Backend

Technology	Purpose
FastAPI	High-performance API framework
MCP Client + Servers	Model Context Protocol implementation
Supabase	Auth + Storage + pgvector database
MiniLM Embeddings	Semantic search embeddings
Groq Llama-3.1-8B	LLM inference engine
DuckDuckGo Search	Web search provider
Slack / Email	Alerting system

Frontend

Technology	Purpose
React 18	Modern UI framework
TailwindCSS	Utility-first styling
Zustand	State management
WebSocket	Real-time streaming
Admin Dashboard	Analytics & governance UI

---

🧱 System Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Frontend (React)                         │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  │
│  │ Chat UI  │  │  Admin   │  │Analytics │  │WebSocket │  │
│  │          │  │  Panel   │  │ Dashboard│  │Streaming │  │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘  │
└─────────────────────────────────────────────────────────────┘
                            ↕ HTTP/WebSocket
┌─────────────────────────────────────────────────────────────┐
│              MCP Client (FastAPI)                           │
│  • Intent handling                                          │
│  • Red-flag scanning                                        │
│  • Tool selection logic                                     │
│  • Groq Llama-3.1 integration                              │
│  • Event logging                                            │
└─────────────────────────────────────────────────────────────┘
                            ↕ MCP Protocol
┌─────────────────────────────────────────────────────────────┐
│                    MCP Servers                              │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐     │
│  │ RAG Server   │  │ Web Search   │  │ Admin Server │     │
│  │ (Knowledge)  │  │   (Live)     │  │ (Governance) │     │
│  └──────────────┘  └──────────────┘  └──────────────┘     │
└─────────────────────────────────────────────────────────────┘
                            ↕
┌─────────────────────────────────────────────────────────────┐
│              Supabase Database                              │
│  • Authentication                                           │
│  • pgvector (embeddings)                                    │
│  • Row-Level Security (RLS)                                 │
│  • Storage                                                  │
└─────────────────────────────────────────────────────────────┘

---

📁 Project Structure

IntegraChat/
├── backend/
│   ├── api/
│   │   ├── main.py
│   │   ├── routes/
│   │   │   ├── agent.py
│   │   │   ├── rag.py
│   │   │   ├── web.py
│   │   │   ├── admin.py
│   │   │   └── analytics.py
│   │   ├── services/
│   │   │   ├── agent_orchestrator.py
│   │   │   ├── intent_classifier.py
│   │   │   ├── redflag_detector.py
│   │   │   ├── tool_selector.py
│   │   │   ├── prompt_builder.py
│   │   │   └── llm_client.py
│   │   ├── mcp_clients/
│   │   │   ├── rag_client.py
│   │   │   ├── web_client.py
│   │   │   └── admin_client.py
│   │   ├── models/
│   │   │   ├── requests.py
│   │   │   ├── responses.py
│   │   │   ├── agent_decision.py
│   │   │   └── embeddings.py
│   │   ├── utils/
│   │   │   ├── logging.py
│   │   │   ├── supabase_client.py
│   │   │   ├── tenant_context.py
│   │   │   └── security.py
│   │   └── config.py
│   │
│   ├── mcp_servers/
│   │   ├── rag_server/
│   │   │   ├── main.py
│   │   │   ├── chunker.py
│   │   │   ├── search.py
│   │   │   ├── embeddings.py
│   │   │   ├── ingestion/
│   │   │   │   ├── ingest_pdf.py
│   │   │   │   ├── ingest_docx.py
│   │   │   │   ├── ingest_txt.py
│   │   │   │   └── ingest_url.py
│   │   │   ├── db/
│   │   │   │   ├── documents_repo.py
│   │   │   │   └── embeddings_repo.py
│   │   │   └── config.py
│   │   │
│   │   ├── web_server/
│   │   │   ├── main.py
│   │   │   ├── providers/
│   │   │   │   ├── ddg.py
│   │   │   │   ├── serpapi.py (optional)
│   │   │   │   └── bing.py (optional)
│   │   │   └── utils.py
│   │   │
│   │   └── admin_server/
│   │       ├── main.py
│   │       ├── redflag_rules.py
│   │       ├── alerts/
│   │       │   ├── slack.py
│   │       │   ├── email.py
│   │       │   └── webhook.py
│   │       └── audit_logs.py
│   │
│   ├── workers/
│   │   ├── ingestion_worker.py
│   │   ├── analytics_worker.py
│   │   ├── scheduler.py
│   │   └── celeryconfig.py
│   │
│   ├── tests/
│   │   ├── test_agent.py
│   │   ├── test_rag.py
│   │   ├── test_admin.py
│   │   ├── test_web.py
│   │   └── test_end_to_end.py
│   │
│   └── Dockerfile
│
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   │   ├── chat/
│   │   │   │   ├── ChatWindow.jsx
│   │   │   │   ├── MessageBubble.jsx
│   │   │   │   └── ToolTraces.jsx
│   │   │   ├── admin/
│   │   │   │   ├── RedFlagEditor.jsx
│   │   │   │   └── TenantManager.jsx
│   │   │   └── analytics/
│   │   │       ├── QueryStats.jsx
│   │   │       ├── ToolUsageChart.jsx
│   │   │       └── RagEffectiveness.jsx
│   │   ├── pages/
│   │   │   ├── ChatPage.jsx
│   │   │   ├── AdminPage.jsx
│   │   │   └── AnalyticsPage.jsx
│   │   ├── store/
│   │   │   ├── chatStore.js
│   │   │   ├── adminStore.js
│   │   │   └── analyticsStore.js
│   │   ├── utils/
│   │   │   ├── websocket.js
│   │   │   ├── api.js
│   │   │   └── formatters.js
│   │   ├── App.jsx
│   │   └── main.jsx
│   ├── public/
│   └── package.json
│
├── supabase/
│   ├── migrations/
│   │   ├── 001_init.sql
│   │   ├── 002_embeddings.sql
│   │   ├── 003_redflag_rules.sql
│   │   └── 004_analytics_tables.sql
│   ├── seed/
│   │   ├── default_redflags.sql
│   │   └── demo_tenants.sql
│   ├── policies/
│   │   ├── rls_tenant_documents.sql
│   │   ├── rls_tenant_embeddings.sql
│   │   └── rls_admin_rules.sql
│   ├── functions/
│   │   └── vector_search.sql
│   └── README.md
│
├── docs/
│   ├── architecture-diagram.png
│   ├── sequence-mcp-agent.png
│   ├── api-spec.md
│   ├── mcp-server-protocol.md
│   └── rag-pipeline.md
│
├── scripts/
│   ├── run_dev.sh
│   ├── build_all.sh
│   ├── reset_db.sh
│   └── run_workers.sh
│
├── docker-compose.yml
├── README.md
└── LICENSE

---

🚀 Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

• ✅ Python 3.10+
• ✅ Node.js 18+
• ✅ Supabase project (with pgvector extension)
• ✅ Groq API key
• ✅ DuckDuckGo Search key (optional, if configured)
• ✅ Slack/Email webhook for alerts (optional)

Backend Setup

1. Navigate to backend directory

   cd backend
   

2. Install dependencies

   pip install -r requirements.txt
   

3. Configure environment variables

   cp .env.example .env
   # Edit .env and fill in your Supabase + Groq keys
   

4. Run the development server

   uvicorn api.main:app --reload
   

Frontend Setup

1. Navigate to frontend directory

   cd frontend
   

2. Install dependencies

   npm install
   

3. Start the development server

   npm run dev
   

Quick Start with Docker

docker-compose up -d

---

✨ Why IntegraChat Stands Out

Feature	Description
🤖 True MCP-Native	Autonomous agents (not static prompts)
🛡️ Enterprise Governance	Regex-based red-flag rules system
🔍 Hybrid Intelligence	RAG + web search reasoning
🏢 Production-Grade	Multi-tenant design with strict Supabase RLS
📊 Full Observability	Logs, analytics, tool events, violations
🎯 Demo-Ready	Perfect for enterprise presentations

---

🏷 Submission Metadata

Field	Value
Track	MCP in Action
Category	Enterprise
Tag	mcp-in-action-track-enterprise
Project Name	IntegraChat

Short Summary

IntegraChat is a multi-tenant AI platform where autonomous MCP-powered agents retrieve private knowledge using RAG, access live web information, and enforce admin-defined safety rules via a red-flag compliance system. It includes an analytics dashboard, tool-selection engine, and strict tenant isolation.

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

📬 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

🙏 Acknowledgments

• Built with Model Context Protocol (MCP)
• Powered by Groq for LLM inference
• Database powered by Supabase

---

Made with ❤️ for the MCP community

⬆ Back to Top