Claude Octopus

@xiaolai

About Claude Octopus

One brain, many arms. Spawn multiple specialized Claude Code agents as MCP servers via the Agent SDK. Each instance gets its own model, tools, prompt, and personality.

#claude-code #agent-sdk #multi-agent #mcp-server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "claude": {
      "command": "npx",
      "args": [
        "claude-octopus"
      ],
      "env": {
        "CLAUDE_PERMISSION_MODE": "bypassPermissions"
      }
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Claude Octopus?

An MCP server that wraps the Claude Agent SDK, allowing you to run multiple specialized Claude Code agents—each with its own model, tools, system prompt, and personality—from any MCP client.

How to use Claude Octopus?

Install via npm and configure as an MCP server using the JSON snippet shown, setting the environment variable CLAUDE_PERMISSION_MODE to bypassPermissions. Then invoke agents with your desired configuration.

Key features of Claude Octopus

Multi-instance: run several agents with different configs simultaneously
18 env vars for model, tools, effort, permissions, plugins, prompts
Per-invocation overrides for model, tools, effort, permissions
Session continuity via _reply tool for follow-up conversations
Factory wizard to generate .mcp.json configs interactively
Hot-configurable: plugins, effort, permissions adjustable per invocation

Use cases of Claude Octopus

A strict code reviewer that only reads files
A test writer that defaults to TDD
A cheap quick helper on the Haiku model
A deep thinker on the Opus model

FAQ from Claude Octopus

How is Claude Octopus different from a single Claude Code instance?

Claude Octopus lets you run multiple specialized agents simultaneously, each with its own model, tools, and configuration, instead of one instance doing everything the same way.

What configurations can I customize per agent?

You can customize model, tools, effort, permissions, plugins, system prompts, and more via 18 environment variables or per-invocation overrides.

Can I use different models for different agents?

Yes, you can specify a different model per agent, such as Haiku for quick tasks and Opus for deep thinking.

How do I follow up on a previous conversation?

Use the _reply tool to continue a previous session, enabling follow-up conversations.

How do I generate configuration files?

Run the factory wizard to interactively generate .mcp.json configurations.

Frequently asked questions

How is Claude Octopus different from a single Claude Code instance?

Claude Octopus lets you run multiple specialized agents simultaneously, each with its own model, tools, and configuration, instead of one instance doing everything the same way.

What configurations can I customize per agent?

You can customize model, tools, effort, permissions, plugins, system prompts, and more via 18 environment variables or per-invocation overrides.

Can I use different models for different agents?

Yes, you can specify a different model per agent, such as Haiku for quick tasks and Opus for deep thinking.

How do I follow up on a previous conversation?

Use the `_reply` tool to continue a previous session, enabling follow-up conversations.

How do I generate configuration files?

Run the factory wizard to interactively generate `.mcp.json` configurations.

Comments

Basic information

More AI & Agents MCP servers

XDC AI

XDC AI is a remote MCP server available at https://xdcai.tech.

Just Domain.

Just.

Just Domain is the domain registrar for businesses built with AI. An AI assistant checks availability and both prices, first year and renewal, and hands back a checkout link for justdomain.ai. Read only by design: no pur

Nero AI Image Processing

nero-com

We provide AI-powered tools for image enhancement, upscaling, background removal, photo restoration, colorization, denoising, and compression. All features are available through our API documentation.

Plainpaper

The AI marketing canvas for Claude and MCP agents. Your agent drafts campaigns as cards on a shared board, briefed by your brand rules, approved by you.

🛡️ A.I.G（AI-Infra-Guard）

Tencent

A full-stack AI Red Teaming platform securing AI ecosystems via OpenClaw Security Scan, Agent Scan, Skills Scan, MCP scan, AI Infra scan and LLM jailbreak evaluation.

4.1K