Referencia API
MemoryFirst expone una API REST nativa. La misma memoria es accesible por MCP (ver la guía de MCP).
URL base
https://api.memoryfirst.ai/v1
Autenticación
Todas las solicitudes requieren una clave API en la cabecera Authorization :
curl https://api.memoryfirst.ai/v1/experts/{expertId}/query \
-H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"question": "What did we promise this client?", "k": 8}'Endpoints
POST /v1/experts/{id}/sources: procesar una nueva fuentePOST /v1/experts/{id}/query: consultar memoria con citasGET /v1/experts: listar expertos en tu workspacePOST /v1/experts: crear nuevo expertoGET /v1/usage: estadísticas de uso del periodo actualPOST /v1/brain/event: registra un evento del cerebro (decisión, bloqueo, despliegue, contacto con cliente). Responde 202 con el id del evento.
Reintentos sin duplicados: Idempotency-Key
Si tu cliente reintenta tras un corte de red o reenvía una bandeja de salida, manda la cabecera Idempotency-Key en POST /v1/brain/event con una clave tuya (1 a 255 caracteres ASCII imprimibles, sin espacios). La misma clave del mismo workspace devuelve, durante 24 horas, el evento ya creado con 200 e idempotent_replay: true, y no crea otro.
curl https://api.memoryfirst.ai/v1/brain/event \
-H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: outbox-2026-11-13-0042" \
-H "Content-Type: application/json" \
-d '{"project": "my-project", "event_type": "decision_taken", "title": "Move blobs to R2"}'Si el cuerpo repetido es distinto, se devuelve el evento original sin cambios y payload_differs: true. La misma clave con otro proyecto responde 422; mientras la primera petición sigue en curso, 409 (reintenta con la misma clave). Con la herramienta MCP mf_record, pasa el argumento idempotency_key.
Especificación OpenAPI 3.1 completa próximamente. Escribe a hola [at] memoryfirst.ai para acceso anticipado.