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)

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:

   {
     "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!

# 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 🌍✨