Nefesh — Real-Time Human State Awareness for AI
Fuses biometric signals into a stress score (0-100) for AI adaptation. MCP + A2A native.
| Endpoint | https://mcp.nefesh.ai/mcp (streamable-http) |
|---|---|
| Registry version | 4.0.0 |
| Now | 7 tools · grade A (97) · pin ts_77fbe443c2b62f61ba22a48530ca5ef1 · protocol 2025-06-18 |
| First / last listed | 2026-10-26 00:44 UTC / 2026-10-26 00:44 UTC |
| Grade over time | 2026-10-26: A (97), 7 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: get_human_state ingest get_trigger_memory get_session_history delete_subject request_api_key check_api_key_status
get_human_state | Get 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_action: maintain_engagement | simplify_and_focus | de-escalate_and_shorten | pause_and_ground
- params: session_id* |
ingest | Send 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) — cardiovascular
- tone: calm | tense | anxious | hostile — vocal
- sentiment: -1.0 to 1.0 — textual
params: session_id*, timestamp*, heart_rate, rmssd, sdnn, spo2, pnn50, mean_ibi, ibi_count, tone, speech_rate, pitch_variability, expression, gaze, posture, engagement, sentiment, urgency, glucose_mg_dl, glucose_mmol_l, glucose_trend, eeg_alpha_power, eeg_beta_power, eeg_theta_power, cognitive_load, eda, skin_temperature, respiratory_rate, steps_last_minute, activity_level, sleep_stage, stress_score, source_device, confidence, subject_id, user_message, ai_response |
get_trigger_memory | Retrieve 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: topics where stress has decreased. Safe to explore deeper.
Each trigger includes observation_ params: subject_id* |
get_session_history | Get 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 detecting stress patterns during a conversation. Not a medical device.
params: session_id*, minutes |
delete_subject | Permanently delete all sessions and trigger memory for a subject.
Irreversible. Only call when the user explicitly requests this deletion.
params: subject_id* |
request_api_key | Start 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 not send email.
Do not choose, invent, or submit an email on the user's behalf.
Poll check_api params: none |
check_api_key_status | Check 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 once only. Store it and include it in all subsequent HTTP calls.
Stop on expired; ask the user befo params: request_id* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.