cx_ai_agent_v1 / README.md
muzakkirhussain011's picture
Add application files (text files only)
8bab08d
---
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>