Nefesh — Real-Time Human State Awareness for AI
Nefesh runs ONE hosted remote MCP server at https://mcp.nefesh.ai/mcp — Streamable HTTP, protocol revision 2025-06-18, stateful (an Mcp-Session-Id is issued on initialize and required on every later call). Anonymous initialize, tools/list, resources/list, prompts/list and resources/templates/list all succeed; six tools are returned with full JSON Schema inputSchemas and are saved verbatim in mcp/nefesh-ai-mcp-tools.json. Two tools (request_api_key, check_api_key_status) work with no credential and let an agent self-provision a free key by email verification; the other four require the X-Nefesh-Key header and, without it, return an in-band error text with isError false. The server is published to the official MCP Registry as ai.nefesh/human-state and also self-describes at https://mcp.nefesh.ai/.well-known/mcp.json. No stdio package exists.
One-click install for Cursor, VS Code, Claude, and 20+ other MCP clients, powered by API Commons MCP Install — visit install.apicommons.org for more information.
Endpoint
Hosted endpoint · transport streamable-http
Connect
This is a remote MCP server — point an MCP client at the endpoint URL. Clients with native remote support (Claude, Cursor, VS Code, …):
For stdio-only clients (older Claude Desktop, etc.), bridge with mcp-remote:
If the server requires authentication, add the provider's token/header (e.g. an X-API-Key) per its docs. A quick reachability check:
Tools
get_human_state— Get current unified human state for a session: state, stress_score 0-100, confidence, suggested_action, action_reason, adaptation_effectiveness from the 2nd call. Requires a prior ingest.ingest— Send biometric signals from any sensor, get unified state back. Include subject_id for cross-session trigger memory.get_trigger_memory— Retrieve the psychological trigger profile for a subject — active vs resolved topics with observation_count, avg_score, peak_score, last_seen.get_session_history— Timestamped state history for a session with an overall trend (rising | falling | stable).request_api_key— Request a free Nefesh API key by email verification. The tool text instructs the agent to ask the user for a real email and never invent one.check_api_key_status— Poll a pending key request every 10 s; returns pending or ready with the key (returned once; request expires after 15 minutes).
About MCP
The Model Context Protocol (MCP) is an open protocol Anthropic introduced for connecting LLM-based agents to external tools and data sources. Providers publish MCP servers that expose their API surface as structured, discoverable tools — an MCP-compatible client (Claude Desktop, Cursor, Cline, Continue, etc.) can connect to the server and call its tools without any per-provider integration code.
Browse every MCP server on the APIs.io network or compare with the broader Agent Skill surfaces of the same providers.
Work with this as data
Every MCP server here is available over the APIs.io API and to AI agents over MCP.