Docs

Quickstart en seis pasos.

Desde la API key hasta la verificación offline y el cliente MCP. Sustituye las variables y ejecuta en orden.

API key → send → status → proof-bundle → verify → MCP

01variables de entorno

Autenticación con API key

Exporta la clave que recibes en el onboarding. Todas las rutas /v1/* exigen Authorization: Bearer.

variables de entorno

export MAILACK_API_KEY="mlk_..."
export MAILACK_API_URL="https://api.mailack.com"

# Cada petición lleva la clave en Authorization.
curl -s "$MAILACK_API_URL/v1/messages" \
  -H "Authorization: Bearer $MAILACK_API_KEY" \
  -H "Accept: application/json"

02POST /v1/messages

Enviar el primer mensaje

POST /v1/messages con Idempotency-Key. Guarda el id de la respuesta; lo usas en los pasos siguientes.

POST /v1/messages

MESSAGE_ID=$(curl -s -X POST "$MAILACK_API_URL/v1/messages" \
  -H "Authorization: Bearer $MAILACK_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@acme.mx",
    "to": "cliente@ejemplo.com",
    "subject": "Primer mensaje",
    "html": "<p>Hola desde mailack.</p>"
  }' | jq -r .id)

echo "$MESSAGE_ID"

03GET /v1/messages/{id}
Consultar su estado
GET /v1/messages/{id} devuelve el estado de entrega, eventos y metadatos del mensaje.
GET /v1/messages/{id}
```
curl -s "$MAILACK_API_URL/v1/messages/$MESSAGE_ID" \
  -H "Authorization: Bearer $MAILACK_API_KEY" | jq .
```

04GET /v1/messages/{id}/proof-bundle

Descargar el proof bundle

GET /v1/messages/{id}/proof-bundle. Incluye hash canónico, prueba de inclusión y, cuando exista, la constancia del PSC.

GET /v1/messages/{id}/proof-bundle

curl -s "$MAILACK_API_URL/v1/messages/$MESSAGE_ID/proof-bundle" \
  -H "Authorization: Bearer $MAILACK_API_KEY" \
  -o bundle.json

# Campos de la constancia del PSC en el bundle:
# certificate_id, serial_number, policy_oid, algorithm_oid, sealed_at
jq '{certificate_id, serial_number, sealed_at}' bundle.json

05./bin/mailack-verify

Verificarlo offline

Ejecuta mailack-verify contra el bundle y, si lo tienes, el .eml original. No requiere red.

./bin/mailack-verify

./bin/mailack-verify bundle.json -eml mensaje.eml

# Sin el .eml solo valida hash del bundle, inclusión Merkle y raíz vs constancia.
./bin/mailack-verify bundle.json

06mcpServers.mailack

Conectar el servidor MCP

Registra mailack-mcp en tu cliente MCP. El agente podrá enviar, consultar, verificar y operar con las tools expuestas.

mcpServers.mailack

{
  "mcpServers": {
    "mailack": {
      "command": "./bin/mailack-mcp",
      "env": {
        "MAILACK_API_KEY": "mlk_...",
        "MAILACK_API_URL": "https://api.mailack.com"
      }
    }
  }
}

Referencia completa de la API

La referencia OpenAPI completa se entrega en el onboarding. Esta página es el camino mínimo hasta el primer proof bundle verificado.