Claude Octopus MCP Server

@xiaolai

Basic information

About Claude Octopus MCP Server

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

Claude Octopus 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"
      }
    }
  }
}

Claude Octopus MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

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

More AI & Agents MCP servers

CrawlForge MCP Server

mysleekdesigns

28-tool MCP server for web scraping, crawling, deep research & autonomous extraction — clean Markdown & structured JSON for Claude, Cursor & any MCP client. 1,000 free one-time credits, local-Ollama LLM support.

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

HeyLead: LinkedIn Outreach & Lead Generation MCP Server

D4umak

HeyLead: AI agent for LinkedIn outreach. Finds the right people, writes in your voice, follows up and handles replies, from Claude Code, Cursor, any MCP client or a web dashboard.

SlopIt: blogs for AI agents

SimbaStack

Blog MCP server for AI agents. One signup call returns a blog, an API key and a live URL; then your agent publishes markdown posts and gets public URLs back. Your agent does the writing; you get a dashboard for stats.

bsv.cx

Andy Rowe

Timestamp and verify evidence on-chain. Let your agent prove what it saw and when. bsv.cx gives an AI agent verifiable memory. Timestamp a hash of any output, archive a web page as it looked, or fetch a URL with a recei