Xtranumerik-inc/xibo-mcp

🎯 Xibo Smart Auth MCP Server v2.0.0

Ultra-Simplified MCP Server for Xibo Digital Signage - Just 3 Fields to Configure!

🚀 The World's Simplest Xibo MCP Server

Smart Auth Edition eliminates ALL complexity from Xibo MCP setup:

• 3 fields total: URL, Username, Password
• Zero OAuth2: No complex app registration required
• Automatic 2FA: Handles all 2FA methods transparently
• Smart permissions: Automatically detects what you can access
• 117 tools: Complete Xibo API control through natural language

⚡ 30-Second Setup

# Clone and install
git clone https://github.com/Xtranumerik-inc/xibo-mcp.git
cd xibo-mcp
npm install

# One command setup (3 questions only!)
npm run smart-auth

# That's it! Ready to use in Claude Desktop/Code

What happens automatically:

• ✅ Detects your Xibo server version and capabilities
• ✅ Handles 2FA authentication (any method)
• ✅ Analyzes your user permissions
• ✅ Generates personalized MCP config (only tools you can use)
• ✅ Configures Claude Desktop integration
• ✅ Starts the MCP server

🎯 Smart Auth Revolution

Before Smart Auth (Complex) 🚫

1. Create OAuth2 application in Xibo CMS
2. Configure client ID and secret  
3. Set up grant types and scopes
4. Generate API tokens manually
5. Configure MCP server manually
6. Handle token refresh logic
7. Manage 2FA separately
8. Debug permission issues

With Smart Auth (Simple) ✅

npm run smart-auth
→ URL: https://your-xibo.com
→ Username: your-username  
→ Password: your-password
→ DONE!

🔐 Automatic 2FA Support

Smart Auth transparently handles ALL 2FA methods:

• 📱 TOTP Apps: Google Authenticator, Authy, Microsoft Authenticator
• 📧 Email Codes: Email verification codes
• 📱 SMS: Text message verification
• 🔑 Backup Codes: Recovery codes for emergencies
• 💾 Device Memory: Skip 2FA for trusted devices

No configuration required - Smart Auth detects and handles your 2FA method automatically.

🧠 Intelligent Permission Detection

Smart Auth automatically analyzes your Xibo account and provides:

Viewer Level (32 tools)

• Display monitoring and basic control
• Layout viewing and simple modifications
• Media browsing and basic uploads
• Basic scheduling and campaigns

Editor Level (68 tools)

• Full layout and media management
• Advanced scheduling and playlists
• Campaign creation and management
• Display group management

Admin Level (89 tools)

• User and group management
• Advanced analytics and reports
• System configuration access
• Regional and geo-targeting features

Super Admin Level (117 tools)

• Complete system control
• Emergency alert broadcasting
• Menu board management for restaurants
• Multi-CMS synchronization
• Advanced automation and workflows

The system automatically provides only the tools you have permission to use!

💬 Natural Language Commands

After setup, control your Xibo CMS through natural language:

// Display management
"Show me all my displays"
"Turn off the lobby screen"  
"Restart all displays in Region A"

// Content management
"Upload this image to the media library"
"Create a new layout for the restaurant menu"
"Schedule this campaign for next week"

// Geographic targeting
"Broadcast this ad to all Quebec displays" 
"Show weather on Montreal screens only"
"Emergency alert for all displays except Region B"

// Analytics (if you have permissions)
"Generate a usage report for last month"
"Show me which displays are offline"
"Display statistics by region"

Smart Auth ensures you only get tools that work with your permissions!

🌍 Regional Optimization for Quebec/Montreal

Built-in smart features for Canadian digital signage:

🗺️ Geographic Targeting

• Automatic region detection
• Natural language geo-commands
• Support for Quebec/Montreal zones
• Bilingual French/English interface

⏰ Timezone Intelligence

• Automatic EST/EDT handling
• Montreal timezone as default
• Schedule coordination across regions

🍽️ Restaurant Menu Boards

• Dynamic menu updates
• Price management in CAD
• Bilingual menu support
• Seasonal item rotation

🚨 Emergency Alerts

• Geo-targeted emergency broadcasting
• Provincial and municipal zones
• Weather integration with Environment Canada
• Multi-language alert support

🔧 Advanced Features

Session Management

• Automatic token refresh
• Device remembering (configurable duration)
• Secure session encryption
• Multiple account support

Performance Optimization

• Intelligent API caching
• Rate limit management
• Connection pooling
• Automatic failover

Security

• Enterprise-grade encryption
• Audit logging
• IP filtering (optional)
• Session timeout management

🛠️ Usage Examples

Basic Setup Commands

# Quick setup
npm run smart-auth

# Custom session duration  
SMART_AUTH_REMEMBER=30d npm run smart-auth

# Debug mode
LOG_LEVEL=debug npm run smart-auth

# Start MCP server
npm start

Testing and Validation

# Test your setup
npm run test-auth

# Validate all tools
npm run validate

# Test MCP compatibility
npm test

📊 Complete Tool Coverage

Smart Auth provides access to 117 specialized tools across all Xibo modules:

All tools automatically adapt to your permission level!

🆘 Smart Auth Troubleshooting

Issue: "Authentication failed"

# Solution 1: Verify credentials
npm run smart-auth  # Re-run setup

# Solution 2: Check account status in Xibo
# Ensure account is not disabled or locked

Issue: "2FA code not working"

# Solution: Check device time sync
# Smart Auth handles time drift automatically
# but ensure your device clock is accurate

Issue: "No tools available"

# This is normal! Smart Auth only shows tools you can use
# Check your Xibo user permissions:
# User Menu → User → Permissions → Feature Access

Issue: "Connection refused"

# Verify Xibo URL is accessible:
curl -I https://your-xibo.com/api/authorize

🚀 Why Choose Smart Auth Edition?

Traditional MCP Setup Pain Points ❌

• Complex OAuth2 application setup
• Manual permission configuration
• Separate 2FA handling
• Confusing tool availability
• Hours of configuration time
• Frequent authentication failures

Smart Auth Solution ✅

• 3-field setup: URL + Username + Password
• Auto-permission detection: No manual configuration
• Transparent 2FA: Works with any method
• Adaptive tools: Only shows what you can use
• 30-second setup: From clone to working
• Rock-solid authentication: Enterprise-grade reliability

📚 Documentation

Quick References

• docs/SMART-AUTH-GUIDE.md - Complete Smart Auth documentation
• docs/TROUBLESHOOTING.md - Common issues and solutions
• docs/API-REFERENCE.md - All 117 tools documented
• docs/QUEBEC-FEATURES.md - Regional optimization guide

Advanced Guides

• docs/DEVELOPER-GUIDE.md - Extending Smart Auth
• docs/SECURITY.md - Security features and configuration
• docs/RESTAURANT-MENUS.md - Menu board management
• docs/EMERGENCY-ALERTS.md - Alert system documentation

🆘 Professional Support

Xtranumerik Inc. Support

• 📧 Email: support@xtranumerik.ca
• 🌐 Website: https://www.xtranumerik.ca
• 📞 Professional Support: Available for enterprise clients
• 🎯 Smart Auth Specialists: Dedicated Smart Auth support team

Community Support

• GitHub Issues: Bug reports and feature requests
• GitHub Discussions: Community help and examples
• Documentation: Complete guides and troubleshooting

📄 License & Credits

MIT License - see for details.

Developed with ❤️ by Xtranumerik Inc.

• Montreal, Quebec, Canada
• Specialized in Digital Signage Solutions
• Smart Auth Technology Pioneer

🌟 Experience the Future of Xibo MCP

Smart Auth Edition represents the next evolution of MCP servers:

🎯 The Smart Auth Promise

"If you can log into your Xibo CMS manually, Smart Auth will work automatically."

• No complex setup - Just your normal login credentials
• No OAuth2 confusion - Zero app registration required
• No permission guesswork - Automatically detects what you can do
• No 2FA complications - Handles all methods transparently
• No tool confusion - Only shows tools that work for you

🚀 Start Your Digital Signage AI Revolution

git clone https://github.com/Xtranumerik-inc/xibo-mcp.git
cd xibo-mcp
npm install && npm run smart-auth

Transform your Xibo Digital Signage management with AI-powered automation - configured automatically in 30 seconds!

🎯 Smart Auth Edition - Because digital signage management should be simple, not complex.