Summary
Turns Claude Code into an orchestratable sub-agent by spawning and controlling headless sessions through the claude-wrap library. You get eight tools: spawn sessions in a working directory, send prompts with claude_ask and wait for parsed state, fire raw input with claude_send for long tasks, poll status for busy/mode/tokens/permissions, grab transcript snapshots, list all sessions, and approve or deny permission prompts explicitly instead of bypassing them. Built on node-pty, requires the claude CLI on your PATH. The primary use case is letting one Claude instance manage a fleet of other Claude Code sessions as workers, with full lifecycle control and state parsing for each.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →claude-wrap-mcp
An MCP server that lets an agent spawn and
drive real Claude Code sessions, so Claude Code can run a fleet of Claude Code
sub-agents. Built on claude-wrap.
Needs Node ≥ 18 and the claude CLI on your PATH. Headless sessions work
everywhere; attaching to visible terminal windows is Windows-first.
Install
npm install -g claude-wrap-mcp
claude mcp add claude-wrap -- claude-wrap-mcp
Or in .mcp.json / claude_desktop_config.json:
{
"mcpServers": {
"claude-wrap": { "command": "npx", "args": ["-y", "claude-wrap-mcp"] }
}
}
Tools
| Tool | What it does |
|---|---|
claude_spawn | Start a session in an absolute cwd. Returns a sessionId. |
claude_ask | Send a prompt, wait for idle, return the transcript tail + parsed state. |
claude_send | Send raw input (text / line / key) without waiting — for long tasks. |
claude_status | Busy, mode, tokens, pending permission prompt, todos, last 5 tool names. |
claude_tool_calls | Page through the session's tool calls. Ids + names by default. |
claude_tool_result | One tool call by id: its args and result. |
claude_snapshot | The rendered transcript lines. |
claude_list | Every session — spawned here or discovered. |
claude_resolve_permission | approve / deny a pending permission prompt. |
claude_stop | Shut down a session this server spawned. |
There is a second family, claudep_*, that drives non-interactive claude -p
sessions and returns structured JSON, tool calls, usage and cost.
Two things worth knowing:
- Permission prompts are surfaced, not bypassed. When
claude_askorclaude_statusreports apermissionPrompt, answer it withclaude_resolve_permission. - Tool calls are paged, not dumped. A status poll stays cheap because it
carries only names;
claude_tool_callslists the rest andclaude_tool_resultfetches one call's output by id.
Develop
pnpm install
pnpm --filter claude-wrap-mcp build
pnpm --filter claude-wrap-mcp test
License
MIT © Alex Kaffetzakis
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →