Claude Octopus
About
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.
Details
- Author
- xiaolai
- Downloads
- 428
- Categories
- AI
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Claude OctopusCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"claude octopus": {
"claude": {
"command": "npx",
"args": [
"claude-octopus"
],
"env": {
"CLAUDE_PERMISSION_MODE": "bypassPermissions"
}
}
}
}
}McpServers
{
"claude": {
"command": "npx",
"args": [
"claude-octopus"
],
"env": {
"CLAUDE_PERMISSION_MODE": "bypassPermissions"
}
}
}Claude Octopus
One brain, many arms. An MCP server that wraps the Claude Agent SDK, letting you run multiple specialized Claude Code agents — each with its own model, tools, system prompt, and personality — from any MCP client.Why
Claude Code is powerful. But one instance does everything the same way. Sometimes you want a strict code reviewer that only reads files. A test writer that defaults to TDD. A cheap quick helper on Haiku. A deep thinker on Opus. Claude Octopus lets you spin up as many of these as you need. Same binary, different configurations.Quick Start
``json
{
"mcpServers": {
"claude": {
"command": "npx",
"args": ["claude-octopus"],
"env": {
"CLAUDE_PERMISSION_MODE": "bypassPermissions"
}
}
}
}
`
Key Features
- Multi-instance — run several agents with different configs simultaneously
- 18 env vars — model, tools, effort, permissions, plugins, prompts, and more
- Per-invocation overrides — change model, tools, effort, permissions per call
- Session continuity — follow up on previous conversations via _reply tool
- Factory wizard — generate .mcp.json` configs interactively
- Hot-configurable — plugins, effort, permissions adjustable per invocation
Links
- GitHub - npm - License: ISCSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
