README.md

---
title: CX AI Agent - B2B Sales Intelligence
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
pinned: false
license: mit
short_description: AI-powered B2B sales automation with MCP tools
tags:
- mcp-in-action-track-enterprise
- mcp
- autonomous-agent
- b2b-sales
- prospect-discovery
- email-automation
- gradio
- huggingface
- qwen
- sales-intelligence
---

# 🤖 CX AI Agent - B2B Sales Intelligence Platform

[![Enterprise Application](https://img.shields.io/badge/MCP-Enterprise%20Track-blue)](https://github.com)
[![Powered by AI](https://img.shields.io/badge/Powered%20by-HuggingFace-yellow)](https://huggingface.co)
[![Gradio](https://img.shields.io/badge/Built%20with-Gradio-orange)](https://gradio.app)

> **🏆 MCP in Action Track - Enterprise Applications**
>
> Tag: `mcp-in-action-track-enterprise`

## 📹 Overview

An AI-powered B2B sales automation platform that helps sales teams discover prospects, find decision-makers, and draft personalized outreach emails—all powered by autonomous AI agents using the **Model Context Protocol (MCP)**.

## 🎯 Key Features

| Feature | Description |
|---------|-------------|
| **🔍 AI Discovery** | Automatically find and research prospect companies matching your ideal customer profile |
| **👥 Contact Finder** | Locate decision-makers (CEOs, VPs, Founders) with verified email addresses |
| **✉️ Email Drafting** | Generate personalized cold outreach emails based on company research |
| **💬 AI Chat** | Interactive assistant for pipeline management and real-time research |
| **👤 Prospect Chat** | Demo of prospect-facing AI with handoff & escalation capabilities |
| **📊 Dashboard** | Real-time pipeline metrics and progress tracking |

## 🚀 Quick Start

1. **Setup**: Enter your HuggingFace token and company name
2. **Discover**: Let AI find prospects matching your profile
3. **Review**: Check discovered companies and contacts
4. **Engage**: Use AI-drafted emails for outreach

## 🏗️ Architecture

```
┌─────────────────────────────────────────────────────────────┐
│                      CX AI Agent                       │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │   Gradio   │  │  Autonomous│  │    MCP     │         │
│  │     UI     │──│    Agent   │──│   Servers  │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
│         │                │                │             │
│         ▼                ▼                ▼             │
│  ┌─────────────────────────────────────────────────┐        │
│  │              MCP Tool Definitions           │        │
│  │  • Search (Web, News)                       │        │
│  │  • Store (Prospects, Contacts, Facts)       │        │
│  │  • Email (Send, Thread Management)          │        │
│  │  • Calendar (Meeting Slots, Invites)        │        │
│  └─────────────────────────────────────────────────┘        │
└─────────────────────────────────────────────_────────────────┘
```

## 🔧 MCP Tools Available

### Search MCP Server
- `search_web` - Search the web for company information
- `search_news` - Find recent news about companies

### Store MCP Server
- `save_prospect` / `get_prospect` / `list_prospects` - Manage prospects
- `save_company` / `get_company` - Store company data
- `save_contact` / `list_contacts_by_domain` - Manage contacts
- `discover_prospects_with_contacts` - Full discovery pipeline
- `find_verified_contacts` - Find decision-makers

### Email MCP Server
- `send_email` - Send outreach emails
- `get_email_thread` - Retrieve conversation history

### Calendar MCP Server
- `suggest_meeting_slots` - Generate available times
- `generate_calendar_invite` - Create .ics files

## 🎭 Prospect Chat Demo

The **Prospect Chat Demo** showcases how prospects can interact with your company's AI:

- **Lead Qualification**: AI asks qualifying questions to understand prospect needs
- **Handoff Packets**: Generate comprehensive summaries for human sales reps
- **Escalation Flows**: Automatically escalate complex inquiries to humans
- **Meeting Scheduling**: Integrate with calendar for instant booking

## 📊 Technology Stack

| Component | Technology |
|-----------|------------|
| **Frontend** | Gradio 5.x |
| **AI Model** | Qwen2.5-72B / Qwen3-32B via HuggingFace |
| **Protocol** | Model Context Protocol (MCP) |
| **Search** | Serper API |
| **Language** | Python 3.8+ |

## 🔑 Environment Variables

Set these in your Space Secrets:

```
HF_TOKEN=your_huggingface_token_here
SERPER_API_KEY=your_serper_api_key_here  # Optional
```

## 📁 Project Structure

```
cx-ai-agent/
├── app.py                    # Main Gradio application
├── requirements.txt          # Python dependencies
├── README.md                 # This file
├── app/
│   └── schema.py            # Pydantic data models
└── mcp/
    ├── agents/              # Autonomous AI agents
    ├── servers/             # MCP server implementations
    └── tools/
        └── definitions.py   # MCP tool definitions
```

## 📝 License

This project is open source and available under the MIT License.

## 🙏 Acknowledgments

- **Anthropic** - Model Context Protocol specification
- **HuggingFace** - AI model hosting and inference
- **Gradio** - UI framework
- **Serper** - Web search API

---

## 👨‍💻 Developer

**Syed Muzakkir Hussain**

[![HuggingFace](https://img.shields.io/badge/HuggingFace-muzakkirhussain011-yellow?logo=huggingface)](https://huggingface.co/muzakkirhussain011)

---

<div align="center">

**Built with ❤️ by [Syed Muzakkir Hussain](https://huggingface.co/muzakkirhussain011) for the Gradio Agents & MCP Hackathon 2025**

`mcp-in-action-track-enterprise`

</div>