This server provides a comprehensive WhatsApp integration via Evolution API, enabling complete management of WhatsApp instances and interactions.
Core Capabilities:
- Instance Management: Create, connect, list, check status, and delete WhatsApp instances 
- Message Sending: Send text, media (images, videos, audio, documents), interactive buttons, and list messages 
- Template Management: Create, retrieve, update, delete, search, and send message templates with variable support 
- Contact & Group Operations: Verify WhatsApp numbers, list contacts/groups, create groups, manage participants 
- Chat Management: Retrieve chats and messages, mark messages as read 
- Server Monitoring: Check health status and retrieve server information 
Provides comprehensive WhatsApp Business API integration through Evolution API, enabling management of WhatsApp instances, sending various message types (text, media, interactive buttons/lists), managing contacts and groups, and using dynamic message templates for common business scenarios like order confirmations, appointment reminders, and customer support.
Evolution API MCP Server - Guía de Uso
Configuración Actual
- URL del Servidor MCP: https://mcp-evolution-api-fixed-production.up.railway.app 
- URL de Evolution API: https://evolution-api-evolution-api.dqyvuv.easypanel.host 
- API Key: BC10D87095B7-44E2-B1A4-F03BE2BECE24 
- Instancia: Luis2 
- Número de prueba: 554198908495 
Endpoints Disponibles
1. Información del Servidor
2. Estado de Salud
3. Listar Instancias
4. Estado de una Instancia
5. Enviar Mensaje de Texto
6. Verificar Números de WhatsApp
7. Listar Contactos
8. Listar Grupos
9. Listar Chats
Solución de Problemas
El mensaje no llega a WhatsApp
- Verificar que la instancia esté conectada: - La instancia debe tener estado "open" o "connected" 
- Si no está conectada, necesitas escanear el código QR nuevamente 
 
- Formato del número: - Brasil: 55 + código de área + número (ejemplo: 554198908495) 
- Sin espacios, guiones o símbolos 
- Sin el símbolo + al inicio 
 
- Verificar si el número tiene WhatsApp: - Usa el endpoint - /api/check-numberspara verificar
 
Error "Access denied"
- Verifica que estés enviando el header - X-API-Keycon el valor correcto
- El API Key debe ser: BC10D87095B7-44E2-B1A4-F03BE2BECE24 
Error de conexión
- Verifica que Evolution API esté funcionando: curl https://evolution-api-evolution-api.dqyvuv.easypanel.host/instance/fetchInstances \ -H "apikey: BC10D87095B7-44E2-B1A4-F03BE2BECE24"
- Si Evolution API no responde, el problema está en Easypanel 
Scripts de Prueba
Hay dos scripts de prueba disponibles:
- test-mcp.sh - Prueba el servidor MCP 
- test-evolution-direct.sh - Prueba directamente Evolution API 
Para ejecutarlos en Windows, usa Git Bash:
Actualización del Código
Cuando hagas cambios en el código:
- Commit y push a GitHub: git add . git commit -m "Descripción del cambio" git push origin master
- Railway detectará automáticamente los cambios y redesplegará 
- Verifica el estado del deployment en Railway: - Ve a https://railway.app 
- Entra al proyecto "MCP Servers" 
- Revisa el estado del deployment 
 
Estructura del Proyecto
Variables de Entorno en Railway
Las siguientes variables están configuradas en Railway:
- EVOLUTION_API_URL: https://evolution-api-evolution-api.dqyvuv.easypanel.host
- EVOLUTION_API_KEY: BC10D87095B7-44E2-B1A4-F03BE2BECE24
- MCP_SERVER_PORT: 3000
- NODE_ENV: production
Notas Importantes
- Seguridad: Nunca expongas el API Key en código público 
- Rate Limiting: Evolution API puede tener límites de tasa 
- Sesión de WhatsApp: La sesión puede expirar y requerir nuevo escaneo de QR 
- Números bloqueados: WhatsApp puede bloquear números que envían muchos mensajes 
Contacto y Soporte
Para problemas con:
- Evolution API: Revisa la documentación en https://doc.evolution-api.com 
- Railway: https://railway.app/support 
- Easypanel: Panel de control de tu instancia 
Última actualización: 14 de Septiembre de 2025
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Enables WhatsApp Business messaging through Evolution API with support for creating instances, sending messages using dynamic templates, and managing contacts and groups. Includes 10+ predefined message templates for common business scenarios like order confirmations, appointment reminders, and promotional messages.