Nefesh — Real-Time Human State Awareness for AI

ai.nefesh/human-state · v4.0.0 · communication

Nefesh — Real-Time Human State Awareness for AI is healthy: it completed an MCP handshake in 2634 ms and exposes 7 tools.

Fuses biometric signals into a stress score (0-100) for AI adaptation. MCP + A2A native.

Endpoint: https://mcp.nefesh.ai/mcp (streamable-http)

Repository · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count7
Latency2634 ms
Last checked (UTC)2026-10-14T09:01:02.164Z

Health history

Checked (UTC)StatusLatencyError
2026-10-14T09:01:02.164ZHealthy2634

Tools (7)

get_human_stateGet current unified human state for a session. Call this before generating important responses. Returns: - state: calm | relaxed | focused | stressed | acute_stress - stress_score: 0-100 (lower = calmer) - confidence: 0.0-1.0 (based on signal quality and device type) - suggested
ingestSend biometric signals from any sensor, get unified state back. Required: session_id + timestamp (ISO 8601) + at least one signal. Send whatever you have — the API fuses all signals into one state. Common signals (highest impact): - heart_rate (bpm, 30-220) + rmssd (ms) — cardiovas
get_trigger_memoryRetrieve psychological trigger profile for a subject. Returns which conversation topics consistently cause stress (active triggers) and which have been resolved over time. - active triggers: topics where stress was elevated across multiple sessions. Tread carefully. - resolved triggers
get_session_historyGet state history for a session over time. Returns timestamped datapoints with stress_score, state, and heart_rate for each observation. Includes an overall trend: rising | falling | stable. Use minutes parameter to control the lookback window (default: 5, max: 60). Useful for dete
delete_subjectPermanently delete all sessions and trigger memory for a subject. Irreversible. Only call when the user explicitly requests this deletion.
request_api_keyStart free API key authorization; no existing API key needed. Returns a verification_url. Ask the user to open that URL in their browser, enter their own email, then open the verification email and confirm access for their agent. This tool does not accept email addresses and does no
check_api_key_statusCheck a pending API key authorization using its request_id. Use request_id exactly as returned by request_api_key, never an email. Poll every 10 seconds. awaiting_user means the user must open the URL; pending means email verification is still required. ready returns the API key onc