home / mcp / claude agents mcp server

Claude Agents MCP Server

Provides centralized Claude agent management via MCP for HTTP and stdio access with live updates across sessions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "dev-brewery-claude-agents-mcp": {
      "url": "http://localhost:8765",
      "headers": {
        "API_PORT": "8765",
        "NODE_ENV": "development",
        "CONFIG_DATA_PATH": "/absolute/path/to/claude-agents-mcp/data"
      }
    }
  }
}

You deploy and manage Claude agent definitions, configurations, and custom commands from a centralized MCP server. This setup lets you update many Claude sessions in real time without file lock conflicts, keeps agent data in a SQLite database, and provides a reliable HTTP API and local stdio interface for your Claude Code instances to consume.

How to use

Connect your Claude Code instance to the MCP server to manage agents, global config, commands, and project context from one place. You can run the MCP server locally for development, or deploy it with Docker for a shared environment. Use the HTTP API or the stdio integration to perform create, read, update, and delete operations on agents, commands, and configurations.

How to install

Prerequisites you need before installing the MCP server:

Node.js 14+ installed on your machine
Docker (optional, for container deployment)
Git (for cloning or pulling the project)

Follow these concrete steps to set up the MCP server in local development mode:

# Install dependencies
npm install

# Run migration to import existing configs
npm run migrate -- --source "G:/Nextcloud"

# Start development server (stdio mode)
npm run dev

Additional setup and configuration

You can run the server in two ways: via stdio for Claude Code integration or via HTTP for remote API access.

{
  "mcpServers": {
    "claude-agents": {
      "command": "node",
      "args": ["/absolute/path/to/claude-agents-mcp/dist/index.js"],
      "env": {
        "CONFIG_DATA_PATH": "/absolute/path/to/claude-agents-mcp/data"
      }
    }
  }
}

Alternatively enable HTTP access to the MCP server using a network URL:

{
  "mcpServers": {
    "claude-agents": {
      "url": "http://localhost:8765"
    }
  }
}

Docker deployment

If you prefer containerized deployment, you can run the MCP server with Docker. Build and run the services in detached mode, then monitor logs to ensure the server starts correctly.

# Build and start containers in detached mode
docker-compose up -d

# View logs for the MCP server
docker-compose logs -f claude-agents-mcp

Available tools

list_agents

List all agents, optionally filtered by category

get_agent

Retrieve a specific agent definition

publish_agent

Create or update an agent

delete_agent

Remove an agent

search_agents

Search agents by name or content

get_global_config

Get CLAUDE.md, session_init, or constraints

set_global_config

Update global configuration

list_commands

List all custom slash commands

get_command

Retrieve a command definition

publish_command

Create or update a command

delete_command

Remove a command

get_project_context

Get project-specific settings

set_project_context

Save project context

get_sync_history

View recent changes