Society ElizaOS

You can seamlessly connect your ElizaOS agents with Cursor using the Society ElizaOS Connector MCP. This MCP runs locally and lets you list agents, select one to chat with, and exchange messages directly from the Cursor IDE, streamlining your ElizaOS interactions within your development environment.

How to use

Once you have the MCP server configured in Cursor, you can access four core capabilities from the Cursor interface: list available ElizaOS agents, select a specific agent to chat with (the Room ID will mirror the Agent ID), send messages to the chosen agent, and verify the connection and active agent state. Use these actions to quickly switch between agents, start conversations, and monitor your MCP’s health and current configuration. The flow is designed to be interactive and local, so you can develop and test conversations without leaving Cursor.

How to install

Prerequisites you need before installing the MCP: node.js and npm (v14 or higher), an ElizaOS server instance accessible at a URL like http://localhost:3000, and Cursor IDE with MCP support.

Step-by-step setup using the quick options shown here keeps Cursor in control of starting and wiring the MCP with your ElizaOS server.

{
  "mcpServers": {
    "society-elizaos-mcp-npx": { 
      "command": "npx",
      "args": [
        "-y",
        "society-elizaos-mcp@1.0.9"
      ],
      "env": {
        "ELIZAOS_SERVER_URL": "http://localhost:3000",
        "ELIZAOS_USER_ID": "00000000-0000-0000-0000-000000000000",
        "ELIZAOS_WORLD_ID": "00000000-0000-0000-0000-000000000000",
        "ELIZAOS_AGENT_ID": "00000000-0000-0000-0000-000000000000",
        "ELIZAOS_ROOM_ID": "00000000-0000-0000-0000-000000000000",
        "ELIZAOS_CONNECTION_TIMEOUT": "120000",
        "ELIZAOS_RESPONSE_TIMEOUT": "90000",
        "PORT": "3099",
        "DEBUG": "true",
        "NODE_ENV": "production",
        "MCP_DISABLE_PINGS": "true"
      }
    }
  }
}

Additional setup for local development

If you want to run a local development version of the connector, you can build and run it yourself. The process shown here provides the exact commands to clone, install dependencies, build, and run the MCP locally.

Build and run locally with a standard environment setup.

# Clone and install dependencies
git clone https://github.com/your-username/society-elizaos-mcp.git
cd society-elizaos-mcp
npm install

# Build the package
npm run build

# Run locally with environment variables
export ELIZAOS_SERVER_URL="http://localhost:3000"
export ELIZAOS_USER_ID="your-elizaos-user-uuid"
export ELIZAOS_WORLD_ID="your-elizaos-world-uuid"
export ELIZAOS_AGENT_ID="your-initial-agent-uuid"
export ELIZAOS_ROOM_ID="your-initial-agent-uuid"
node dist/index.js

Local development convenience script

You can also start the MCP with the provided convenience script if you prefer a quick path to running locally.

# The script sets default environment variables and runs the server
./scripts/mcp_run.sh

Configure Cursor for local version

If you want Cursor to use your local version instead of the npm package, add a local config entry that points to your built dist index and supplies the required environment variables.

{
  "mcpServers": {
    "society-elizaos-mcp-local": {
      "command": "node",
      "args": [
        "/path/to/your/society-elizaos-mcp/dist/index.js"
      ],
      "env": {
        "ELIZAOS_SERVER_URL": "http://localhost:3000",
        "ELIZAOS_USER_ID": "your-elizaos-user-uuid",
        "ELIZAOS_WORLD_ID": "your-elizaos-world-uuid",
        "ELIZAOS_AGENT_ID": "your-initial-agent-uuid", 
        "ELIZAOS_ROOM_ID": "your-initial-agent-uuid",
        "ELIZAOS_CONNECTION_TIMEOUT": "120000",
        "ELIZAOS_RESPONSE_TIMEOUT": "90000",
        "PORT": "3069",
        "DEBUG": "true",
        "NODE_ENV": "production",
        "MCP_DISABLE_PINGS": "true"
      }
    }
  }
}

Available tools

get_status

Retrieves the current connection state and configuration for the ElizaOS MCP.

list_agents

Lists all available agents from your ElizaOS server.

chat_with_agent

Sends a message to the currently selected agent and returns the agent's response.

set_agent

Switches to a different agent; the agent_id and room_id must be identical.