# 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:**
- `x-openai-api-key` (header) — Optional OpenAI API key (falls back to algorithmic analysis if omitted)
- `provider` (query)
- `model` (query) — AI model to use for analysis

## Tools (24)

- `parse_resume` — Parse a resume file (PDF, DOCX, TXT, MD) or URL and extract text with algorithmic pre-analysis including keyword extrac…
- `inspect_pipeline` — Run the full 5-node atomic deconstruction pipeline (Ingestion → Sanitization → Tokenization → Classification → Serializ…
- `extract_keywords` — Extract keywords from resume text using TF-IDF analysis, then overlay entity classification (NER) and skill categorizat…
- `detect_patterns` — Detect and structure date ranges, metrics, sections, and work experience from resume text. Returns structured experienc…
- `compute_similarity` — Compare a resume against a job description using cosine similarity, Jaccard index, TF-IDF overlap, and skill matching. …
- `classify_entities` — Run Named Entity Recognition on resume text. Extracts 12 entity types (PERSON, ORGANIZATION, DATE, SKILL, LOCATION, EMA…
- `extract_skills_structured` — Extract and categorize skills from resume text using algorithmic analysis only (no AI). Combines NER entity classificat…
- `extract_experience_structured` — Extract and structure work experience from resume text using algorithmic analysis only (no AI). Uses date range detecti…
- `analyze_resume_comprehensive` — Run a comprehensive algorithmic analysis on a resume in a single call. Accepts raw text or a file (base64-encoded PDF/D…
- `batch_parse_resumes` — Parse multiple resume files at once and run the full algorithmic pipeline on each. Returns raw text, pipeline analysis,…
- `export_results` — Export parsed resume results to a specified format (JSON or CSV text). Accepts an array of structured resume results an…
- `send_email` — Send parsed resume results via email using SMTP. Requires SMTP configuration (host, port, user, pass) and recipient ema…
- `assess_candidate` — Assess a resume against recruiter-defined criteria. Supports 8 criteria axes: Education, Experience, Skills, Certificat…
- `manage_candidates` — Manage and analyze candidates: rank by fit, filter by criteria, recommend pipeline stage changes, compare candidates si…
- `ats_manage_candidates` — Manage candidates in the ATS pipeline. Supports add, update, delete, move between stages, bulk move, and list/filter op…
- `ats_pipeline_analytics` — Analyze the ATS hiring pipeline. Given candidates and optional pipeline stage config, returns stage distribution, conve…
- `ats_schedule_interview` — Full CRUD for interviews. Actions: create (validate & schedule with conflict detection), update (reschedule/modify), de…
- `ats_manage_offers` — Manage offers in the ATS. Actions: create (validate & structure), update_status (draft→pending-approval→approved→sent→a…
- `ats_dashboard_stats` — Generate comprehensive ATS dashboard statistics and hiring health report. Provide the full ATS state (candidates, jobs,…
- `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_manage_jobs` — Manage job postings in the ATS. Actions: create (new job posting), update (edit fields), delete, list (with optional st…
- `ats_manage_notes` — Manage candidate notes in the ATS. Actions: add (create note on candidate), update (edit note content), list (get all n…
- `ats_interview_feedback` — Manage interview feedback in the ATS. Actions: submit (add feedback to completed interview), get (retrieve feedback for…
- `ats_search` — Global search across the ATS. Actions: search (keyword search across candidates, jobs, interviews, offers — scoped opti…

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

## Resources

- `mcp://resume-parser/guide` — How to use the AI Resume Parser & ATS Toolkit — tool overview, supported file formats, and workflow examples.
- `mcp://resume-parser/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.
