
Task Graph Mcp
If you're running multiple AI agents on complex work and tired of them stepping on each other or losing track of what they're doing, this gives you structured workflows through MCP tools. You get task hierarchies with phases (explore, implement, review), transition prompts that auto-guide agents between states, quality gates that enforce requirements before moving forward, and coordination primitives like atomic task claiming and advisory file locks. It's built on SQLite with pre-configured topologies for solo work, parallel swarms, specialist relays, or hierarchical delegation. Token tracking and cost accounting are built in. Useful when you need agents to follow a process instead of wandering off or duplicating work.
- GitHub stars
- 1
- tools
- 41
- transport
- STDIO
- last updated
- Jan 31, 2026
Tools
41 toolsPublic tool metadata for what this MCP can expose to an agent.
connectRegister a worker. Optional `workflow` selects named workflow (solo, swarm, relay, hierarchical). Returns `worker_id` and active `paths`.
Register a worker. Optional `workflow` selects named workflow (solo, swarm, relay, hierarchical). Returns `worker_id` and active `paths`.
No parameter schema in public metadata yet.
disconnectUnregister worker and release all claims/locks.
Unregister worker and release all claims/locks.
No parameter schema in public metadata yet.
list_agentsList connected workers with filters.
List connected workers with filters.
No parameter schema in public metadata yet.
cleanup_staleEvict stale workers and release their claims.
Evict stale workers and release their claims.
No parameter schema in public metadata yet.
add_overlayAdd a dynamic workflow overlay to a connected worker.
Add a dynamic workflow overlay to a connected worker.
No parameter schema in public metadata yet.
remove_overlayRemove a workflow overlay from a connected worker.
Remove a workflow overlay from a connected worker.
No parameter schema in public metadata yet.
createCreate a task. Priority 0-10 (higher = more important).
Create a task. Priority 0-10 (higher = more important).
No parameter schema in public metadata yet.
create_treeCreate nested task tree. `child_type` (default: "contains") for parent→child deps, `sibling_type` for sibling deps.
Create nested task tree. `child_type` (default: "contains") for parent→child deps, `sibling_type` for sibling deps.
No parameter schema in public metadata yet.
getGet task by ID with attachment metadata and counts.
Get task by ID with attachment metadata and counts.
No parameter schema in public metadata yet.
list_tasksQuery tasks with filters. Use `ready=true` for claimable tasks.
Query tasks with filters. Use `ready=true` for claimable tasks.
No parameter schema in public metadata yet.
updateUpdate task. Status/phase changes auto-manage ownership and trigger prompts. Include `attachments` to record commits/changelists.
Update task. Status/phase changes auto-manage ownership and trigger prompts. Include `attachments` to record commits/changelists.
No parameter schema in public metadata yet.
deleteDelete task. Soft delete by default; `obliterate=true` for permanent.
Delete task. Soft delete by default; `obliterate=true` for permanent.
No parameter schema in public metadata yet.
scanScan task graph in multiple directions. Depth: 0=none, N=levels, -1=all.
Scan task graph in multiple directions. Depth: 0=none, N=levels, -1=all.
No parameter schema in public metadata yet.
searchFTS5 search. Supports phrases, prefix*, AND/OR/NOT, title:word.
FTS5 search. Supports phrases, prefix*, AND/OR/NOT, title:word.
No parameter schema in public metadata yet.
renameAtomically rename a task ID across all referencing tables.
Atomically rename a task ID across all referencing tables.
No parameter schema in public metadata yet.
claimClaim a task. Fails if deps unsatisfied, at limit, or lacks tags. Use `force` to steal.
Claim a task. Fails if deps unsatisfied, at limit, or lacks tags. Use `force` to steal.
No parameter schema in public metadata yet.
linkCreate dependencies. Types: blocks, follows, contains, duplicate, see-also, relates-to.
Create dependencies. Types: blocks, follows, contains, duplicate, see-also, relates-to.
No parameter schema in public metadata yet.
unlinkRemove dependencies. Use `*` as wildcard.
Remove dependencies. Use `*` as wildcard.
No parameter schema in public metadata yet.
relinkAtomically move dependencies (unlink then link).
Atomically move dependencies (unlink then link).
No parameter schema in public metadata yet.
thinkingBroadcast live status. Visible to other workers. Refreshes heartbeat.
Broadcast live status. Visible to other workers. Refreshes heartbeat.
No parameter schema in public metadata yet.
task_historyGet status transition history with time tracking.
Get status transition history with time tracking.
No parameter schema in public metadata yet.
project_historyProject-wide history with date range filters.
Project-wide history with date range filters.
No parameter schema in public metadata yet.
log_metricsLog metrics (aggregated).
Log metrics (aggregated).
No parameter schema in public metadata yet.
get_metricsGet metrics for task(s).
Get metrics for task(s).
No parameter schema in public metadata yet.
give_feedbackRecord feedback about tools, workflows, or UX. Enabled by default; rejects writes past size limit (default: 1MB).
Record feedback about tools, workflows, or UX. Enabled by default; rejects writes past size limit (default: 1MB).
No parameter schema in public metadata yet.
list_feedbackRead the feedback markdown file.
Read the feedback markdown file.
No parameter schema in public metadata yet.
mark_fileMark file(s) to signal intent. Advisory, non-blocking.
Mark file(s) to signal intent. Advisory, non-blocking.
No parameter schema in public metadata yet.
unmark_fileRemove marks. Use `*` for all.
Remove marks. Use `*` for all.
No parameter schema in public metadata yet.
list_marksGet current file marks.
Get current file marks.
No parameter schema in public metadata yet.
mark_updatesPoll for mark changes since last call.
Poll for mark changes since last call.
No parameter schema in public metadata yet.
attachAdd attachment. Use `file` for reference, `store_as_file` for media storage.
Add attachment. Use `file` for reference, `store_as_file` for media storage.
No parameter schema in public metadata yet.
attachmentsGet attachment metadata. Glob patterns supported for name.
Get attachment metadata. Glob patterns supported for name.
No parameter schema in public metadata yet.
detachDelete attachment by name.
Delete attachment by name.
No parameter schema in public metadata yet.
check_gatesCheck gate requirements before status/phase transition. Returns unsatisfied gates with pass/warn/fail status.
Check gate requirements before status/phase transition. Returns unsatisfied gates with pass/warn/fail status.
No parameter schema in public metadata yet.
get_advisoryGet governance advisory guidance. Without topic: lists all topics. With topic: returns full advisory content with template expansion.
Get governance advisory guidance. Without topic: lists all topics. With topic: returns full advisory content with template expansion.
No parameter schema in public metadata yet.
queryExecute read-only SQL. SELECT only. Requires permission.
Execute read-only SQL. SELECT only. Requires permission.
No parameter schema in public metadata yet.
get_schemaGet database schema. Returns table names, columns, types, and foreign keys.
Get database schema. Returns table names, columns, types, and foreign keys.
No parameter schema in public metadata yet.
get_promptsGet workflow prompts. Without params: lists triggers. With status/phase: returns expanded prompts for that transition.
Get workflow prompts. Without params: lists triggers. With status/phase: returns expanded prompts for that transition.
No parameter schema in public metadata yet.
list_workflowsList available workflow configurations (solo, swarm, relay, hierarchical, etc.).
List available workflow configurations (solo, swarm, relay, hierarchical, etc.).
No parameter schema in public metadata yet.
list_skillsList available bundled skills with descriptions.
List available bundled skills with descriptions.
No parameter schema in public metadata yet.
get_skillGet full content of a bundled skill.
Get full content of a bundled skill.
No parameter schema in public metadata yet.
Sponsors
Readme
Task Graph MCP Server
Agent task workflows that actually work.
When you have AI agents working on complex tasks, things go wrong fast. Agents lose context, skip steps, forget to coordinate. Task Graph solves this with structured workflows: phases to guide work, prompts for automatic guidance, gates to enforce quality, and coordination primitives for multi-agent scenarios—all through the Model Context Protocol.
Why Task Graph?
The problem: You've got complex tasks that need structured execution. Maybe a single agent working through phases, or multiple agents coordinating in parallel. Without proper workflows, agents lose track, skip steps, and produce inconsistent results.
What you get:
Details
- Repository
- github.com/oortonaut/task-graph-mcp
- Categories
- AI & LLM Tools, Productivity & Office
- Package
https://github.com/Oortonaut/task-graph-mcp/releases/download/v0.3.0/task-graph-mcp-x86_64-unknown-linux-gnu.mcpb- Transport
- STDIO
- Registry
- MCP registry, active