# Morocco Experience Protocol MCP Server 🇲🇦🤖
> The first AI-accessible tourism data protocol - making Morocco's experiences discoverable through AI assistants like Claude and ChatGPT
[](https://mep-mcp-server-production.info6625.workers.dev)
[](https://modelcontextprotocol.io)
[](LICENSE)
## 🚀 Quick Start
### Add to Claude Desktop (5 minutes)
1. **Find your Claude config file**:
- **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
2. **Add MEP server**:
```json
{
"mcpServers": {
"morocco-experience-protocol": {
"command": "npx",
"args": [
"@modelcontextprotocol/server-fetch",
"https://mep-mcp-server-production.info6625.workers.dev/sse"
]
}
}
}
```
3. **Restart Claude Desktop**
4. **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!
```bash
# 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](docs/QUICK_START.md)** - Get running in 5 minutes
- **[Claude Desktop Setup](docs/CLAUDE_SETUP.md)** - Step-by-step Claude integration
- **[API Reference](docs/API_REFERENCE.md)** - Complete tool documentation
- **[Integration Examples](examples/)** - Code samples for different platforms
- **[Deployment Guide](docs/DEPLOYMENT.md)** - Run your own instance
## 🔧 Integration Examples
### Claude Desktop
See [examples/claude-desktop/](examples/claude-desktop/) for complete setup.
### Custom AI Application
```typescript
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
```python
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](docs/CLAUDE_SETUP.md) to add MEP to Claude in 5 minutes.
### 2. Explore the API
Check out our [API Reference](docs/API_REFERENCE.md) to understand all available tools.
### 3. Build Something
Use our [integration examples](examples/) to build your own AI-powered travel app.
### 4. Deploy Your Own
Follow our [Deployment Guide](docs/DEPLOYMENT.md) to run your own MEP server instance.
## 🤝 Contributing
We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
### Development Setup
```bash
git clone https://github.com/gugga7/morocco-experience-protocol-mcp.git
cd morocco-experience-protocol-mcp
npm install
npm run dev
```
### Running Tests
```bash
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](https://github.com/gugga7/morocco-experience-protocol-mcp/issues)
- **Discussions**: [GitHub Discussions](https://github.com/gugga7/morocco-experience-protocol-mcp/discussions)
## 📄 License
MIT License - see [LICENSE](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* 🌍✨
