Nefesh
About
Real-time human state awareness for AI agents. Fuses biometric signals into a unified stress score (0-100) via Streamable HTTP.
Details
- Author
- tomstuhl
- Categories
- Cloud Service, AI, Other, Infrastructure
Jump to
Setup
Install Nefesh in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/tomstuhl/nefesh-mcp-server
Follow the installation instructions in the repository README, then restart your MCP client.
AModel Context ProtocolandAgent-to-Agent (A2A)server that gives AI agents real-time awareness of human physiological state.
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 includesadaptation_effectiveness— telling your agent whether its previous approach actually worked. A closed-loop feedback system for self-improving agents.
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 readeffective: trueand know its previous de-escalation worked. Ifeffective: false, the agent adjusts its strategy. No other human-state system provides this feedback loop.
Option A: Connect first, get a key through your agent (fastest)
Add the configwithout an API key— your agent will get one automatically.
{ "mcpServers": { "nefesh": { "url": "https://mcp.nefesh.ai/mcp" } } }
"Get me a free Nefesh API key using my email address"
The agent callsrequest_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:
{ "mcpServers": { "nefesh": { "url": "https://mcp.nefesh.ai/mcp", "headers": { "X-Nefesh-Key": "nfsh_free_..." } } } }
Sign up atnefesh.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" } } } }
{ "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 viaStreamable 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.
Agent Card:/.well-known/agent-card.json
A2A Endpoint:POST https://mcp.nefesh.ai/a2a(JSON-RPC 2.0)
Same authentication as MCP —X-Nefesh-Keyheader orAuthorization: Bearertoken. Free tier works on both protocols.
Source:nefesh-ai/nefesh-a2a· Docs:nefesh.ai/docs/a2a
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 callsrequest_api_key(your_real_email). No API key needed for this call.
- You receive a verification email and click the link
- Agent pollscheck_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.
After adding the config, ask your AI agent:
"What tools do you have from Nefesh?"
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 theNefesh Cognitive Compute Router. Change your LLM base URL togateway.nefesh.aiand 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 theHuman 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.
GitHub:nefesh-ai/human-state-protocol· Docs:nefesh.ai/docs/hsp
- Full API Reference
- Quick Start
- State Mapping
- MCP Server·Source
- A2A Server·Source
- Cognitive Compute Router (Gateway)·Source
- CLI·Source
- Human State Protocol (HSP)·Source
- A2A Agent Card
- A2A Protocol Spec
- No video or audio uploads — edge processing runs client-side
- No PII stored
- GDPR/BIPA compliant — cascading deletion viadelete_subject
- Not a medical device — for contextual AI adaptation only
AI workout coach MCP server. Access training data, workout history, personal records, and body progress through Claude Desktop.
AI-powered cycling training coach: personalized training plans, daily workouts, nutrition, strength training, fitness metrics (FTP, VO2Max), and Strava, Garmin, Wahoo, MyWhoosh, and Rouvy integrations.
Behavioral trust scoring for 14,820+ MCP servers. Check reliability, latency, and success rates before tool calls.
Guck is a tiny, MCP-first telemetry store for agentic debugging
Fuses biometric signals into a stress score (0-100) for real-time AI adaptation. MCP + A2A native.
Connect your health data to AI assistants like Cursor, Claude, and Windsurf.
AI-powered wellbeing insights with real-time benchmarks and alerts.
Local MCP server that exposes Whoop recovery, sleep, and strain data to AI agents
Expose data observability, lineage, test results & incidents to AI agents via MCP
Interact with the RAD Security platform which provides AI-powered security insights for Kubernetes and cloud environments.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





