# AI HR Management Toolkit

Manage Job using MCP: Manage Job, Candidates, Resumes, Salaries all within this one MCP tools

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add XJTLUmedia2/x24

# Browse available tools
npx -y @smithery/cli@latest tool list XJTLUmedia2/x24

# Get full schema for a tool
npx -y @smithery/cli@latest tool get XJTLUmedia2/x24 parse_resume

# Call a tool
npx -y @smithery/cli@latest tool call XJTLUmedia2/x24 parse_resume '{}'
```

## Direct MCP Connection

Endpoint: `https://x24--xjtlumedia2.run.tools`

**Optional config:**
- `openaiApiKey` (header) — Optional OpenAI API key (falls back to algorithmic analysis if omitted)
- `aiProvider` (query) — provider
- `aiModel` (query) — AI model to use for analysis

## Tools (21)

- `parse_resume` — Parse a resume file (PDF, DOCX, TXT, MD) or URL and extract text with algorithmic pre-analysis including keyword extrac…
- `analyze_resume` — Unified resume analysis tool. Select which analysis aspects to run via the "aspects" parameter:
- `batch_parse_resumes` — Parse multiple resume files at once and run the full algorithmic pipeline on each. Returns raw text, pipeline analysis,…
- `assess_candidate` — Assess a resume against recruiter-defined criteria. Supports 8 criteria axes: Education, Experience, Skills, Certificat…
- `inspect_pipeline` — Run the full 5-node atomic deconstruction pipeline (Ingestion → Sanitization → Tokenization → Classification → Serializ…
- `ats_manage_candidates` — Unified candidate management for the ATS pipeline. Actions:
- `ats_manage_jobs` — Manage job postings in the ATS. Actions: create (new job posting), update (edit fields), delete, list (with optional st…
- `ats_manage_offers` — Manage offers in the ATS. Actions: create (validate & structure), update_status (draft→pending-approval→approved→sent→a…
- `ats_manage_notes` — Manage candidate notes in the ATS. Actions: add (create note on candidate), update (edit note content), list (get all n…
- `ats_schedule_interview` — Full CRUD for interviews. Actions: create (validate & schedule with conflict detection), update (reschedule/modify), de…
- `ats_interview_feedback` — Manage interview feedback in the ATS. Actions: submit (add feedback to completed interview), get (retrieve feedback for…
- `ats_analytics` — Unified ATS analytics. Select report type:
- `ats_generate_demo_data` — Generate a full set of realistic demo data for the ATS (Applicant Tracking System). Returns a complete ATSState with sa…
- `ats_search` — Global search across the ATS. Actions: search (keyword search across candidates, jobs, interviews, offers — scoped opti…
- `ats_compliance` — Enterprise compliance toolkit: audit trail queries, EEO/EEOC diversity reporting, GDPR data export & erasure (right to …
- `ats_talent_pool` — Manage passive candidate talent pools (CRM). Create pools, add/remove candidates, search across pools, get pool analyti…
- `ats_scorecard` — Structured interview scorecards — create evaluation templates with weighted criteria, fill scorecards per candidate/eva…
- `ats_onboarding` — Post-hire onboarding checklist management. Create checklists with categorized tasks (paperwork, IT setup, training, ori…
- `ats_communication` — Candidate communication management — create email templates with {{variable}} interpolation, preview and send messages,…
- `export_results` — Export parsed resume results to a specified format (JSON, CSV, or Markdown). Accepts an array of structured resume resu…
- `send_email` — Send parsed resume results via email using SMTP. Requires SMTP configuration (host, port, user, pass) and recipient ema…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get XJTLUmedia2/x24 <tool-name>
```

## Resources

- `mcp://ai-hr-management-toolkit/guide` — How to use the AI HR Management Toolkit — tool overview, supported file formats, and workflow examples.
- `mcp://ai-hr-management-toolkit/schema/resume` — JSON schema describing the structured output format produced by the parse_resume tool.

## Prompts (3)

- `parse-and-assess-candidate` (content, role, criteria) — Parse a resume and assess the candidate's fit for a specific role using criteria-based scoring.
- `compare-candidates` (resumes, jobDescription) — Parse and compare multiple candidates side-by-side for a position, ranking them by fit score.
- `ats-pipeline-summary` (jobId) — Generate a concise ATS pipeline summary showing candidate counts by stage and key hiring metrics.