Claude Wrap Mcp
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.
- tools
- 10
- transport
- STDIO
- last updated
- Jun 1, 2026
Tools
10 toolsPublic tool metadata for what this MCP can expose to an agent.
claude_spawnStart a session in an absolute cwd. Returns a sessionId.
Start a session in an absolute cwd. Returns a sessionId.
No parameter schema in public metadata yet.
claude_askSend a prompt, wait for idle, return the transcript tail + parsed state.
Send a prompt, wait for idle, return the transcript tail + parsed state.
No parameter schema in public metadata yet.
claude_sendSend raw input (text / line / key) without waiting — for long tasks.
Send raw input (text / line / key) without waiting — for long tasks.
No parameter schema in public metadata yet.
claude_statusBusy, mode, tokens, pending permission prompt, todos, last 5 tool names.
Busy, mode, tokens, pending permission prompt, todos, last 5 tool names.
No parameter schema in public metadata yet.
claude_tool_callsPage through the session's tool calls. Ids + names by default.
Page through the session's tool calls. Ids + names by default.
No parameter schema in public metadata yet.
claude_tool_resultOne tool call by id: its args and result.
One tool call by id: its args and result.
No parameter schema in public metadata yet.
claude_snapshotThe rendered transcript lines.
The rendered transcript lines.
No parameter schema in public metadata yet.
claude_listEvery session, spawned here or discovered, with its backend, tmux attach command and lineage.
Every session, spawned here or discovered, with its backend, tmux attach command and lineage.
No parameter schema in public metadata yet.
claude_resolve_permissionapprove / deny a pending permission prompt.
approve / deny a pending permission prompt.
No parameter schema in public metadata yet.
claude_stopShut down a session this server spawned or adopted (kills a tmux session).
Shut down a session this server spawned or adopted (kills a tmux session).
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
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
Details
- Repository
- github.com/alex-kaff/claude-wrap-mcp
- Package
claude-wrap-mcp- Transport
- STDIO
- Registry
- MCP registry, active