Enables interaction with Instagram Direct Messages through the Gala Labs Instagram DM MCP, allowing the bot to list chats, send fact-checking responses, retrieve conversation history, and manage follower lists.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Sassy Fact Check Botis apple cider vinegar a miracle cure for weight loss?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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+
Instagram DM MCP by Gala Labs
Instagram account (for real mode)
Anthropic API key
Installation
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.txtConfigure 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 directoryAdd 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 thepwdcommand above.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.pyRestart 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)
Real Mode (Live Instagram Integration)
Switching Modes
β οΈ 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
Instagram MCP:
list_chatsβ See real conversationsSassy Bot:
generate_sassy_responseβ Create viral response with sourceInstagram 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 sourcesgenerate_welcome_message- Create welcome messages for new followerscheck_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 conversationssend_message- Send responses to real Instagram usersget_user_followers- Check follower listsget_thread_details- Get full conversation history
Usage Examples:
π§ Configuration
Simple Setup (Only What You Need)
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:
π― 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
Fork the repo
Create feature branch:
git checkout -b feature/more-sassAdd your roasting capabilities
Test with:
python src/mcp_server.pySubmit 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! π₯ππ