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

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