@ruddia/being-mcp-server

@ruddia/being-mcp-server

MCP server for Being — a Personality Runtime that gives AI agents persistent memory, personality, and relationships.

Connect from any MCP-compatible client: OpenClaw, Claude Desktop, Claude Cowork, Claude Managed Agents, and more.

Quick Start

npm install -g @ruddia/being-mcp-server

BEING_API_URL=https://your-being-worker.example.com \
BEING_API_TOKEN=brt_xxx \
BEING_ID=your-being-id \
being-mcp-server

Environment Variables

Variable	Required	Description
BEING_API_URL	—	Being Worker base URL (default: http://localhost:3100)
BEING_API_TOKEN	✅	Auth token (brt_... — issued from the dashboard)
BEING_ID	✅	Target Being ID
LLM_API_KEY	For trigger_patrol	Anthropic API key (BYOK)

Transport Modes

stdio (default)

For OpenClaw, Claude Desktop, MCP Inspector, etc.

being-mcp-server

Streamable HTTP

For Claude Cowork, Managed Agents, and remote connections.

being-mcp-server --http --port 3200

Endpoint: POST /mcp

Tools

Tool	Description	LLM Key
recall_memory	Search memory graph for relevant nodes	—
merge_nodes	Merge similar memory nodes	—
update_memory	Read/write partner memory (preferences, knowledge, relationships, notes, etc.)	—
conclude_topic	Archive current topic and save summary	—
search_history	Search past conversation history	—
update_relation	Update relationships with external entities	—
get_current_time	Get current time (JST)	—
trigger_patrol	Run patrol — extract scenes and generate memory nodes	Required

Client Configuration Examples

OpenClaw / Claude Desktop

{
  "mcpServers": {
    "being": {
      "command": "npx",
      "args": ["-y", "@ruddia/being-mcp-server"],
      "env": {
        "BEING_API_URL": "https://your-being-worker.example.com",
        "BEING_API_TOKEN": "brt_xxx",
        "BEING_ID": "your-being-id"
      }
    }
  }
}

Streamable HTTP (Cowork / Managed Agents)

{
  "mcpServers": {
    "being": {
      "url": "http://localhost:3200/mcp"
    }
  }
}

What is Being?

Being is a Personality Runtime — an open-source layer that gives AI agents:

• 🧠 Persistent Memory — Graph-based memory with automatic consolidation and decay
• 🎭 Personality — SOUL definitions that shape voice, values, and behavior
• 🤝 Relationships — Track and evolve connections with users and entities
• 🔄 Patrol — Autonomous memory processing (scene extraction, consolidation, reflection)

Learn more at github.com/wnbhr/being.

License

MIT