Cómo se anuncia
Con el protocolo2026-07-28, la respuesta de server/discover trae "events": {} en capabilities. Los métodos van por el mismo endpoint y con la misma autenticación que las herramientas. Responden por el espacio principal de tu credencial.
events/list
Devuelve los catorce eventos del catálogo. Cada uno trae name, description, delivery: ["webhook"], inputSchema (los argumentos de la suscripción) y payloadSchema (el esquema de data).
El único argumento es opcional: subject, para recibir solo lo de un objeto (opportunity/<id>).
events/subscribe
Responde
{ "id", "refreshBefore", "cursor": null, "truncated" }. Vuelve a suscribirte antes de refreshBefore con los mismos datos para renovarla. El id sale de quién eres, la dirección, el evento y los argumentos: suscribirte otra vez con lo mismo renueva, no duplica, y reactiva una que se había apagado. Un secreto nuevo reemplaza al anterior; durante 24 horas Brein firma con los dos.
Suscribirse lo hace una persona, por su cliente MCP; una llave de API no puede. En un espacio de prueba no se permite: ahí nada sale de Brein.
Verificación de la dirección
Antes de aceptar, Brein manda a tuurl:
X-MCP-Subscription-Id. Responde 2xx con { "challenge": "<el mismo valor>" } en menos de 10 segundos. Una dirección verificada no se vuelve a verificar durante 24 horas.
events/unsubscribe
Los mismos name, arguments y delivery (sin secret). Responde {}, aunque ya no existiera. Deja de entregar y conserva la historia.
Lo que recibes
eventId es el id del evento en el libro y no cambia entre reintentos. Verifica la firma igual que en un Destino. Un evento puede llegar más de una vez y fuera de orden.
Al vencer la suscripción, Brein deja de entregar lo pendiente.