Project Handoffs MCP Server

Instructions

Implementation Reference

• src/index.ts:258-274 (handler)

  Core handler function in ProjectManager that loads project data, finds the specified next step, its associated working session, and handoff, then returns them.

  async getNextStepHistory(projectId: string, stepId: string): Promise<{
    step: NextStep;
    session?: WorkingSession;
    handoff?: Handoff;
  }> {
    const data = await this.loadProjectData(projectId);
    
    const step = data.nextSteps.find(s => s.id === stepId);
    if (!step) {
      throw new ProjectError(`Next step not found: ${stepId}`, projectId);
    }
  
    const session = data.workingSessions.find(s => s.nextStepId === stepId);
    const handoff = session ? data.handoffs.find(h => h.sessionId === session.id) : undefined;
  
    return { step, session, handoff };
  }

• src/index.ts:394-405 (registration)

  Tool registration in the listTools response, defining name, description, and input schema.

  {
    name: "get_next_step_history",
    description: "Get complete history of a next step including session and handoff",
    inputSchema: {
      type: "object",
      properties: {
        projectId: { type: "string", description: "Project identifier" },
        stepId: { type: "string", description: "Next step ID" }
      },
      required: ["projectId", "stepId"]
    }
  }

• src/index.ts:397-404 (schema)

  Input schema definition for the get_next_step_history tool, specifying required projectId and stepId parameters.

  inputSchema: {
    type: "object",
    properties: {
      projectId: { type: "string", description: "Project identifier" },
      stepId: { type: "string", description: "Next step ID" }
    },
    required: ["projectId", "stepId"]
  }

• src/index.ts:508-518 (handler)

  Dispatcher in CallToolRequestSchema handler that invokes the ProjectManager method and formats the response.

  case "get_next_step_history":
    const history = await projectManager.getNextStepHistory(
      args.projectId as string,
      args.stepId as string
    );
    return {
      content: [{
        type: "text",
        text: JSON.stringify(history, null, 2)
      }]
    };