Nefesh MCP + Servidor A2A

Un servidor de Model Context Protocol y Agent-to-Agent (A2A) que proporciona 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 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 mejoran por sí mismos.

Efectividad de la adaptación (Bucle cerrado)

La mayoría de las API 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 (más rápido)

Añade la configuración sin una clave API; tu agente obtendrá una automáticamente.

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

Luego pregúntale a tu agente:

"Conéctate a Nefesh y consígueme una clave API gratuita para name@example.com"

El agente llama a request_api_key → haces clic en un enlace de correo electrónico → el agente obtiene la clave. Sin formularios de registro, sin copiar y pegar manualmente. Después de eso, añade 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 añade 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 del 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 a través de 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 a 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)

Autenticación igual que MCP — cabecera X-Nefesh-Key o token Authorization: Bearer. El nivel gratuito funciona en ambos protocolos.

Fuente: nefesh-ai/nefesh-a2a · Docs: nefesh.ai/docs/a2a

Herramientas MCP

Cómo funciona el aprovisionamiento automático

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

1. El agente llama a request_api_key(email) — no se necesita clave API para esta llamada

2. Recibes un correo de verificación y haces clic en el enlace

3. El agente consulta check_api_key_status(request_id) cada 10 segundos

4. Una vez verificado, el agente recibe la clave API y puede usar todas las demás herramientas

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

Prueba rápida

Después de añadir 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 sobre MCP? Usa la CLI de Nefesh (costo de tokens 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 ajustará 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. Sin 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 para que cualquier agente pueda producir o consumir datos de estado humano de forma interoperable. Apache 2.0.

GitHub: nefesh-ai/human-state-protocol · Docs: 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

• No se suben videos ni audios — el procesamiento se ejecuta en el lado del cliente

• No se almacenan datos de identificación personal (PII)

• Cumple con GDPR/BIPA — eliminación en cascada mediante delete_subject

• No es un dispositivo médico — solo para adaptación contextual de IA

Licencia

MIT — ver LICENSE.