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)

🛠️ 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! 🔥📚💅