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
claude mcp add agent-guild -- npx -y @oddessentials/agent-guildWhat 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-guildPlatform CLI
codex mcp add agent-guild -- npx -y @oddessentials/agent-guildConfig file
{
"mcpServers": {
"agent-guild": {
"command": "npx",
"args": [
"-y",
"@oddessentials/agent-guild"
]
}
}
}Config file
{
"servers": {
"agent-guild": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@oddessentials/agent-guild"
]
}
}
}Platform CLI
gemini mcp add agent-guild npx -y @oddessentials/agent-guildStep 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.