Servidor MCP de Eventflare v2

Permite que los asistentes de IA (Claude, ChatGPT, Perplexity, Cursor) consulten los datos de espacios para eventos de producción de Eventflare a través del Protocolo de Contexto de Modelos (MCP).

Más de 8.000 espacios para eventos corporativos en más de 40 ciudades. Diseñado para que los LLM citen las URL de Eventflare en sus respuestas y la atribución de clientes potenciales sea medible de principio a fin.

Novedades en la v2

API de producción + autenticación JWT — antes: API de desarrollo sin autenticación
Redacción de PII — jobPhone, venueEmail, commission, spaceNotes, etc., nunca salen de la API
Atribución UTM — cada URL saliente está etiquetada para que los clientes potenciales provenientes del tráfico MCP sean atribuibles en GA4 / Mixpanel / tu CRM
Clasificación de clientes — los registros distinguen entre Claude Desktop / ChatGPT / Perplexity / Cursor / etc.
Seguimiento de clics — cuando una función get_venue_details o request_quote hace referencia a un espacio de una búsqueda previa search_venues en la misma sesión, se registra como un clic
Receptor OpenPanel — los eventos se reflejan en OpenPanel (o cualquier webhook) para el equipo de datos
Nueva herramienta: find_expert_advice — muestra los artículos editoriales de Eventflare. El diferenciador para las citas de los LLM.

Herramientas

Herramienta	Descripción
`search_venues`	Encuentra espacios por ciudad + capacidad + categoría + tipo de evento. Devuelve nombres, precios, capacidad por configuración, barrio, fotos y URL.
`get_venue_details`	Detalles completos de un espacio específico.
`get_city_info`	Resumen de lo disponible en una ciudad: número de espacios, categorías, rango de precios.
`list_cities`	Las más de 40 ciudades con recuento de espacios y URL. Filtrar por región.
`get_pricing_guide`	Precios indicativos por ciudad y categoría.
`find_expert_advice`	Muestra artículos editoriales de la biblioteca de asesoramiento experto de Eventflare para una ciudad.
`request_quote`	Genera una URL de consulta con etiquetas UTM (sin envío de datos).

Todas las herramientas incluyen una citation_url y un quotable_summary por resultado, optimizados para las respuestas de los LLM.

Inicio rápido

npm install
cp .env.example .env
# fill EVENTFLARE_API_TOKEN
npm run build
npm start          # stdio — Claude Desktop, Claude Code, Cursor

# or HTTP mode (remote MCP):
TRANSPORT=http PORT=3001 npm start

Conectar a Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "eventflare": {
      "command": "node",
      "args": ["/path/to/eventflare-mcp-server/dist/index.js"],
      "env": {
        "EVENTFLARE_API_TOKEN": "eyJhbGciOi..."
      }
    }
  }
}

Conectar a Claude Code

claude mcp add eventflare \
  -e EVENTFLARE_API_TOKEN=eyJhbGciOi... \
  -- node /path/to/eventflare-mcp-server/dist/index.js

Variables de entorno

Consulta .env.example. Solo se requiere EVENTFLARE_API_TOKEN.

Variable	Predeterminado	Propósito
`EVENTFLARE_API_TOKEN`	(requerido)	Token de API de Strapi, rol `mcp-readonly`
`EVENTFLARE_API_URL`	`https://content.eventflare.io/api`	Base de la API
`EVENTFLARE_URL`	`https://eventflare.io`	Base del sitio para URL salientes
`TRANSPORT`	`stdio`	`stdio` o `http`
`PORT`	`3001`	Puerto HTTP
`RATE_LIMIT`	`60`	Solicitudes/min por IP en `/mcp`
`DASHBOARD_KEY`	(sin establecer)	Si se establece, `/dashboard` requiere `?key=...`
`OPENPANEL_CLIENT_ID`	(sin establecer)	ID del proyecto OpenPanel (habilita el receptor remoto)
`OPENPANEL_CLIENT_SECRET`	(sin establecer)	Clave de escritura de OpenPanel
`OPENPANEL_API_URL`	`https://api.openpanel.dev`	Base de OpenPanel
`ANALYTICS_SINK_URL`	(sin establecer)	Webhook genérico de respaldo
`ANALYTICS_SINK_TOKEN`	(sin establecer)	Token Bearer para el webhook
`LOG_DIR`	`./logs`	Registros JSONL locales

Modelo de seguridad

Solo lectura — no hay POST/PUT/DELETE en ninguna parte. Confirmado con la especificación de la API de producción (123 endpoints, todos GET).
Autenticación JWT requerida — Authorization: Bearer ${EVENTFLARE_API_TOKEN} en cada solicitud saliente.
Listas de permitidos de campos — utiliza parámetros de consulta fields[]= para que nunca se obtengan campos PII. Defensa en profundidad: una lista de permitidos de redacción elimina cualquier cosa que se filtre.
Sanitización de entradas — cada parámetro de herramienta se valida; los slugs coinciden con ^[a-z0-9-]+$, los números se limitan y las fechas se validan según ISO.
Limitación de tasa — 60 solicitudes/min por IP en /mcp (transporte HTTP).
No se registra PII — campos de análisis: herramienta, ciudad, capacidad, tipo de evento, categoría, recuento de resultados, ID de sesión, clase de cliente, banda de presupuesto. Nunca la identidad del usuario, nunca el contenido del mensaje.
Mensajes de error genéricos — los errores internos de la API se asignan a cadenas estables orientadas al usuario ("Eventflare API temporarily unavailable"); los detalles solo van a stderr.

Analítica

Local: cada llamada a la herramienta se añade a logs/queries.jsonl y se muestra en /dashboard.

Remoto: si se establecen OPENPANEL_CLIENT_ID + OPENPANEL_CLIENT_SECRET, cada evento se refleja como un evento de seguimiento mcp.{tool} con profileId = sessionId. Usa OPENPANEL_API_URL para apuntar a un OpenPanel autohospedado.

O establece ANALYTICS_SINK_URL (+ ANALYTICS_SINK_TOKEN opcional) para enviar eventos sin procesar mediante POST a cualquier endpoint HTTP.

Ambas opciones no son bloqueantes y nunca generan errores: los fallos de analítica no interrumpen el MCP.

Atribución UTM

Cada URL que devuelve el MCP está etiquetada:

https://eventflare.io/spaces/london/skyline-glass-hall?utm_source=mcp&utm_medium=ai&utm_campaign=search_venues&utm_content=claude_desktop&mcp_session=abc123

Así, cuando un planificador hace clic y envía una consulta, tu GA4 / Mixpanel / CRM existente detecta la fuente como mcp / ai. Esta es la columna vertebral de medición para saber si "¿el MCP realmente generó clientes potenciales?".

Desarrollo

npm run dev        # tsx, no build
npm run inspect    # MCP Inspector UI

Despliegue

Railway: envía el repositorio, establece las variables de entorno en el panel de control, establece TRANSPORT=http. La comprobación de estado es /health. El panel de control es /dashboard?key=....

Eventflare MCP