How do I install Afferens?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Afferens need an API key?

No required environment variable is listed on this record.

What transport does Afferens use?

Afferens runs locally over stdio.

When was Afferens last checked?

Last checked 2026-11-09. Real-time physical perception for AI agents — vision, spatial, acoustic, environmental

Afferens MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @afferens/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.afferens-mcp-server -- npx -y @afferens/mcp-server@0.2.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.afferens-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@afferens/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

@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

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

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/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

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

Afferens

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Afferens?

Does Afferens need an API key?

What transport does Afferens use?

When was Afferens last checked?

Documentation

@afferens/mcp-server

Tools

Quick Start

Local MCP Clients

Remote MCP Clients

Claude Desktop / Cursor / Windsurf

Try it without a key

Usage

Links

License