NeedHuman

Instructions

Implementation Reference

• mcp-server.ts:232-275 (handler)

  The "list_tasks" tool is registered and implemented directly within the `server.tool` call in `mcp-server.ts`. It fetches tasks from the `/api/v1/tasks` endpoint.

    server.tool(
      "list_tasks",
      `Use when you have lost track of a task_id or want to review your past human task requests.
  Returns all tasks you have submitted, newest first: id, status, description, result, and timestamps.`,
      {},
      async () => {
        try {
          const res = await fetch(`${API_URL}/api/v1/tasks`, {
            headers: apiHeaders(),
          });
  
          if (!res.ok) {
            return {
              content: [
                {
                  type: "text" as const,
                  text: `Failed to list tasks: ${res.status} ${res.status === 401 ? "Check API key." : "Server error."}`,
                },
              ],
              isError: true,
            };
          }
  
          const tasks = await res.json();
          return {
            content: [
              {
                type: "text" as const,
                text: JSON.stringify(tasks, null, 2),
              },
            ],
          };
        } catch (e) {
          return {
            content: [
              {
                type: "text" as const,
                text: `Could not reach API at ${API_URL}. ${e instanceof Error ? e.message : "Unknown error."}`,
              },
            ],
            isError: true,
          };
        }
      }