Nefesh MCP Server

A Model Context Protocol server that gives AI agents real-time awareness of human physiological state — stress level, confidence, and behavioral adaptation prompts.

What it does

Your AI agent sends sensor data (heart rate, voice, video, text) via the Nefesh API. The MCP server returns a unified stress score (0–100), a state label (Calm → Acute Stress), and an adaptation prompt that tells the agent how to adjust its behavior.

Signals supported: cardiovascular (HR, HRV, RR intervals), vocal (pitch, jitter, shimmer), visual (facial action units), textual (sentiment, keywords)

Setup

1. Get an API key

Get your key at nefesh.ai/pricing ($25/month, 50,000 calls).

2. Add to your AI agent

Find your agent's MCP config file:

Add the following configuration (works with most agents):

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

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

All agents connect via Streamable HTTP — no local installation required.

Tools

Quick test

After adding the config, ask your AI agent:

"What tools do you have from Nefesh?"

It should list the tools above.

State labels

Documentation

• Quick Start
• API Reference
• State Mapping

Privacy

• No video uploads — edge processing runs client-side
• No PII stored — strict schema validation
• GDPR/BIPA compliant — cascading deletion via delete_subject
• Not a medical device — for contextual AI adaptation only

License

Proprietary. See nefesh.ai/terms.