Afferens MCP server

by afferens·io.github.afferens/mcp-server·v0.2.1

No reviews yet

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

B80/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B80/100

full report

Adoption

New

0 stars46 downloads/wk

Reviews

Write one

Nobody has reviewed Afferens yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Afferens tools (5, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

afferens_actuatewrite action
Send a command to a physical Afferens node. Use this to trigger actions on hardware — capture a camera frame, sound an alarm, move to coordinates, rotate a camera, lock or unlock, adjust a sensor, or shut down a node. Costs 5 Sense Tokens per command. Requires AFFERENS_API_KEY.
afferens_demo
Get real-time physical perception data from all 6 Afferens sensory modalities — VISION, SPATIAL, ACOUSTIC, ENVIRONMENTAL, MOLECULAR, and INTEROCEPTION. No API key required. Use this to demonstrate what live sensor data looks like before your AI agent is fully wired up. Free to call.
afferens_ingest
Push live sensor data into the Afferens sensory layer. Use this when your AI agent is connected to physical hardware and wants to contribute real-time perception events. The data becomes queryable via afferens_perceive. Requires AFFERENS_API_KEY.
afferens_perceive
Query live physical perception events from the Afferens sensory layer. Returns real-time sensor data your AI agent can act on — object detections, positions, sounds, environmental readings, chemical traces, and node health. Requires AFFERENS_API_KEY (free tier: 10,000 tokens, no card required — sign up at afferens.com).
afferens_verify
Fetch the live perception feed twice with a short delay, then return both raw payloads plus a hash-based freshness check. Use this as a demo proof bundle when you need to show the feed is not placeholder data.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan3 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 145 days ago8/15
Maintainer identityregistry namespace matches repository owner7/10

Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Afferens compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 80/100; higher than 60% of 48,255 servers
Tools: 5; the typical server has 7
Tools that change things: 20%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 46; more than 38% of 12,191 servers with a package

What its tools let an agent do: 4 read · 1 change

Install Afferens in Claude Code, Cursor or VS Code

Runs npx -y @afferens/mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

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

Add to Cursor

What the publisher says

From the Afferens repository's README, as published. We do not edit it. Read it on GitHub

@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

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

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

Then set your key:

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:

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

Then register the endpoint:

{
  "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:

{
  "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/claudedesktopconfig.json
Claude Desktop (Windows): %APPDATA%\Claude\claudedesktopconfig.json
Cursor: .cursor/mcp.json in your project root
Windsurf: ~/.codeium/windsurf/mcp_config.json

Try it without a key

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

Call afferens_demo - no API key needed.

Usage

Once connected, your AI agent can call:

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

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

For demo verification:

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.

License

MIT

Nothing above is checked by us. What we check is on the safety report.

Afferens: common questions

Is Afferens MCP server safe?: Mostly: it is graded B (80/100). Read the Afferens safety report
How do I install Afferens?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Afferens need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Afferens maintained?: The last commit was 183 days ago (2026-05-05). The latest release is v0.2.1.
What can I use instead of Afferens?: Servers from other publishers that do the same job: Visual Memory MCP server.
How does Afferens compare with other MCP servers?: safety score 80/100 (higher than 60% of 48,255 servers); tools 5 (the typical server has 7); tools that change things 20% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Afferens

Same job from other publishers: the closest match first, then the best rated.

Visual Memory MCP
Local visual UI cache for AI agents using perceptual hashing, CLIP, and 3D spatial grounding.
not reviewed
Established
A