Morocco Experience Protocol MCP Server 🇲🇦🤖
The first AI-accessible tourism data protocol - making Morocco's experiences discoverable through AI assistants like Claude and ChatGPT
🚀 Quick Start
Add to Claude Desktop (5 minutes)
-
Find your Claude config file:
- Mac:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Mac:
-
Add MEP server:
{ "mcpServers": { "morocco-experience-protocol": { "command": "npx", "args": [ "@modelcontextprotocol/server-fetch", "https://mep-mcp-server-production.info6625.workers.dev/sse" ] } } } -
Restart Claude Desktop
-
Test it:
"Find cooking experiences in Marrakech" "What cultural activities are available in Fes?" "Show me adventure tours in the Atlas Mountains"
✨ Features
- 🌍 Real Morocco Data - Verified tourism experiences from local operators
- 🤖 AI-Ready - Full MCP 2025-06-18 protocol compliance
- ⚡ Global CDN - Sub-50ms response times worldwide via Cloudflare
- 🗣️ Multilingual - Arabic, French, and English support
- 🔒 Secure - Enterprise-grade security and validation
- 📱 Always Online - 99.9% uptime with automatic scaling
🎯 Live Demo
Try it now: Our MCP server is live and responding!
# Health check
curl https://mep-mcp-server-production.info6625.workers.dev/health
# MCP initialize
curl -X POST https://mep-mcp-server-production.info6625.workers.dev/sse \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"initialize","id":1}'
# List available tools
curl -X POST https://mep-mcp-server-production.info6625.workers.dev/sse \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"tools/list","id":2}'
🛠️ Available Tools
| Tool | Description | Example |
|---|---|---|
searchExperiences | Find tourism experiences | Cooking classes, cultural tours |
getExperienceDetails | Get detailed experience info | Pricing, location, operator |
listOperators | Browse tourism operators | Hotels, guides, restaurants |
getOperatorDetails | Get operator information | Contact, verification status |
📖 Documentation
- Quick Start Guide - Get running in 5 minutes
- Claude Desktop Setup - Step-by-step Claude integration
- API Reference - Complete tool documentation
- Integration Examples - Code samples for different platforms
- Deployment Guide - Run your own instance
🔧 Integration Examples
Claude Desktop
See examples/claude-desktop/ for complete setup.
Custom AI Application
import { MCPClient } from '@modelcontextprotocol/client';
const mepClient = new MCPClient({
serverUrl: 'https://mep-mcp-server-production.info6625.workers.dev/sse'
});
// Search for experiences
const results = await mepClient.callTool('searchExperiences', {
query: 'cooking class',
location: 'Marrakech'
});
Python Client
import requests
# Search Morocco experiences
response = requests.post(
'https://mep-mcp-server-production.info6625.workers.dev/sse',
json={
"jsonrpc": "2.0",
"method": "tools/call",
"id": 1,
"params": {
"name": "searchExperiences",
"arguments": {
"query": "cultural tour",
"location": "Fes"
}
}
}
)
🌟 Why MEP?
For AI Developers
- ✅ First real-world MCP example - Learn from production code
- ✅ Tourism use case - Practical, understandable application
- ✅ Production ready - Not just a demo, actually deployed
- ✅ Well documented - Comprehensive guides and examples
For Travelers
- ✅ Authentic experiences - Direct from local Moroccan operators
- ✅ Verified data - All operators and experiences verified
- ✅ Current information - Real-time pricing and availability
- ✅ AI-powered discovery - Natural language search
For Morocco
- ✅ Digital innovation - First country with AI-accessible tourism
- ✅ Global visibility - Moroccan experiences discoverable worldwide
- ✅ Local empowerment - Small operators accessible to global AI
🚀 Getting Started
1. Try with Claude Desktop
Follow our Claude Desktop Setup Guide to add MEP to Claude in 5 minutes.
2. Explore the API
Check out our API Reference to understand all available tools.
3. Build Something
Use our integration examples to build your own AI-powered travel app.
4. Deploy Your Own
Follow our Deployment Guide to run your own MEP server instance.
🤝 Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
Development Setup
git clone https://github.com/gugga7/morocco-experience-protocol-mcp.git
cd morocco-experience-protocol-mcp
npm install
npm run dev
Running Tests
npm test
npm run test:integration
📊 Status
- Server Status: ✅ Online
- Protocol Version: MCP 2025-06-18
- Response Time: < 50ms globally
- Uptime: 99.9%
- Last Updated: December 2025
🔗 Links
- Live Server: https://mep-mcp-server-production.info6625.workers.dev
- Documentation: https://docs.cometomorocco.com
- Issues: GitHub Issues
- Discussions: GitHub Discussions
📄 License
MIT License - see LICENSE for details.
🙏 Acknowledgments
- Morocco Ministry of Tourism - For supporting digital innovation
- MCP Community - For the amazing protocol and ecosystem
- Cloudflare - For global edge infrastructure
- Firebase - For reliable data storage
Made with ❤️ in Morocco for the global AI community
Morocco Experience Protocol - Making authentic travel experiences AI-accessible worldwide 🌍✨
