Nefesh — Real-Time Human State Awareness for AI MCP server
online · 100% uptimeai.nefesh/human-state·v4.0.0Fuses biometric signals into a stress score (0-100) for AI adaptation. MCP + A2A native.
0 stars
Reviews
Write oneNobody has reviewed Nefesh — Real-Time Human State Awareness for AI yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Nefesh — Real-Time Human State Awareness for AI tools (6, 1 write)
write = sends, deletes, buys or postscheck_api_key_statusFreeCheck the status of a pending API key request. Use the exact same email the user provided to request_api_key. Poll this every 10 seconds. Once the user clicks the verification link in their inbox, status changes from 'pending' to 'ready' and the response includes the API key. Store it immediately — returned once only. Expires after 15 minutes.
get_human_stateFreeGet 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 - action_reason: human-readable explanation of why this action was suggested - adaptation_effectiveness (on 2nd+ call): shows whether your previous suggested_action actually reduced stress — contains previous_action, stress_delta, and effective boolean. Use this to self-improve. Use suggested_action to adapt your response: calm/relaxed = full complexity, focused = shorter and structured, stressed = max 2 sentences, acute_stress = one grounding sentence only. Requires a prior ingest call to have data. Not a medical device.
get_session_historyFreeGet 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.
get_trigger_memoryFreeRetrieve 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_count, avg_score, peak_score, and last_seen. Requires prior ingest calls with the same subject_id. Not a medical device.
ingestwrite actionFreeSend 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 - expression: relaxed | neutral | tense — visual For trigger memory (cross-session psychological tracking): - Include subject_id (consistent per user, hashed) Returns same fields as get_human_state plus signals_received list and topics_detected (if conversation text was included). source_device is optional but improves confidence scoring. Not a medical device.
request_api_keyFreeRequest a free Nefesh API key. No existing API key needed for this call. IMPORTANT: You MUST ask the user for their real email address before calling this tool. Do NOT invent, guess, or generate an email address. The user will receive a verification link they must click to activate the key. Without clicking that link, no API key will be issued. Disposable or temporary email services are blocked. Example prompt to the user: "What is your email address? You will receive a verification link to activate your free API key." Flow: call this with the user's real email, then poll check_api_key_status every 10 seconds until status is 'ready'. Free tier: 1,000 calls/month, all signal types, 10 req/min. No credit card.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 1697ms20/20
- Tool poisoning6 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancelast push 164 days ago8/15
- Maintainer identitynamespace and repository owner differ4/10
How Nefesh — Real-Time Human State Awareness for AI compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 73/100
- higher than 39% of 48,255 servers
- Tools
- 6
- the typical server has 7
- Tools that change things
- 17%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 107 ms
- faster than 82% of 30,031 servers
What its tools let an agent do: 5 read · 1 change
Install Nefesh — Real-Time Human State Awareness for AI in Claude Code, Cursor or VS Code
claude mcp add --transport http human-state https://mcp.nefesh.ai/mcp
What the publisher says
From the Nefesh — Real-Time Human State Awareness for AI repository's README, as published. We do not edit it. Read it on GitHub
Nefesh MCP + A2A Server
A Model Context Protocol and Agent-to-Agent (A2A) server that gives AI agents real-time awareness of human physiological state.
What it does
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:
{
"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
}
}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.
{
"mcpServers": {
"nefesh": {
"url": "https://mcp.nefesh.ai/mcp"
}
}
}Then ask your agent:
"Get me a free Nefesh API key using my email address"
The agent calls requestapikey → 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:
{
"mcpServers": {
"nefesh": {
"url": "https://mcp.nefesh.ai/mcp",
"headers": {
"X-Nefesh-Key": "nfsh_free_..."
}
}
}
}Option B: Get a key first, then connect
Sign up at nefesh.ai/signup (1,000 calls/month, no credit card), then add the config with your key:
{
"mcpServers": {
"nefesh": {
"url": "https://mcp.nefesh.ai/mcp",
"headers": {
"X-Nefesh-Key": "YOUR_API_KEY"
}
}
}
}Agent-specific config files
VS Code (Copilot) — uses servers instead of mcpServers
{
"servers": {
"nefesh": {
"type": "http",
"url": "https://mcp.nefesh.ai/mcp",
"headers": {
"X-Nefesh-Key": "<YOUR_API_KEY>"
}
}
}
}Zed — uses context_servers in settings.json
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Nefesh — Real-Time Human State Awareness for AI: common questions
- Is Nefesh — Real-Time Human State Awareness for AI MCP server safe?
- Mostly: it is graded B (73/100). Read the Nefesh — Real-Time Human State Awareness for AI safety report
- How do I install Nefesh — Real-Time Human State Awareness for AI?
- It runs remotely at mcp.nefesh.ai. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Nefesh — Real-Time Human State Awareness for AI need an API key?
- Yes. The registry entry asks for
X-Nefesh-Key. - Is Nefesh — Real-Time Human State Awareness for AI maintained?
- The last commit was 202 days ago (2026-04-16). The latest release is v4.0.0.
- Is Nefesh — Real-Time Human State Awareness for AI up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Nefesh — Real-Time Human State Awareness for AI?
- Servers from other publishers that do the same job: Ask Jev MCP server.
- How does Nefesh — Real-Time Human State Awareness for AI compare with other MCP servers?
- safety score 73/100 (higher than 39% of 48,255 servers); tools 6 (the typical server has 7); tools that change things 17% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Nefesh — Real-Time Human State Awareness for AI
Same job from other publishers: the closest match first, then the best rated.
- Ask JevEvaluate state with typed choice, score, and probability questions.not reviewedEstablishedA