Codex Octopus MCP Server

@xiaolai

Basic information

About Codex Octopus MCP Server

One brain, many arms. Spawn multiple specialized Codex agents as MCP servers via the OpenAI Codex SDK. Each instance gets its own model, sandbox, effort, and personality.

#codex #openai #multi-agent #mcp-server#codex-sdk

Codex Octopus MCP Server config

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

{
  "mcpServers": {
    "codex": {
      "command": "npx",
      "args": [
        "codex-octopus"
      ],
      "env": {
        "CODEX_SANDBOX_MODE": "workspace-write",
        "CODEX_APPROVAL_POLICY": "never"
      }
    }
  }
}

Codex 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 Codex Octopus?

Codex Octopus is an MCP server that wraps the OpenAI Codex SDK, enabling you to run multiple specialized Codex agents from any MCP client. Each agent can have its own model, sandbox, effort, and personality.

How to use Codex Octopus?

Configure it in your MCP client with the command npx codex-octopus and set environment variables like CODEX_SANDBOX_MODE and CODEX_APPROVAL_POLICY. You can also use the factory wizard to generate .mcp.json configs interactively.

Key features of Codex Octopus

Run several agents with different configurations simultaneously
Override model, sandbox, effort, approval policy, and cwd per invocation
Follow up on previous conversations via the _reply tool
Generate .mcp.json configs interactively with the factory wizard
Sandbox and approval modes only tighten per invocation for security

Use cases of Codex Octopus

A strict code reviewer operating in a read-only sandbox
A test writer with workspace‑write access to generate tests
A cheap quick helper running on minimal effort
A deep thinker using maximum effort for complex tasks

Frequently asked questions

What does Codex Octopus do that a single Codex instance cannot?

It lets you run multiple specialized Codex agents simultaneously, each with its own model, sandbox, effort, and personality, all from any MCP client.

How do I configure agents with different behaviors?

You can set environment variables like `CODEX_SANDBOX_MODE` and `CODEX_APPROVAL_POLICY`, or use per-invocation overrides for model, sandbox, effort, and more.

Can I have ongoing conversations with an agent?

Yes, the `_reply` tool provides session continuity, allowing you to follow up on previous interactions.

Is there a way to generate the configuration for an agent interactively?

Yes, the factory wizard generates `.mcp.json` configs interactively, guiding you through the setup process.

Comments

More Other MCP servers

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K