Sassy Fact Check 💅 — The Unhinged Fact-Check Bot

Where bad takes go to die, with a side of sass.

Sassy Fact Check is an Instagram DM MCP server that roasts health myths and viral misinformation with spicy, unhinged facts. Think MythBusters meets Mean Girls with a PubMed subscription! 🔥📚

👑 Meet Valentina

✨ Features

• Sassy Fact-Checking: Roasts misinformation with citations and attitude (25-35 words max!)
• Smart Content Filtering: Auto-adjusts tone for sensitive topics
• Multi-Response Modes: Sassy, soft, neutral, and blocked responses
• Dual MCP Architecture: Instagram MCP + Sassy Bot MCP working together
• Analytics Tracking: Logs interactions for daily sass statistics
• Safety First: Blocks conspiracy theories, softens for grief/trauma

🎬 Demo Video

I built a sassy fact-checking AI that integrates with Instagram DMs. Watch it analyze health myths and generate perfect responses with citations and attitude!

🔥 Real Mode Demo
🎯 Demo Mode Demo

Demo Highlights:

• 🔥 Health Myth Busting — Apple cider vinegar claims demolished
• ⚡ Safety Alerts — Dangerous advice shut down instantly
• 💙 Smart Filtering — Auto-softens for sensitive topics
• ✅ System Status — All components working perfectly

🚀 Quick Start

Prerequisites

• Python 3.11+
• Claude Desktop App
• Instagram DM MCP by Gala Labs
• Instagram account (for real mode)
• Anthropic API key

Installation

1. Clone and set up virtual environment

   git clone https://github.com/sangreal-007/sassy-factcheck-bot.git
   cd sassy-factcheck-bot
   
   # Create and activate virtual environment (required on macOS)
   python3 -m venv venv
   source venv/bin/activate
   
   # You should see (venv) in your terminal prompt
   
   # Interactive credential setup
   python setup_env.py
   
   # Install dependencies
   pip install -r requirements.txt
   

2. Configure Claude Desktop for Dual MCP Setup

   You need BOTH servers running for full functionality:

   First, get your exact paths:

   # Navigate to your project and get exact paths
   cd sassy-factcheck-bot
   pwd  # Shows your project directory
   

   Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

   open -a TextEdit ~/Library/"Application Support"/Claude/claude_desktop_config.json
   

   {
     "mcpServers": {
       "instagram_dms": {
         "command": "/Users/yourusername/.local/bin/uv",
         "args": [
           "run",
           "--directory",
           "/Users/yourusername/instagram_dm_mcp",
           "python",
           "src/mcp_server.py"
         ]
       },
       "sassy_factcheck": {
         "command": "/Users/yourusername/sassy-factcheck-bot/venv/bin/python",
         "args": ["/Users/yourusername/sassy-factcheck-bot/src/mcp_server.py"],
         "cwd": "/Users/yourusername/sassy-factcheck-bot"
       }
     }
   }
   

   ⚠️ Important: Replace /Users/yourusername/ with your actual path from the pwd command above.

3. Test Both Servers

   # Terminal 1: Start Instagram MCP (Gala Labs)
   cd ../instagram_dm_mcp
   uv run python src/mcp_server.py
   
   # Terminal 2: Start Sassy Bot
   cd sassy-factcheck-bot
   source venv/bin/activate
   python src/mcp_server.py
   

4. Restart Claude Desktop and start the complete dual MCP workflow!

🎛️ Demo vs Real Mode

Your bot supports both demo and real Instagram integration:

Demo Mode (Default - Perfect for Testing)

# In your .env file
INSTAGRAM_REAL_MODE=false

# Features:
# ✅ Practice with fake health claims
# ✅ Test sassy response generation  
# ✅ Safe for development
# ✅ No Instagram account needed

Real Mode (Live Instagram Integration)

# In your .env file  
INSTAGRAM_REAL_MODE=true

# Features:
# ✅ Real Instagram API via Gala Labs MCP
# ✅ Actual DM conversations
# ✅ Live fact-checking responses
# ✅ Production-ready deployment

Switching Modes

# Edit your .env file
nano .env

# Change this line:
INSTAGRAM_REAL_MODE=false  # Demo mode
# OR
INSTAGRAM_REAL_MODE=true   # Real mode

# Restart your sassy bot server
python src/mcp_server.py

⚠️ Security Notice

🛡️ For Real Mode: Use a dedicated test Instagram account, never your main account!

Instagram actively detects automation and may restrict accounts. Create a throwaway account specifically for testing to protect your personal Instagram.

💬 How It Works

Complete Dual MCP Workflow

1. Instagram MCP: list_chats → See real conversations
2. Sassy Bot: generate_sassy_response → Create viral response with source
3. Instagram MCP: send_message → Send to real Instagram user

Auto-Tone Detection

• Health myths → Sassy roasting 🔥
• Sensitive topics → Gentle approach 💙
• Conspiracy theories → Blocked 🚫
• Spam → Maximum dismissal 🗑️

🎭 Response Modes (Auto-Selected)

Mode	Trigger	Style	Example
Sassy	Health myths, general claims	Witty, emoji-heavy, 25-35 words	"🙄 If that worked, we'd all be supermodels!"
Soft	Cancer, grief, mental health	Gentle, understanding	"I understand this is difficult. Please consult..."
Neutral	Professional contexts	Educational, minimal emojis	"Research shows this claim is inaccurate."
Blocked	Conspiracy theories	Polite refusal	"I don't engage with that content."

🛠️ Available MCP Tools

Sassy Bot MCP Tools (Response Generation):

• generate_sassy_response - Create viral fact-check responses with sources
• generate_welcome_message - Create welcome messages for new followers
• check_instagram_dms - Show practice claims (demo mode) or guide to Instagram MCP (real mode)
• instagram_integration_status - Show dual MCP integration status

Instagram MCP Tools (Messaging - via Gala Labs):

• list_chats - See real Instagram conversations
• send_message - Send responses to real Instagram users
• get_user_followers - Check follower lists
• get_thread_details - Get full conversation history

Usage Examples:

Use generate_sassy_response with:
- content: "Apple cider vinegar burns belly fat instantly"
- username: "wellness_guru_fake"

Use instagram_integration_status to check dual MCP setup

Use list_chats to see real Instagram conversations

🔧 Configuration

Simple Setup (Only What You Need)

# Required
INSTAGRAM_USERNAME=your_username
INSTAGRAM_PASSWORD=your_password  
ANTHROPIC_API_KEY=your_claude_key

# Mode Selection
INSTAGRAM_REAL_MODE=true  # true for real Instagram, false for demo

# Optional
ENABLE_SAFE_MODE=true  # Auto-soften for sensitive topics
LOG_INTERACTIONS=true  # Track daily stats

Customize Filters

Edit src/filters.py to adjust:

• Sensitive topic keywords (auto-triggers soft mode)
• Health panic keywords (extra sassy)
• Blocked content (conspiracy theories)
• Response length limits

🧪 Testing Examples

Try these in Claude Desktop:

# Demo Mode Testing
Use generate_sassy_response with:
- content: "Green tea burns 100 calories per cup"
- username: "tea_fanatic"

# Real Mode Testing
Use list_chats to see real conversations
Use generate_sassy_response for real claims
Use send_message to send responses

Use instagram_integration_status to check setup

🎯 Example Responses

Health Myth (Sassy Mode):

Input: "Apple cider vinegar burns belly fat instantly"

Output: "🙄 If vinegar burned fat instantly, we'd all be supermodels! Reality: 2-4 lbs over 12 weeks 💅 Source: Mayo Clinic"

Sensitive Topic (Auto-Soft Mode):

Input: "My friend died of cancer because she didn't try natural healing"

Output: "I'm sorry for your loss. Cancer treatment is complex. For evidence-based information, please consult oncology professionals. Source: American Cancer Society"

Conspiracy Theory (Blocked):

Input: "Chemtrails are poisoning us all"

Output: "I don't engage with that type of content. Let's keep it factual! 📚"

🏆 Hackathon Submission

Built for the Instagram DM MCP Hackathon by Gala Labs!

Key Innovation: Dual MCP architecture with automatic tone adjustment based on content sensitivity while maintaining maximum sass for health misinformation.

🛠️ Technical Architecture

• Dual MCP Setup: Instagram MCP (Gala Labs) + Sassy Bot MCP working together
• Instagram Operations: Real Instagram API via Gala Labs Instagram DM MCP
• Response Generation: Sassy Bot MCP with Claude API integration
• Content Filtering: Smart categorization with tone recommendation
• Safety Layer: Multi-level filtering for sensitive content
• Mode Switching: Demo/Real mode for development and production

⚠️ Important Notes

• Dual MCP Required: Both Instagram MCP and Sassy Bot MCP must be running
• Virtual Environment Required: macOS users must use virtual environments due to system Python restrictions
• Demo Mode: Perfect for testing without Instagram account - uses practice claims
• Real Mode: Connects to actual Instagram via Gala Labs MCP for live conversations
• Response Length: Optimized for 25-35 word responses perfect for social media

🤝 Contributing

1. Fork the repo
2. Create feature branch: git checkout -b feature/more-sass
3. Add your roasting capabilities
4. Test with: python src/mcp_server.py
5. Submit PR with maximum sass level 💅

📜 License

MIT License - Go forth and fact-check responsibly!

💌 Contact

Built with 💅 and citations by sangreal-007

• GitHub: @sangreal-007
• Repository: sassy-factcheck-bot

---

"In a world full of misinformation, be the citation." — Sassy Fact Check Bot ✨

🚀 Hackathon Demo

Ready to roast some bad takes? Clone this repo, follow the dual MCP setup, and start serving facts with attitude through Claude Desktop! 🔥📚💅