HR MCP Server

Implementation Reference

• src/index.ts:25-134 (registration)

  Registration of the get_employee_info MCP tool with inline Zod schema and handler function that fetches and formats comprehensive employee profile information from the employeesData store.
  server.tool( "get_employee_info", { employee_id: z.string().describe("The ID of the employee to retrieve information for"), include_sensitive: z.boolean().optional().default(false).describe("Whether to include sensitive information like SSN (default: false)") }, async ({ employee_id, include_sensitive }) => { logMessage(`Looking up employee: ${employee_id}`); // Look up employee in our "database" const employee = employeesData[employee_id]; if (!employee) { return { content: [{ type: "text", text: `No employee found with ID ${employee_id}.` }], isError: false }; } // Format basic employee information let info = `# Employee Information for ${employee.name} (${employee_id})\n\n` + `## Personal Details\n` + `* **Name:** ${employee.name}\n` + `* **Title:** ${employee.title}\n` + `* **Department:** ${employee.department}\n` + `* **Email:** ${employee.email}\n` + `* **Phone:** ${employee.phoneNumber}\n` + `* **Date of Birth:** ${employee.dob}\n` + `* **Location:** ${employee.location.city}, ${employee.location.state}, ${employee.location.country}\n\n` + `## Employment Details\n` + `* **Hire Date:** ${employee.hireDate}\n` + `* **Years in Company:** ${employee.yearsInCompany}\n` + `* **Performance Rating:** ${employee.performanceRating}/5\n`; // Add manager information if exists if (employee.manager) { const manager = employeesData[employee.manager]; info += `* **Manager:** ${manager ? manager.name : "Unknown"} (${employee.manager})\n`; } else { info += `* **Manager:** None (Executive Level)\n`; } // Add direct reports if any if (employee.directReports.length > 0) { info += `* **Direct Reports:** ${employee.directReports.length}\n`; info += ` * ${employee.directReports.map(id => { const report = employeesData[id]; return report ? `${report.name} (${id})` : `Unknown (${id})`; }).join("\n * ")}\n`; } else { info += `* **Direct Reports:** None\n`; } // Add more professional details info += `\n## Professional Details\n` + `* **Education:** ${employee.educationLevel}\n` + `* **Certifications:** ${employee.certifications.join(", ") || "None"}\n` + `* **Skills:** ${employee.skills.join(", ")}\n`; // Add project information info += `* **Current Projects:** ${employee.projectAssignments.join(", ") || "None"}\n\n`; // Add leave information info += `## Leave Information\n` + `* **Vacation Days:** ${employee.vacationDays.used} used / ${employee.vacationDays.total} total (${employee.vacationDays.remaining} remaining)\n` + `* **Sick Days:** ${employee.sickDays.used} used / ${employee.sickDays.total} total (${employee.sickDays.remaining} remaining)\n\n`; // Add previous positions if any if (employee.previousPositions.length > 0) { info += `## Previous Positions\n`; employee.previousPositions.forEach(position => { info += `* **${position.title}** (${position.department}): ${position.startDate} to ${position.endDate}\n`; }); info += `\n`; } // Add emergency contact info += `## Emergency Contact\n` + `* **Name:** ${employee.emergencyContact.name}\n` + `* **Relationship:** ${employee.emergencyContact.relationship}\n` + `* **Phone:** ${employee.emergencyContact.phoneNumber}\n\n`; // Add benefits information info += `## Benefits\n` + `* **Health Insurance:** ${employee.benefits.healthInsurance ? "Enrolled" : "Not Enrolled"}\n` + `* **Dental Insurance:** ${employee.benefits.dentalInsurance ? "Enrolled" : "Not Enrolled"}\n` + `* **Vision Insurance:** ${employee.benefits.visionInsurance ? "Enrolled" : "Not Enrolled"}\n` + `* **401(k):** ${employee.benefits.retirement401k ? "Enrolled" : "Not Enrolled"}\n` + `* **Stock Options:** ${employee.benefits.stockOptions ? "Enrolled" : "Not Enrolled"}\n\n`; // Add notes info += `## Notes\n${employee.notes}\n\n`; // Add sensitive information only if requested if (include_sensitive) { info += `## Confidential Information (RESTRICTED ACCESS)\n` + `* **Salary:** $${employee.salary.toLocaleString()}/year\n` + `* **SSN:** ${employee.ssn}\n` + `* **Last Promotion Date:** ${employee.lastPromotionDate || "No promotions yet"}\n`; } else { info += `## Confidential Information\n` + `* Restricted - Use include_sensitive=true parameter to view\n`; } return { content: [{ type: "text", text: info }], isError: false }; } );
• src/tools/getEmployeeInfo.ts:13-118 (handler)

  Modular implementation of the get_employee_info tool handler. Retrieves employee data by ID from static data source, formats extensive markdown report with personal, employment, professional details, leave info, benefits, notes, and optionally sensitive data like salary and SSN.
  export const getEmployeeInfo = async ( { employee_id, include_sensitive }: { employee_id: string, include_sensitive: boolean }, extra: any ) => { logMessage(`Looking up employee: ${employee_id}`); // Look up employee in our "database" const employee = employeesData[employee_id]; if (!employee) { return { content: [{ type: "text", text: `No employee found with ID ${employee_id}.` }], isError: false }; } // Format basic employee information let info = `# Employee Information for ${employee.name} (${employee_id})\n\n` + `## Personal Details\n` + `* **Name:** ${employee.name}\n` + `* **Title:** ${employee.title}\n` + `* **Department:** ${employee.department}\n` + `* **Email:** ${employee.email}\n` + `* **Phone:** ${employee.phoneNumber}\n` + `* **Date of Birth:** ${employee.dob}\n` + `* **Location:** ${employee.location.city}, ${employee.location.state}, ${employee.location.country}\n\n` + `## Employment Details\n` + `* **Hire Date:** ${employee.hireDate}\n` + `* **Years in Company:** ${employee.yearsInCompany}\n` + `* **Performance Rating:** ${employee.performanceRating}/5\n`; // Add manager information if exists if (employee.manager) { const manager = employeesData[employee.manager]; info += `* **Manager:** ${manager ? manager.name : "Unknown"} (${employee.manager})\n`; } else { info += `* **Manager:** None (Executive Level)\n`; } // Add direct reports if any if (employee.directReports.length > 0) { info += `* **Direct Reports:** ${employee.directReports.length}\n`; info += ` * ${employee.directReports.map(id => { const report = employeesData[id]; return report ? `${report.name} (${id})` : `Unknown (${id})`; }).join("\n * ")}\n`; } else { info += `* **Direct Reports:** None\n`; } // Add more professional details info += `\n## Professional Details\n` + `* **Education:** ${employee.educationLevel}\n` + `* **Certifications:** ${employee.certifications.join(", ") || "None"}\n` + `* **Skills:** ${employee.skills.join(", ")}\n`; // Add project information info += `* **Current Projects:** ${employee.projectAssignments.join(", ") || "None"}\n\n`; // Add leave information info += `## Leave Information\n` + `* **Vacation Days:** ${employee.vacationDays.used} used / ${employee.vacationDays.total} total (${employee.vacationDays.remaining} remaining)\n` + `* **Sick Days:** ${employee.sickDays.used} used / ${employee.sickDays.total} total (${employee.sickDays.remaining} remaining)\n\n`; // Add previous positions if any if (employee.previousPositions.length > 0) { info += `## Previous Positions\n`; employee.previousPositions.forEach(position => { info += `* **${position.title}** (${position.department}): ${position.startDate} to ${position.endDate}\n`; }); info += `\n`; } // Add emergency contact info += `## Emergency Contact\n` + `* **Name:** ${employee.emergencyContact.name}\n` + `* **Relationship:** ${employee.emergencyContact.relationship}\n` + `* **Phone:** ${employee.emergencyContact.phoneNumber}\n\n`; // Add benefits information info += `## Benefits\n` + `* **Health Insurance:** ${employee.benefits.healthInsurance ? "Enrolled" : "Not Enrolled"}\n` + `* **Dental Insurance:** ${employee.benefits.dentalInsurance ? "Enrolled" : "Not Enrolled"}\n` + `* **Vision Insurance:** ${employee.benefits.visionInsurance ? "Enrolled" : "Not Enrolled"}\n` + `* **401(k):** ${employee.benefits.retirement401k ? "Enrolled" : "Not Enrolled"}\n` + `* **Stock Options:** ${employee.benefits.stockOptions ? "Enrolled" : "Not Enrolled"}\n\n`; // Add notes info += `## Notes\n${employee.notes}\n\n`; // Add sensitive information only if requested if (include_sensitive) { info += `## Confidential Information (RESTRICTED ACCESS)\n` + `* **Salary:** $${employee.salary.toLocaleString()}/year\n` + `* **SSN:** ${employee.ssn}\n` + `* **Last Promotion Date:** ${employee.lastPromotionDate || "No promotions yet"}\n`; } else { info += `## Confidential Information\n` + `* Restricted - Use include_sensitive=true parameter to view\n`; } return { content: [{ type: "text", text: info }], isError: false }; };
• src/tools/getEmployeeInfo.ts:7-10 (schema)

  Zod-based input schema for the get_employee_info tool parameters: required employee_id (string) and optional include_sensitive (boolean, default false).
  export const getEmployeeInfoSchema = { employee_id: z.string().describe("The ID of the employee to retrieve information for"), include_sensitive: z.boolean().optional().default(false).describe("Whether to include sensitive information like SSN (default: false)") };
• src/index.ts:27-30 (schema)

  Inline Zod schema used in the registration of get_employee_info tool, matching the modular schema.
  { employee_id: z.string().describe("The ID of the employee to retrieve information for"), include_sensitive: z.boolean().optional().default(false).describe("Whether to include sensitive information like SSN (default: false)") },
• build/index.js:22-26 (registration)

  Built version registration in build/index.js.
  server.tool("get_employee_info", { employee_id: z.string().describe("The ID of the employee to retrieve information for"), include_sensitive: z.boolean().optional().default(false).describe("Whether to include sensitive information like SSN (default: false)") }, async ({ employee_id, include_sensitive }) => { logMessage(`Looking up employee: ${employee_id}`);