Nefesh Human State

Servidor Nefesh MCP + A2A

Un servidor de Model Context Protocol y Agent-to-Agent (A2A) que brinda a los agentes de IA conciencia en tiempo real del estado fisiológico humano.

Qué hace

Envía datos de sensores (frecuencia cardíaca, voz, expresión facial, sentimiento del texto) y recibe un estado unificado con una acción legible por máquina que tu agente puede seguir directamente. No se requiere ingeniería de prompts.

En la segunda llamada en adelante, la respuesta incluye adaptation_effectiveness — indicando a tu agente si su enfoque anterior realmente funcionó. Un sistema de retroalimentación de bucle cerrado para agentes que se auto-mejoran.

Efectividad de Adaptación (Bucle Cerrado)

La mayoría de las APIs te dan un estado. Nefesh te dice si tu reacción a ese estado realmente funcionó.

En la segunda llamada en adelante dentro de una sesión, cada respuesta incluye:

{
  "state": "focused",
  "stress_score": 45,
  "suggested_action": "simplify_and_focus",
  "adaptation_effectiveness": {
    "previous_action": "de-escalate_and_shorten",
    "previous_score": 68,
    "current_score": 45,
    "stress_delta": -23,
    "effective": true
  }
}

Tu agente puede leer effective: true y saber que su desescalada anterior funcionó. Si effective: false, el agente ajusta su estrategia. Ningún otro sistema de estado humano proporciona este bucle de retroalimentación.

Configuración

Opción A: Conéctate primero, obtén una clave a través de tu agente (lo más rápido)

Agrega la configuración sin una clave de API — tu agente obtendrá una automáticamente.

{
  "mcpServers": {
    "nefesh": {
      "url": "https://mcp.nefesh.ai/mcp"
    }
  }
}

Luego pregúntale a tu agente:

"Consígueme una clave gratuita de Nefesh API usando mi dirección de correo electrónico"

El agente llama a request_api_key → haces clic en un enlace de correo → el agente recoge la clave. Sin formulario de registro, sin copiar y pegar manualmente. Después de eso, agrega la clave a tu configuración para futuras sesiones:

{
  "mcpServers": {
    "nefesh": {
      "url": "https://mcp.nefesh.ai/mcp",
      "headers": {
        "X-Nefesh-Key": "nfsh_free_..."
      }
    }
  }
}

Opción B: Obtén una clave primero, luego conéctate

Regístrate en nefesh.ai/signup (1,000 llamadas/mes, sin tarjeta de crédito), luego agrega la configuración con tu clave:

{
  "mcpServers": {
    "nefesh": {
      "url": "https://mcp.nefesh.ai/mcp",
      "headers": {
        "X-Nefesh-Key": "YOUR_API_KEY"
      }
    }
  }
}

Archivos de configuración específicos por agente

{
  "servers": {
    "nefesh": {
      "type": "http",
      "url": "https://mcp.nefesh.ai/mcp",
      "headers": {
        "X-Nefesh-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

{
  "context_servers": {
    "nefesh": {
      "settings": {
        "url": "https://mcp.nefesh.ai/mcp",
        "headers": {
          "X-Nefesh-Key": "<YOUR_API_KEY>"
        }
      }
    }
  }
}

[mcp_servers.nefesh]
url = "https://mcp.nefesh.ai/mcp"

mcpServers:
  - name: nefesh
    type: streamable-http
    url: https://mcp.nefesh.ai/mcp

Todos los agentes se conectan vía Streamable HTTP — no se requiere instalación local.

Integración A2A (Protocolo Agente-a-Agente v1.0)

Nefesh también está disponible como un agente compatible con A2A. Mientras que MCP maneja la llamada de herramientas (tu agente llama a Nefesh), A2A permite la colaboración entre agentes — otros agentes de IA pueden comunicarse con Nefesh como un par.

Tarjeta de Agente: /.well-known/agent-card.json

Endpoint A2A: POST https://mcp.nefesh.ai/a2a (JSON-RPC 2.0)

Misma autenticación que MCP — encabezado X-Nefesh-Key o token Authorization: Bearer. El nivel gratuito funciona en ambos protocolos.

Fuente: nefesh-ai/nefesh-a2a · Documentación: nefesh.ai/docs/a2a

Herramientas MCP

Cómo funciona el autoaprovisionamiento

Tu agente de IA puede obtener una clave gratuita de API de forma autónoma. Solo haces clic en un enlace de correo.

1. El agente te pregunta: "¿Cuál es tu dirección de correo electrónico?"
2. El agente llama a request_api_key(your_real_email). No se necesita clave de API para esta llamada.
3. Recibes un correo de verificación y haces clic en el enlace
4. El agente consulta check_api_key_status(your_real_email) cada 10 segundos
5. Una vez verificado, el agente recibe la clave de API y puede usar todas las demás herramientas

Importante: El agente debe usar tu dirección de correo real y accesible. Los correos desechables están bloqueados. El enlace de verificación debe ser clicado por ti para activar la clave.

Nivel gratuito: 1,000 llamadas/mes, todos los tipos de señales, 10 solicitudes/min. Sin tarjeta de crédito.

Prueba rápida

Después de agregar la configuración, pregúntale a tu agente de IA:

"¿Qué herramientas tienes de Nefesh?"

Debería listar las 6 herramientas anteriores.

Precios

Alternativa CLI

¿Prefieres la terminal en lugar de MCP? Usa la CLI de Nefesh (costo de token 10-32 veces menor que MCP para agentes de IA):

npm install -g @nefesh/cli
nefesh ingest --session test --heart-rate 72 --tone calm
nefesh state test --json

GitHub: nefesh-ai/nefesh-cli

Alternativa Gateway

¿Quieres que la IA se adapte automáticamente? Usa el Nefesh Cognitive Compute Router. Cambia la URL base de tu LLM a gateway.nefesh.ai y el gateway ajusta el prompt del sistema y la temperatura según el estado biométrico. Tres modos: compatible con OpenAI (/v1/chat/completions), paso a través de Anthropic (/v1/messages), y Anthropic unificado para cualquier backend. Cero cambios de código.

GitHub: nefesh-ai/nefesh-gateway

Protocolo de Estado Humano (HSP)

Nefesh implementa y mantiene el Human State Protocol, una especificación abierta para intercambiar el estado fisiológico humano entre sistemas de IA. HSP define un formato JSON estándar para puntuaciones de estrés, recomendaciones de comportamiento y retroalimentación de adaptación, de modo que cualquier agente pueda producir o consumir datos de estado humano de manera interoperable. Apache 2.0.

GitHub: nefesh-ai/human-state-protocol · Documentación: nefesh.ai/docs/hsp

Documentación

• Referencia completa de la API
• Inicio rápido
• Mapeo de estados
• Servidor MCP · Fuente
• Servidor A2A · Fuente
• Cognitive Compute Router (Gateway) · Fuente
• CLI · Fuente
• Human State Protocol (HSP) · Fuente
• Tarjeta de agente A2A
• Especificación del protocolo A2A

Privacidad

• Sin subidas de video o audio — el procesamiento en el borde se ejecuta en el lado del cliente
• Sin almacenamiento de PII
• Cumplimiento GDPR/BIPA — eliminación en cascada vía delete_subject
• No es un dispositivo médico — solo para adaptación contextual de IA

Licencia

MIT — ver LICENSE.