Codex Octopus
Rank #6,117io.github.xiaolai/codex-octopus
Spawn multiple specialized Codex agents as MCP servers, each independently configured.
Codex Octopus is a Model Context Protocol (MCP) server published by xiaolai. It ranks #6,117 of 115,460 servers tracked on MCP Toplist, and its repository has 18 GitHub stars. Codex Octopus is listed across 4 registries — Official MCP, mcp.so, Glama and PulseMCP, with 2 tracked versions. It was first listed on Apr 2, 2026 and most recently updated on Apr 2, 2026.
Ranks ahead of 109,343 of 115,460 servers on MCP Toplist.
Use Codex Octopus
No credentials or required configuration declared — add it to your MCP client and go.
claude mcp add codex-octopus -e "CODEX_API_KEY=<your CODEX_API_KEY>" -e "CODEX_TOOL_NAME=<your CODEX_TOOL_NAME>" -e "CODEX_MODEL=<your CODEX_MODEL>" -e "CODEX_SANDBOX_MODE=<your CODEX_SANDBOX_MODE>" -e "CODEX_APPROVAL_POLICY=<your CODEX_APPROVAL_POLICY>" -e "CODEX_APPEND_INSTRUCTIONS=<your CODEX_APPEND_INSTRUCTIONS>" -e "CODEX_FACTORY_ONLY=<your CODEX_FACTORY_ONLY>" -- npx -y codex-octopusReplace each placeholder with your own value before saving.
[mcp_servers.codex-octopus]
command = "npx"
args = ["-y", "codex-octopus"]
[mcp_servers.codex-octopus.env]
CODEX_API_KEY = "<your CODEX_API_KEY>"
CODEX_TOOL_NAME = "<your CODEX_TOOL_NAME>"
CODEX_MODEL = "<your CODEX_MODEL>"
CODEX_SANDBOX_MODE = "<your CODEX_SANDBOX_MODE>"
CODEX_APPROVAL_POLICY = "<your CODEX_APPROVAL_POLICY>"
CODEX_APPEND_INSTRUCTIONS = "<your CODEX_APPEND_INSTRUCTIONS>"
CODEX_FACTORY_ONLY = "<your CODEX_FACTORY_ONLY>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"codex-octopus": {
"command": "npx",
"args": [
"-y",
"codex-octopus"
],
"env": {
"CODEX_API_KEY": "<your CODEX_API_KEY>",
"CODEX_TOOL_NAME": "<your CODEX_TOOL_NAME>",
"CODEX_MODEL": "<your CODEX_MODEL>",
"CODEX_SANDBOX_MODE": "<your CODEX_SANDBOX_MODE>",
"CODEX_APPROVAL_POLICY": "<your CODEX_APPROVAL_POLICY>",
"CODEX_APPEND_INSTRUCTIONS": "<your CODEX_APPEND_INSTRUCTIONS>",
"CODEX_FACTORY_ONLY": "<your CODEX_FACTORY_ONLY>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"codex-octopus": {
"command": "npx",
"args": [
"-y",
"codex-octopus"
],
"env": {
"CODEX_API_KEY": "<your CODEX_API_KEY>",
"CODEX_TOOL_NAME": "<your CODEX_TOOL_NAME>",
"CODEX_MODEL": "<your CODEX_MODEL>",
"CODEX_SANDBOX_MODE": "<your CODEX_SANDBOX_MODE>",
"CODEX_APPROVAL_POLICY": "<your CODEX_APPROVAL_POLICY>",
"CODEX_APPEND_INSTRUCTIONS": "<your CODEX_APPEND_INSTRUCTIONS>",
"CODEX_FACTORY_ONLY": "<your CODEX_FACTORY_ONLY>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"codex-octopus": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codex-octopus"
],
"env": {
"CODEX_API_KEY": "<your CODEX_API_KEY>",
"CODEX_TOOL_NAME": "<your CODEX_TOOL_NAME>",
"CODEX_MODEL": "<your CODEX_MODEL>",
"CODEX_SANDBOX_MODE": "<your CODEX_SANDBOX_MODE>",
"CODEX_APPROVAL_POLICY": "<your CODEX_APPROVAL_POLICY>",
"CODEX_APPEND_INSTRUCTIONS": "<your CODEX_APPEND_INSTRUCTIONS>",
"CODEX_FACTORY_ONLY": "<your CODEX_FACTORY_ONLY>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"codex-octopus": {
"command": "npx",
"args": [
"-y",
"codex-octopus"
],
"env": {
"CODEX_API_KEY": "<your CODEX_API_KEY>",
"CODEX_TOOL_NAME": "<your CODEX_TOOL_NAME>",
"CODEX_MODEL": "<your CODEX_MODEL>",
"CODEX_SANDBOX_MODE": "<your CODEX_SANDBOX_MODE>",
"CODEX_APPROVAL_POLICY": "<your CODEX_APPROVAL_POLICY>",
"CODEX_APPEND_INSTRUCTIONS": "<your CODEX_APPEND_INSTRUCTIONS>",
"CODEX_FACTORY_ONLY": "<your CODEX_FACTORY_ONLY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"codex-octopus": {
"command": "npx",
"args": [
"-y",
"codex-octopus"
],
"env": {
"CODEX_API_KEY": "<your CODEX_API_KEY>",
"CODEX_TOOL_NAME": "<your CODEX_TOOL_NAME>",
"CODEX_MODEL": "<your CODEX_MODEL>",
"CODEX_SANDBOX_MODE": "<your CODEX_SANDBOX_MODE>",
"CODEX_APPROVAL_POLICY": "<your CODEX_APPROVAL_POLICY>",
"CODEX_APPEND_INSTRUCTIONS": "<your CODEX_APPEND_INSTRUCTIONS>",
"CODEX_FACTORY_ONLY": "<your CODEX_FACTORY_ONLY>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.xiaolai%2Fcodex-octopus)<a href="https://mcptoplist.com/server/io.github.xiaolai%2Fcodex-octopus"><img src="https://mcptoplist.com/badge/io.github.xiaolai%2Fcodex-octopus.svg" alt="MCP Toplist: Top 10% of 115,460" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 1 registry (3 delisted)
xiaolai
Other servers by xiaolai
View all xiaolai servers →Available versions (2)
| Version | Published |
|---|---|
| 1.0.1 | Apr 2, 2026 |
| 0.1.0 | Nov 25, 2024 |
Frequently asked questions
- Who maintains Codex Octopus?
- Codex Octopus is maintained by xiaolai, which publishes 4 MCP servers (4 total versions) tracked on MCP Toplist.
- Is Codex Octopus listed on the Official MCP Registry?
- Yes — Codex Octopus is listed on the Official MCP Registry, alongside mcp.so, Glama and PulseMCP.
- How many versions does Codex Octopus have?
- MCP Toplist tracks 2 versions of Codex Octopus, most recently published on Apr 2, 2026.
- Where can I find the source code for Codex Octopus?
- The source code for Codex Octopus is hosted at github.com/xiaolai/codex-octopus.