Nefesh

Servidor Nefesh MCP + A2A

Um servidor Model Context Protocol e Agent-to-Agent (A2A) que dá aos agentes de IA consciência em tempo real do estado fisiológico humano.

O que ele faz

Envie dados de sensores (frequência cardíaca, voz, expressão facial, sentimento de texto) e receba um estado unificado com uma ação legível por máquina que seu agente pode seguir diretamente. Zero engenharia de prompt necessária.

Na 2ª+ chamada, a resposta inclui adaptation_effectiveness — informando ao seu agente se a abordagem anterior realmente funcionou. Um sistema de feedback em malha fechada para agentes auto-melhoráveis.

Eficácia de Adaptação (Malha Fechada)

A maioria das APIs fornece um estado. A Nefesh informa se sua reação a esse estado realmente funcionou.

Na 2ª+ chamada dentro de uma sessão, cada resposta inclui:

{
  "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
  }
}

Seu agente pode ler effective: true e saber se sua desescalada anterior funcionou. Se effective: false, o agente ajusta sua estratégia. Nenhum outro sistema de estado humano fornece esse ciclo de feedback.

Configuração

Opção A: Conecte primeiro, obtenha uma chave através do seu agente (mais rápido)

Adicione a configuração sem uma chave de API — seu agente obterá uma automaticamente.

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

Depois pergunte ao seu agente:

"Obtenha uma chave de API Nefesh gratuita usando meu endereço de e-mail"

O agente chama request_api_key → você clica em um link de e-mail → o agente captura a chave. Sem formulário de inscrição, sem copiar e colar manualmente. Depois disso, adicione a chave à sua configuração para sessões futuras:

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

Opção B: Obtenha uma chave primeiro, depois conecte

Cadastre-se em nefesh.ai/signup (1.000 chamadas/mês, sem cartão de crédito) e adicione a configuração com sua chave:

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

Arquivos de configuração 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 os agentes se conectam via Streamable HTTP — sem necessidade de instalação local.

Integração A2A (Protocolo Agente-a-Agente v1.0)

A Nefesh também está disponível como um agente compatível com A2A. Enquanto o MCP lida com chamadas de ferramentas (seu agente chama a Nefesh), o A2A permite colaboração entre agentes — outros agentes de IA podem se comunicar com a Nefesh como um par.

Cartão do Agente: /.well-known/agent-card.json

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

Mesma autenticação do MCP — cabeçalho X-Nefesh-Key ou token Authorization: Bearer. O nível gratuito funciona em ambos os protocolos.

Fonte: nefesh-ai/nefesh-a2a · Documentação: nefesh.ai/docs/a2a

Ferramentas MCP

Como funciona o autoprovisionamento

Seu agente de IA pode obter uma chave de API gratuita de forma autônoma. Você só clica em um link de e-mail.

1. O agente pergunta: "Qual é o seu endereço de e-mail?"
2. O agente chama request_api_key(your_real_email). Nenhuma chave de API é necessária para esta chamada.
3. Você recebe um e-mail de verificação e clica no link
4. O agente faz polling em check_api_key_status(your_real_email) a cada 10 segundos
5. Após a verificação, o agente recebe a chave de API e pode usar todas as outras ferramentas

Importante: O agente deve usar seu endereço de e-mail real e acessível. E-mails descartáveis são bloqueados. O link de verificação deve ser clicado por você para ativar a chave.

Nível gratuito: 1.000 chamadas/mês, todos os tipos de sinais, 10 req/min. Sem cartão de crédito.

Teste rápido

Após adicionar a configuração, pergunte ao seu agente de IA:

"Quais ferramentas você tem da Nefesh?"

Ele deve listar as 6 ferramentas acima.

Preços

Alternativa CLI

Prefere o terminal ao MCP? Use a CLI da Nefesh (custo de token 10-32x menor que o 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

Quer que a IA se adapte automaticamente? Use o Roteador de Computação Cognitiva Nefesh. Altere a URL base do seu LLM para gateway.nefesh.ai e o gateway ajusta o prompt do sistema e a temperatura com base no estado biométrico. Três modos: compatível com OpenAI (/v1/chat/completions), passagem Anthropic (/v1/messages) e Anthropic Unificado para qualquer backend. Zero mudanças de código.

GitHub: nefesh-ai/nefesh-gateway

Protocolo de Estado Humano (HSP)

A Nefesh implementa e mantém o Protocolo de Estado Humano, uma especificação aberta para troca de estado fisiológico humano entre sistemas de IA. O HSP define um formato JSON padrão para pontuações de estresse, recomendações comportamentais e feedback de adaptação, para que qualquer agente possa produzir ou consumir dados de estado humano de forma interoperável. Apache 2.0.

GitHub: nefesh-ai/human-state-protocol · Documentação: nefesh.ai/docs/hsp

Documentação

• Referência Completa da API
• Início Rápido
• Mapeamento de Estados
• Servidor MCP · Fonte
• Servidor A2A · Fonte
• Roteador de Computação Cognitiva (Gateway) · Fonte
• CLI · Fonte
• Protocolo de Estado Humano (HSP) · Fonte
• Cartão do Agente A2A
• Especificação do Protocolo A2A

Privacidade

• Sem uploads de vídeo ou áudio — processamento de borda executado no lado do cliente
• Sem armazenamento de PII
• Conformidade com GDPR/BIPA — exclusão em cascata via delete_subject
• Não é um dispositivo médico — apenas para adaptação contextual de IA

Licença

MIT — veja LICENSE.