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.

Related MCP server: EvHenter MCP

Herramientas

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.

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=....

Licencia

MIT — © Eventflare