Fuses biometric signals into a stress score (0-100) for AI adaptation. MCP + A2A native.
2026-10-19
Stars
—
Tools
7
Uptime
—
Send sensor data (heart rate, voice, facial expression, text sentiment), get back a unified state with a machine-readable action your agent can follow directly. Zero prompt engineering required.
On the 2nd+ call, the response includes adaptation_effectiveness — telling your agent whether its previous approach actually worked. A closed-loop feedback system for self-improving agents.
Adaptation Effectiveness (Closed-Loop)
Most APIs give you a state. Nefesh tells you whether your reaction to that state actually worked.
On the 2nd+ call within a session, every response includes:
Your agent can read effective: true and know its previous de-escalation worked. If effective: false, the agent adjusts its strategy. No other human-state system provides this feedback loop.
Setup
Option A: Connect first, get a key through your agent (fastest)
Add the config without an API key — your agent will get one automatically.
"Get me a free Nefesh API key using my email address"
The agent calls request_api_key → you click one email link → the agent picks up the key. No signup form, no manual copy-paste. After that, add the key to your config for future sessions:
All agents connect via Streamable HTTP — no local installation required.
A2A Integration (Agent-to-Agent Protocol v1.0)
Nefesh is also available as an A2A-compatible agent. While MCP handles tool-calling (your agent calls Nefesh), A2A enables agent-collaboration — other AI agents can communicate with Nefesh as a peer.
Request a free API key. You MUST ask the user for their real email first. Do not invent or guess emails. The user receives a verification link they must click. Poll with check_api_key_status until ready.
check_api_key_status
No
Poll for API key activation using the same email the user provided. Returns pending or ready with API key.
get_human_state
Yes
Get stress state (0-100), suggested_action (maintain/simplify/de-escalate/pause), and adaptation_effectiveness — a closed-loop showing whether your previous action reduced stress.
ingest
Yes
Send biometric signals (heart rate, HRV, voice tone, expression, sentiment, 30+ fields) and get unified state back. Include subject_id for trigger memory.
get_trigger_memory
Yes
Get psychological trigger profile — which topics cause stress (active) and which have been resolved over time.
get_session_history
Yes
Get timestamped state history with trend (rising/falling/stable).
How self-provisioning works
Your AI agent can get a free API key autonomously. You only click one email link.
Agent asks you: "What is your email address?"
Agent calls request_api_key(your_real_email). No API key needed for this call.
You receive a verification email and click the link
Agent polls check_api_key_status(your_real_email) every 10 seconds
Once verified, the agent receives the API key and can use all other tools
Important: The agent must use your real, accessible email address. Disposable emails are blocked. The verification link must be clicked by you to activate the key.
Free tier: 1,000 calls/month, all signal types, 10 req/min. No credit card.
Quick test
After adding the config, ask your AI agent:
"What tools do you have from Nefesh?"
It should list the 6 tools above.
Pricing
Plan
Price
API Calls
Free
$0
1,000/month, no credit card
Solo
$25/month
50,000/month
Enterprise
Custom
Custom SLA
CLI Alternative
Prefer the terminal over MCP? Use the Nefesh CLI (10-32x lower token cost than MCP for AI agents):
npm install -g @nefesh/cli
nefesh ingest --session test --heart-rate 72 --tone calm
nefesh state test --json
Want the AI to adapt automatically? Use the Nefesh Cognitive Compute Router. Change your LLM base URL to gateway.nefesh.ai and the gateway adjusts system prompt and temperature based on biometric state. Three modes: OpenAI-compatible (/v1/chat/completions), Anthropic passthrough (/v1/messages), and Unified Anthropic for any backend. Zero code changes.
Nefesh implements and maintains the Human State Protocol, an open specification for exchanging human physiological state between AI systems. HSP defines a standard JSON format for stress scores, behavioral recommendations, and adaptation feedback so any agent can produce or consume human state data interoperably. Apache 2.0.
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
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) — cardiovas
How do I install Nefesh — Real Time Human State Awareness For AI?
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
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 dete
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 no
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 onc
Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Nefesh — Real Time Human State Awareness For AI need an API key?
No required environment variable is listed on this record.
What transport does Nefesh — Real Time Human State Awareness For AI use?
Nefesh — Real Time Human State Awareness For AI is reached over HTTP.
When was Nefesh — Real Time Human State Awareness For AI last checked?
Last checked 2026-10-19. Fuses biometric signals into a stress score (0-100) for AI adaptation. MCP + A2A native.
