Skip to main content
MCP server CX Codex

Agent Guild — Claude Code MCP server: what it does, how to install

An MCP server that links an agent to the Agent Guild session manager, letting it view and control terminals for Claude Code, Codex and other CLI tools.

AGPL-3.0 ★ 6 updated 2026-10-29

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add agent-guild -- npx -y @oddessentials/agent-guild
Open on GitHub

What Agent Guild does

Agent Guild runs a local manager process and serves a single web page listing sessions for Claude Code, Codex CLI, Antigravity CLI, Grok Build, Docker Agent and plain shells. Each session is the actual tool running in a real terminal rather than a chat simulation, so whatever sign-in method the tool normally uses, a subscription, an API key, Amazon Bedrock or a custom gateway, keeps working unchanged.

The agent-guild MCP server is the bridge an agent uses to talk to that already-running manager: it exposes the session list and lets Claude Code, Codex, Cursor, GitHub Copilot or Gemini CLI steer those terminals directly. The manager itself binds only to 127.0.0.1 with no account and no relay server, so reaching it from another device means setting up your own Tailscale network or reverse proxy.

Running it requires Node.js 22 or newer. Access to the manager's page is gated by a token generated on first launch.

What it helps with

  • connect an agent to live Claude Code and Codex CLI sessions
  • switch between several CLI tools from one place
  • give an agent control over Docker Agent and shell sessions
  • manage sessions without routing data through an external server
  • pick up the same sessions later from a phone or browser

Example prompts for the agent

  • Connect to Agent Guild and list the active sessions
  • Open the Claude Code session through agent-guild and run a command in it
  • Check which CLI tools are currently running in Agent Guild

How to install Agent Guild

Platform CLI

claude mcp add agent-guild -- npx -y @oddessentials/agent-guild

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Agent Guild

How do I install Agent Guild in Claude Code?

Run claude mcp add agent-guild -- npx -y @oddessentials/agent-guild.

What does Agent Guild do?

It's an MCP server that links an agent to the locally running Agent Guild manager, exposing sessions for Claude Code, Codex CLI, Docker Agent and other tools so the agent can view and control them.

What do I need to run Agent Guild?

Node.js 22 or newer, plus a running Agent Guild manager that the MCP server reaches over 127.0.0.1.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open