list_requests
Export a summary of all requests, including basic details and task overviews, to manage and track tasks efficiently within the TaskFlow MCP system.
Instructions
List all requests with their basic information and summary of tasks. This provides a quick overview of all requests in the system.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Input Schema (JSON Schema)
{
"properties": {},
"type": "object"
}
Implementation Reference
- src/tools/TaskFlowTools.ts:581-583 (handler)The MCP tool handler function for list_requests. This is the entry point that executes when the tool is called, delegating to the TaskFlowService.listRequests() method.async list_requests() { return service.listRequests(); },
- Core implementation logic in TaskFlowService that loads tasks, formats the requests list, and returns summary information for all requests.public async listRequests() { await this.loadTasks(); const requestsList = formatRequestsList(this.data); return { status: "requests_listed", message: `Current requests in the system:\n${requestsList}`, requests: this.data.requests.map((req) => ({ requestId: req.requestId, originalRequest: req.originalRequest, totalTasks: req.tasks.length, completedTasks: req.tasks.filter((t) => t.done).length, })), }; }
- JSON Schema definition for the list_requests tool input parameters (no required parameters).list_requests: { type: "object", properties: {}, required: [], },
- src/server/TaskFlowServer.ts:63-90 (registration)Registration of the list_requests tool (as LIST_REQUESTS_TOOL) in the MCP server's listTools handler, making it discoverable by clients.this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [ PLAN_TASK_TOOL, GET_NEXT_TASK_TOOL, MARK_TASK_DONE_TOOL, OPEN_TASK_DETAILS_TOOL, LIST_REQUESTS_TOOL, ADD_TASKS_TO_REQUEST_TOOL, UPDATE_TASK_TOOL, DELETE_TASK_TOOL, ADD_SUBTASKS_TOOL, MARK_SUBTASK_DONE_TOOL, UPDATE_SUBTASK_TOOL, DELETE_SUBTASK_TOOL, EXPORT_TASK_STATUS_TOOL, ADD_NOTE_TOOL, UPDATE_NOTE_TOOL, DELETE_NOTE_TOOL, ADD_DEPENDENCY_TOOL, GET_PROMPTS_TOOL, SET_PROMPTS_TOOL, UPDATE_PROMPTS_TOOL, REMOVE_PROMPTS_TOOL, ARCHIVE_COMPLETED_REQUESTS_TOOL, LIST_ARCHIVED_REQUESTS_TOOL, RESTORE_ARCHIVED_REQUEST_TOOL, ], }));
- src/tools/TaskFlowTools.ts:145-153 (schema)Tool definition including name, description, and input schema (empty object for no params). This object is exported and registered in the server.export const LIST_REQUESTS_TOOL: Tool = { name: "list_requests", description: "List all requests with their basic information and summary of tasks. This provides a quick overview of all requests in the system.", inputSchema: { type: "object", properties: {}, }, };