Pi Durabletask MCP
Multi-provider Pi agent teams: parallel delegates, coordination, steering, optional recovery.
Connector by Nyarlathoteppppp · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/nyarlathoteppppp-pi-durabletask-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: agent-orchestration
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
Runs code on install
Its package runs an install script (such as npm postinstall or setup.py code) as soon as you install it, before any tool is called. Read the script first.
- Tools
- 6 read · 4 write · 8 delete
- Secrets
- None asked for
- Install scripts
- Runs code on install
- Runs as
- Node.js package
Tools by what they do 18
Read from the source code; the running server may list different tools.
Read 6 · Look things up without changing anything.
delegate_getdelegate_waitmodelssessionsstatuswait
Write 4 · Create, change, send or run things.
delegate_follow_updelegate_start_batchhandoffinit
Delete 8 · Delete, drop, revoke or wipe things.
abortanswerfollow_upforgetrunspawnspawn_batchsteer
Network hosts it talks to 4
api.typesafe.ai· found in codegithub.com· found in codeopenrouter.ai· found in codepi.dev· found in code
Files it touches
- Your home directory (~)
- Any path the agent passes to its tools
Tools (18)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
abortcan change or delete dataStop a running pi session. Partial output stays readable via `status`.
answercan change or delete dataAnswer a pending Pi extension UI question. Get requestId from questions[].id in status or wait. The delegate is blocked until you answer; answer only actual pending questions.
delegate_follow_upAsk a finished child launched by this coordinator a targeted question, preserving its history/model/tools. Use only when a report or specific evidence is missing; no mandatory debate round. Omit budget fields to use remaining quotas; maxTurns/maxToolCalls renew only the supplied quota. Returns a start receipt: wait, then get the updated report. With plan saveDir, each follow-up saves to a new file, preserving previous reports. Cancelling the coordinator leaves children running.
delegate_getread-onlyGet one launched child's full report, state and follow-up readiness (without renewing quotas), including questions, failures and save diagnostics. store() reports within the SDK's storage limits; print only the conclusions/references the caller needs. Original savedTo files remain independent of summaries.
delegate_start_batchDescription is built at runtime.
delegate_waitread-onlyWait for all selected children, or all launched children when sessionIds is omitted; until:"settled" returns as soon as any one settles, so a larger plan can start its next task in the freed slot. timeoutMs: max 55000, default 30000 when omitted. Returns compact per-child state, questions, errors and save diagnostics; use delegate_get for full reports. Cancelling the wait/coordinator leaves children running within their budgets; the caller can answer or abort them with ordinary MCP tools.
follow_upcan change or delete dataSend another prompt to a delegate that has already finished, keeping everything it read and said. Omit budget fields to use remaining quotas; pass maxTurns/maxToolCalls for fresh quotas for this run. Counts and usage remain cumulative. The wall-clock limit applies to each run. Memory sessions can continue while retained here; durable sessions can continue after reconnecting while retained on disk. For a live session, use `steer`.
forgetcan change or delete dataDrop a finished session from the review history, freeing its id for reuse.
handoffHand a Pi session over between Claude/Codex windows. save (when the user asks to hand over): record the repository cwd, the sessionId, and a short goal, completed and next. read (when the user asks to pick up a project): returns the latest note for cwd (or the one named), plus resumeHint and howToResume, computed from the session's live state. Follow resumeHint, then use status/wait/follow_up as usual. A note is a summary, not the session's state; it never claims, recovers or deletes a session. remainingTurns/canFollowUp describe state and turn-budget readiness only.
initOptional setup diagnostics: reports model availability, provider authentication, permissions and budgets. Use when diagnosing configuration; no init call is needed before delegating. OAuth credentials may refresh.
modelsread-onlyList models this delegate may use from pi's available providers after model filters. Use `filter` to find a provider or model, and `offset`/`limit` to page through long lists. thinkingLevels lists the levels each returned reasoning model accepts; a model absent from it accepts only off.
runcan change or delete dataDelegate a task to a pi agent and wait for the final answer. Blocks until done. Client request cancellation aborts the delegate. Prefer spawn plus wait for long work; this is for quick questions. Returns a compact result; use verbose: true for the full snapshot.
sessionsread-onlyDescription is built at runtime.
spawncan change or delete dataDelegate a task to a pi agent running in the background. Returns a sessionId immediately, so nothing blocks. Use `wait` for progress/results, `status` for a snapshot, `steer` to redirect, and `answer` for questions. Use this for anything that might take more than a minute.
spawn_batchcan change or delete dataFan out several delegates in one call. Each task inherits the batch-level model, cwd, tools and extensions unless it overrides them. The whole batch is validated before any delegate starts, so a bad model name or a duplicate id fails everything instead of leaving half a fan-out running. Wait for the batch with `wait` and the returned sessionIds, rather than polling `sessions` or one `status` per delegate.
Show 3 more tools
statusread-onlyCheck a background pi session. Returns state, turn count, tools used, latest text, and any pending questions the agent is waiting on. A non-empty `questions` array means it is blocked until you call `answer`. `toolCalls` holds the last 5 calls with shortened arguments and `toolCallCount` the total; pass `verbose: true` for every call with ids and results. Notices cover this run; verbose preserves their full history. Teams with saveDir expose reportIndex and publication errors. remainingTurns/canFollowUp report state and turn-budget readiness; ownership, capacity and auth are checked by follow_…
steercan change or delete dataRedirect a running pi agent mid-task. The message lands after its current tool call finishes, before the next model call. Use this instead of aborting when the agent is going the wrong way.
waitread-onlyWait for delegates without polling in a loop. until: "progress" (default) returns after a new turn/tool call, a pending question, the end, or timeout; pass prior turns/toolCallCount as afterTurns/afterToolCalls. until: "settled" returns only when it finishes or asks a question, so loop on it to get the result. With sessionIds (e.g. a spawn_batch), returns when any one settles ("settled") or all do ("all_settled"): settled/pending ids, continueIds (everything not finished, including sessions waiting for an answer) and a summary per session, with the final text of finished ones and any pending q…
Compare and alternatives
Featured in
Signals
- Stars
- 15
- Forks
- 0
- Open issues
- 0
- Last commit
- Oct 24, 2026 (5 days ago)
- Last release
- Oct 19, 2026 (10 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.Nyarlathoteppppp/pi-durabletask-mcp- Version
- 0.7.12
- Auth
- No auth
- Packages
- npm pi-durabletask-mcp
- License
- MIT
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Pi Durabletask MCP. Agent Mart. https://agentmart.dev/connectors/nyarlathoteppppp-pi-durabletask-mcp (last updated 2026-10-24)