The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Afferens MCP listing page.
MCP server for Afferens - real-time physical perception for AI agents.
Use it from local MCP clients over stdio or remote/hosted clients over streamable HTTP. It gives any MCP-compatible AI assistant live sensor data: object detections, positions, sounds, environmental readings, chemical traces, and node health.
| Tool | Auth | Description |
|---|---|---|
afferens_demo | None | Live perception data across all 6 modalities. Free, no key needed. |
afferens_perceive | API key | Query live events by modality with filtering and limits. |
afferens_verify | API key | Fetch the feed twice and return a proof bundle with headers, age, and a freshness verdict. |
Modalities: VISION / SPATIAL / ACOUSTIC / ENVIRONMENTAL / MOLECULAR / INTEROCEPTION
Free tier: 10,000 tokens, no card required. Get your key at afferens.com.
Then set your key:
This stdio setup works for Claude Code, Claude Desktop, Cursor, and Windsurf.
For hosted or browser-based clients, run Afferens in HTTP mode and point the client at the /mcp endpoint:
Then register the endpoint:
Add to your MCP config file:
Config file locations:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json.cursor/mcp.json in your project root~/.codeium/windsurf/mcp_config.jsonCall afferens_demo - no API key needed.
Once connected, your AI agent can call:
Returns structured perception events your agent can reason over and act on.
For demo verification:
Returns two raw snapshots plus headers, age, and a hash check so you can show whether the feed is live, stale, or unchanged.
MIT