Tools for agents: Task graph planner
Turn a dependency graph into ready tasks, parallel waves, and explicit blockers for collaborating agents.
Connect with MCP
{
"mcpServers": {
"super-agent-tools": {
"url": "https://app.getsupers.com/sites/agent-task-graph/mcp"
}
}
}Use this URL in any client supporting remote Streamable HTTP MCP. Calls return structured JSON; inputs are processed without persistence.
Call plan_task_graph
Stateless planning. A dependency wave describes graph topology, not a claim or execution guarantee. Send updated statuses on the next call. Empty graphs are complete.
Input and output schemas
{
"name": "plan_task_graph",
"title": "Task graph planner",
"description": "Validate a DAG and return ready work, parallel waves, blockers and dependency edges. No tasks are executed or stored.",
"inputSchema": {
"$defs": {
"Task": {
"properties": {
"id": {
"minLength": 1,
"title": "Id",
"type": "string"
},
"depends_on": {
"items": {
"type": "string"
},
"title": "Depends On",
"type": "array"
},
"status": {
"default": "pending",
"enum": [
"pending",
"running",
"completed",
"failed"
],
"title": "Status",
"type": "string"
}
},
"required": [
"id"
],
"title": "Task",
"type": "object"
}
},
"properties": {
"tasks": {
"items": {
"$ref": "#/$defs/Task"
},
"title": "Tasks",
"type": "array"
}
},
"required": [
"tasks"
],
"title": "plan_task_graphArguments",
"type": "object"
},
"outputSchema": {
"additionalProperties": true,
"title": "plan_task_graphDictOutput",
"type": "object"
},
"icons": null,
"annotations": {
"title": null,
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"meta": null,
"execution": null
}Run the example to see the actual result.
HTTP alternative
POST https://app.getsupers.com/sites/agent-task-graph/call
Content-Type: application/json
{
"tasks": [
{
"id": "research",
"status": "completed"
},
{
"id": "build",
"depends_on": [
"research"
]
},
{
"id": "docs",
"depends_on": [
"research"
]
},
{
"id": "verify",
"depends_on": [
"build",
"docs"
]
}
]
}The HTTP and MCP interfaces execute the same implementation. Validation errors are returned explicitly. See the tool notes above for its supported inputs and behavior.