ESSE MCP Server

One AI. Many agents. Fused.

Model Context Protocol server for ESSE — fuse multiple AI agents into one unified mind, directly from Claude Desktop, Claude Code, Cline, Cursor, or any MCP-compatible client.

Quick Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "esse": {
      "command": "npx",
      "args": ["-y", "esse-mcp"],
      "env": {
        "ESSE_API_KEY": "your-venice-api-key",
        "ESSE_PROVIDER": "venice"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Restart Claude Desktop. ESSE tools appear in the 🔧 menu.

Claude Code

claude mcp add esse npx esse-mcp --env ESSE_API_KEY=your-key ESSE_PROVIDER=venice

Cline / Cursor

Same JSON config as Claude Desktop — paste into your MCP settings panel.

API Keys

| Provider | Env Var | Get Key | |----------|---------|---------| | Venice AI (recommended, privacy-first) | ESSE_API_KEY or VENICE_API_KEY | venice.ai/settings/api | | OpenAI | ESSE_API_KEY + ESSE_PROVIDER=openai | platform.openai.com | | Anthropic | ESSE_API_KEY + ESSE_PROVIDER=anthropic | console.anthropic.com |

Available Tools

| Tool | Description | |------|-------------| | esse_quick | Quick fusion + execution in one step. Auto-selects agents. | | esse_fuse | Fuse 2–5 agents into a session. Returns session_id. | | esse_execute | Execute a task using a fused session. | | esse_list_agents | List all built-in agents and their specialties. | | esse_list_sessions | View active fusion sessions. | | esse_memory | View shared memory across sessions. | | esse_defuse | Release a session and its agents. |

Built-in Agents

| Key | Agent | Specialty | |-----|-------|-----------| | research | ResearchAgent | Knowledge retrieval, fact-finding | | writer | WriterAgent | Content generation, drafting | | critic | CriticAgent | Quality analysis, fact-checking | | coder | CoderAgent | Software engineering, code generation | | planner | PlannerAgent | Strategy, roadmaps, task breakdown | | tester | TesterAgent | QA, validation, edge case detection |

Fusion Modes

| Mode | How It Works | Best For | |------|-------------|----------| | capability-assimilation | Agents work sequentially, each building on the last | Content pipelines | | synchronization-link | Agents run in parallel, results merged | Brainstorming, analysis | | perfect-convergence | All agents fused into one singular consciousness | Complex, high-stakes tasks |

Usage Examples

In Claude Desktop (after setup):

"Use esse_quick to write a research-backed article on the future of AI agents"

"Fuse the coder, planner and tester agents, then build me a REST API for user auth"

"Run esse_quick in perfect-convergence mode to brainstorm startup ideas in the AI health space"

Manual Run

# Clone and run locally
git clone https://github.com/VeniceEsse/VVV-Esse.git
cd VVV-Esse/esse-mcp
npm install
npm run build
ESSE_API_KEY=your-key node dist/index.js

Links

• 🌐 Website: vvvesse.xyz
• 🐦 X: @VeniceEsse
• 📦 GitHub: VeniceEsse/VVV-Esse

MIT License © ESSE AI