Afferens

io.github.afferensPublished by GitHub account afferensv0.2.1Updated Oct 24, 2026

Real-time physical perception for AI agents — vision, spatial, acoustic, environmental

VerifiedSTDIODesktop onlyData & AnalyticsAI & ML

Overview

AI-generated overview

Afferens is a local MCP server that gives AI assistants live physical sensor data — vision, spatial, acoustic, environmental, molecular and node health.

What you can do
Query live perception events by modality (vision, spatial, acoustic, environmental, molecular, interoception) with filtering and limits, using an API key. Fetch a demo feed across all six modalities without a key. Verify feed freshness by pulling two snapshots and returning headers, age and a hash-based live/stale/unchanged verdict.
When to use it
Use it when an assistant needs to reason over real-time physical-world sensor readings rather than static data, for example to inspect detected objects, positions, sounds or environmental conditions, or to check whether a sensor feed is genuinely live.
Requirements
Runs as a local Node.js process via npx from the npm package, or in HTTP mode on a configurable port for remote clients. The perceive and verify tools need an AFFERENS_API_KEY, supplied as an environment variable; the demo tool works without one. A free tier is offered at sign-up.
Before you install
The API key is a credential: keep it out of shared configs and logs. The server sends queries to the Afferens service, so sensor data and request details leave your machine. The verify tool fetches the feed twice, which may consume quota or tokens.

Installation

In SourceWeft

  1. Open Afferens in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@afferens/mcp-server

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.

Tools

ToolAuthDescription
afferens_demoNoneLive perception data across all 6 modalities. Free, no key needed.
afferens_perceiveAPI keyQuery live events by modality with filtering and limits.
afferens_verifyAPI keyFetch the feed twice and return a proof bundle with headers, age, and a freshness verdict.

Modalities: VISION / SPATIAL / ACOUSTIC / ENVIRONMENTAL / MOLECULAR / INTEROCEPTION

Quick Start

Free tier: 10,000 tokens, no card required. Get your key at afferens.com.

Local MCP Clients

bash
claude mcp add afferens -- npx -y @afferens/mcp-server

Then set your key:

bash
claude mcp add afferens -e AFFERENS_API_KEY=YOUR_KEY -- npx -y @afferens/mcp-server

This stdio setup works for Claude Code, Claude Desktop, Cursor, and Windsurf.

Remote MCP Clients

For hosted or browser-based clients, run Afferens in HTTP mode and point the client at the /mcp endpoint:

bash
AFFERENS_TRANSPORT=http AFFERENS_PORT=8790 AFFERENS_API_KEY=YOUR_KEY node dist/index.js

Then register the endpoint:

json
{  "afferens": {    "url": "http://127.0.0.1:8790/mcp",    "bearer_token_env_var": "AFFERENS_API_KEY"  }}

Claude Desktop / Cursor / Windsurf

Add to your MCP config file:

json
{  "mcpServers": {    "afferens": {      "command": "npx",      "args": ["-y", "@afferens/mcp-server"],      "env": {        "AFFERENS_API_KEY": "YOUR_KEY"      }    }  }}

Config file locations:

  • Claude Desktop (Mac): ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
  • Cursor: .cursor/mcp.json in your project root
  • Windsurf: ~/.codeium/windsurf/mcp_config.json

Try it without a key

json
{  "mcpServers": {    "afferens": {      "command": "npx",      "args": ["-y", "@afferens/mcp-server"]    }  }}

Call afferens_demo - no API key needed.

Usage

Once connected, your AI agent can call:

text
afferens_perceive({ modality: "VISION", limit: 5 })

Returns structured perception events your agent can reason over and act on.

For demo verification:

text
afferens_verify({ modality: "VISION", limit: 3, wait_ms: 2000 })

Returns two raw snapshots plus headers, age, and a hash check so you can show whether the feed is live, stale, or unchanged.

Links

License

MIT

Source: README.md at commit d0f9687

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.