MCP.Market

Claude Octopus MCP server

by xiaolai·io.github.xiaolai/claude-octopus·v1.1.10·21 stars
No reviews yet

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

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

21 stars

Reviews

Write one

Nobody has reviewed Claude Octopus yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Claude Octopus tools (1, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • create_claude_code_mcpwrite action

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan42 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 2 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Claude Octopus compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 65% of 48,255 servers
Tools
1
the typical server has 7
Tools that change things
100%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
21
more than 91% of 28,688 servers

What its tools let an agent do: 1 create

Install Claude Octopus in Claude Code, Cursor or VS Code

Runs npx -y claude-octopus on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add claude-octopus -- npx -y claude-octopus
Add to Cursor

What the publisher says

From the Claude Octopus repository's README, as published. We do not edit it. Read it on GitHub

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. Each one shows up as a separate tool in your MCP client.

Prerequisites

  • Node.js >= 18
  • Claude Code — the Claude Agent SDK is bundled as a dependency, but it spawns Claude Code under the hood, so you need a working claude CLI installation
  • Anthropic API key (ANTHROPICAPIKEY env var) or an active Claude Code OAuth session

Install

Three paths, pick whichever matches your MCP client.

npm (most direct)

npm install claude-octopus

npx (no install needed)

Skip the install entirely — reference claude-octopus@latest in your .mcp.json and the client will fetch on demand (see Quick Start below).

MCP Registry

The server is published to the MCP Registry under the name io.github.xiaolai/claude-octopus. Registry-aware MCP clients can resolve and install it by that name without touching npm directly.

Quick Start

The fastest way to get started:

npx claude-octopus init

This interactive wizard lets you pick a template, detects your MCP client, and writes the config for you.

Or add to your .mcp.json manually:

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

This gives you six tools:

That's it — you have Claude Code as a tool, with full workflow observability built in.

Multiple Agents

The real power is running several instances with different configurations:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Claude Octopus: common questions

Is Claude Octopus MCP server safe?
Mostly: it is graded B (83/100). Read the Claude Octopus safety report
How do I install Claude Octopus?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Claude Octopus need an API key?
Yes. The registry entry asks for ANTHROPIC_API_KEY.
Is Claude Octopus maintained?
The last commit was 39 days ago (2026-09-26). The latest release is v1.1.10.
How does Claude Octopus compare with other MCP servers?
safety score 83/100 (higher than 65% of 48,255 servers); tools 1 (the typical server has 7); tools that change things 100% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.