claude-octopus
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CLAUDE_CWD | No | Working directory | process.cwd() |
| CLAUDE_BETAS | No | Beta features (comma-separated) | |
| CLAUDE_MODEL | No | Model (`sonnet`, `opus`, `haiku`, or full ID) | |
| CLAUDE_EFFORT | No | Thinking effort (`low`, `medium`, `high`, `max`) | |
| CLAUDE_PLUGINS | No | Local plugin paths (comma-separated) | |
| CLAUDE_SETTINGS | No | Path to settings JSON or inline JSON | |
| CLAUDE_MAX_TURNS | No | Max conversation turns | |
| CLAUDE_TOOL_NAME | No | Tool name prefix (`<name>` and `<name>_reply`) | claude_code |
| ANTHROPIC_API_KEY | No | Anthropic API key for this agent | inherited from parent |
| CLAUDE_DESCRIPTION | No | Tool description shown to the host AI | |
| CLAUDE_MCP_SERVERS | No | MCP servers for the inner agent (JSON) | |
| CLAUDE_SERVER_NAME | No | MCP server name in protocol handshake | claude-octopus |
| CLAUDE_FACTORY_ONLY | No | Only expose the factory wizard tool | false |
| CLAUDE_ALLOWED_TOOLS | No | Comma-separated tool restriction (available tools) | all |
| CLAUDE_APPEND_PROMPT | No | Appended to the default prompt | |
| CLAUDE_SYSTEM_PROMPT | No | Replaces the default Claude Code system prompt | |
| CLAUDE_MAX_BUDGET_USD | No | Max spend per invocation | |
| CLAUDE_ADDITIONAL_DIRS | No | Extra directories to grant access (comma-separated) | |
| CLAUDE_PERMISSION_MODE | No | Permission mode (`default`, `acceptEdits`, `bypassPermissions`, `plan`) | default |
| CLAUDE_PERSIST_SESSION | No | Enable session resume (`true`/`false`) | true |
| CLAUDE_SETTING_SOURCES | No | Settings to load: `user`, `project`, `local` | |
| CLAUDE_CODE_OAUTH_TOKEN | No | Claude Code OAuth token for this agent | inherited from parent |
| CLAUDE_DISALLOWED_TOOLS | No | Comma-separated tool blacklist |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| claude_codeA | Send a task to an autonomous Claude Code agent. It reads/writes files, runs shell commands, searches codebases, and handles complex software engineering tasks end-to-end. Returns the result text plus a session_id for follow-ups via claude_code_reply. |
| claude_code_replyA | Continue a previous claude_code conversation by session ID. Use this for follow-up questions, iterative refinement, or multi-step workflows that build on prior context. |
| claude_code_timelineA | Query the cross-agent workflow timeline. No args: list all runs. run_id: show one run's agent sequence. session_id: retrieve timeline entry and session metadata. Use claude_code_transcript for full transcripts. |
| claude_code_transcriptA | Retrieve the full conversation transcript for a session from Claude Code's storage. Returns chronological user/assistant messages. Use session_id from a prior query or timeline lookup. |
| claude_code_reportA | Generate a self-contained HTML report of a workflow run. No args: list all runs. run_id: detailed report for that run with agent sequence, cost breakdown, and collapsible transcripts. Save the returned HTML to a file and open in a browser. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/xiaolai/claude-octopus'
If you have feedback or need assistance with the MCP directory API, please join our Discord server