Claude Octopus MCP Server

by xiaolaiio.github.xiaolai/claude-octopusv1.1.10

Spawn multiple specialized Claude Code agents as MCP servers, each independently configured.

21Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install Claude Octopus MCP server

claude mcp add claude-octopus -e ANTHROPIC_API_KEY='<anthropic-api-key>' -- npx -y claude-octopus

{
  "mcpServers": {
    "claude-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "claude-octopus"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<anthropic-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "claude-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "claude-octopus"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<anthropic-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "claude-octopus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "claude-octopus"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<anthropic-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "claude-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "claude-octopus"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<anthropic-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ANTHROPIC_API_KEY	—	yes	Anthropic API key (leave unset to inherit from parent process)
CLAUDE_TOOL_NAME	—	—	Tool name prefix (default: claude_code)
CLAUDE_MODEL	—	—	Model: sonnet, opus, haiku, or full ID
CLAUDE_PERMISSION_MODE	—	—	Permission mode: default, acceptEdits, bypassPermissions, plan
CLAUDE_ALLOWED_TOOLS	—	—	Comma-separated list of available tools (e.g. Read,Grep,Glob for read-only)
CLAUDE_APPEND_PROMPT	—	—	Additional system prompt appended to the default
CLAUDE_FACTORY_ONLY	—	—	Set to true to expose only the factory wizard tool

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-05-20 · 5mo ago · official registry · v1.1.10

FAQ

›How do I install the Claude Octopus MCP server in Claude Code?

Run: claude mcp add claude-octopus -e ANTHROPIC_API_KEY='<anthropic-api-key>' -- npx -y claude-octopus. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Claude Octopus require an API key?

Yes. It expects ANTHROPIC_API_KEY, of which 1 is a secret.

›Can I use Claude Octopus as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Claude Octopus in the official MCP registry?

Yes, as io.github.xiaolai/claude-octopus.