Skip to main content
Glama
AI HR Management Toolkit

AI HR Management Toolkit

AI HR Management Toolkit

AI-powered resume parser & full Applicant Tracking System with 21 MCP tools. Parse PDFs, extract skills, detect patterns, score candidates, and manage a complete hiring pipeline — all from your AI assistant, no manual work required.

Live demo: https://ai-hr-management-toolkit.vercel.app

npm version License: MIT


What Is This?

You have 50 resumes to screen. Your AI assistant can reason about candidates — but it cannot open PDFs, extract structured data, or track pipeline stages. This toolkit bridges that gap.

Give your AI assistant 21 tools covering the entire hiring workflow:

  • Parse PDFs, DOCX, TXT, Markdown, and URLs into structured JSON

  • Extract skills, experience, keywords, and entities algorithmically

  • Score and rank candidates against job descriptions

  • Run a full ATS: jobs, candidates, interviews, offers, notes, and analytics

20 of 21 tools are 100% algorithmic — no LLM calls, no API keys required. The AI calls tools, interprets the results, and delivers analysis. You just ask questions.


Related MCP server: JobDataLake MCP Server

Quick Start (MCP Clients)

No installation needed. Point your MCP client at the package:

Claude Desktop — Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "ai-hr-management-toolkit": {
      "command": "npx",
      "args": ["-y", "mcp-ai-hr-management-toolkit"]
    }
  }
}

Example usage:

Cursor — Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "ai-hr-management-toolkit": {
      "command": "npx",
      "args": ["-y", "mcp-ai-hr-management-toolkit"]
    }
  }
}

VS Code Copilot — Create .vscode/mcp.json in your project root:

{
  "servers": {
    "ai-hr-management-toolkit": {
      "command": "npx",
      "args": ["-y", "mcp-ai-hr-management-toolkit"]
    }
  }
}

VS Code users: Run the npx command from a directory that contains a package.json (i.e. any project root). The cwd key in .vscode/mcp.json can override the working directory if needed.

Windsurf / other MCP clients — Use the same npx pattern above.


Installation Options

Works from any project directory (requires a package.json in the working directory):

{
  "mcpServers": {
    "ai-hr-management-toolkit": {
      "command": "npx",
      "args": ["-y", "mcp-ai-hr-management-toolkit"]
    }
  }
}

Option 2: Global install

Install once, use from any directory:

npm install -g mcp-ai-hr-management-toolkit
{
  "mcpServers": {
    "ai-hr-management-toolkit": {
      "command": "mcp-ai-hr-management-toolkit",
      "args": []
    }
  }
}

Option 3: Remote HTTP endpoint

Deploy the Next.js app and use the Streamable HTTP transport:

https://your-domain.com/api/mcp

Test locally:

npx @modelcontextprotocol/inspector http://localhost:3000/api/mcp

Option 4: Local development (Web UI + MCP)

git clone <repo-url>
cd Resume-parser
npm install
npm run dev

Web UI at http://localhost:3000. MCP endpoint at http://localhost:3000/api/mcp. No .env needed — configure API keys in the UI or pass them per tool call.


All 21 MCP Tools

All tools return structured JSON with next_steps hints so the AI knows what to call next.

Resume Parsing & Ingestion

Tool

What it does

AI?

parse_resume

Parse PDF / DOCX / TXT / MD / URL → raw text + contacts, keywords, section map

No

batch_parse_resumes

Parse up to 20 files in one call, full pipeline on each

No

inspect_pipeline

Run the 5-stage analysis pipeline → confidence scores, entity counts, data quality report

No

Unified Analysis

Tool

What it does

AI?

analyze_resume

Master analysis tool with selectable aspects: keywords (TF-IDF + bigrams), patterns (date ranges, metrics, team sizes, career trajectory), entities (NER with 12 types + context disambiguation), skills (13 categories with proficiency estimation), experience (structured timeline), similarity (cosine, Jaccard, TF-IDF overlap vs. job description), or all

No

analyze_resume consolidates what were previously 7 separate tools (extract_keywords, detect_patterns, classify_entities, extract_skills_structured, extract_experience_structured, compute_similarity, analyze_resume_comprehensive) into a single entry point with aspect selection.

Candidate Matching & Scoring

Tool

What it does

AI?

assess_candidate

Score against up to 8 weighted criteria axes → weighted total + pass / review / reject decision

Optional

Export & Notifications

Tool

What it does

AI?

export_results

Export structured parse results to JSON or CSV

No

send_email

Send results via SMTP (config passed per call — no server-side secrets stored)

No

ATS — Jobs

Tool

What it does

AI?

ats_manage_jobs

Full CRUD for job postings: create, read, update, delete, list, search by title/department/status

No

ATS — Candidates & Pipeline

Tool

What it does

AI?

ats_manage_candidates

CRUD + analytics: add, update, move stage, bulk-move, filter, rank, compare, recommend stage changes, summarize

No

ats_analytics

Unified dashboard + pipeline analytics: stage distribution, conversion rates, avg time-in-stage, bottleneck detection, offer acceptance rate

No

ats_search

Global full-text search across all ATS entities (candidates, jobs, interviews, offers, notes)

No

ATS — Interviews

Tool

What it does

AI?

ats_schedule_interview

Create, update, and delete interviews with conflict detection and interviewer availability check

No

ats_interview_feedback

Submit structured feedback, compute consensus score, summarize feedback across all interviewers

No

ATS — Offers & Notes

Tool

What it does

AI?

ats_manage_offers

Full offer lifecycle: draft → pending → approved → sent → accepted / declined / expired

No

ats_manage_notes

Add, update, search, and delete timestamped candidate notes

No

ATS — Enterprise HR

Tool

What it does

AI?

ats_compliance

EEO/EEOC reporting, GDPR export/erasure, audit trail, data retention policies

No

ats_talent_pool

Passive candidate talent pools (CRM): create pools, add/remove candidates, search, analytics

No

ats_scorecard

Structured interview scorecards with weighted criteria, per-evaluator scores, aggregate rankings

No

ats_onboarding

Post-hire onboarding checklists: tasks by category, assignees, progress tracking, overdue alerts

No

ats_communication

Email templates with {{variable}} interpolation, send/preview, communication history, stats

No

Testing & Seeding

Tool

What it does

AI?

ats_generate_demo_data

Generate a realistic sample ATS dataset (jobs, candidates, interviews, offers) for testing

No

assess_candidate optionally calls an LLM when you supply provider + apiKey; it falls back to fully algorithmic scoring otherwise.


Example Multi-Turn Flow

You: "Parse this resume and tell me if they're a good fit for our Senior Engineer role"

AI → parse_resume(file)
     → raw text, contact info, section map

AI → inspect_pipeline(rawText)
     → 5-stage confidence scores, entity classification

AI → analyze_resume(text, aspects=["skills", "patterns", "similarity"], jobDescription=...)
     → 13 skill categories with proficiency levels
     → career trajectory, metrics, date ranges
     → cosine 0.74, skill match 82%, gap analysis

AI synthesizes → "Strong match. 6 of 8 required skills present.
                  Two gaps: Kubernetes and system design at scale.
                  Recommend: Technical Screen"

Analysis Pipeline

Every resume runs through a 5-stage algorithmic pipeline:

┌─────────────┐    ┌──────────────┐    ┌──────────────┐    ┌────────────────┐    ┌───────────────┐
│  Ingestion  │───▶│ Sanitization │───▶│ Tokenization │───▶│ Classification │───▶│ Serialization │
│ (file/URL)  │    │ (noise trim) │    │  (TF-IDF)    │    │ (NER + disamb) │    │ (structured)  │
└─────────────┘    └──────────────┘    └──────────────┘    └────────────────┘    └───────────────┘
  1. Ingestion — PDF via pdf-parse v2, DOCX via mammoth, HTML/URL via cheerio, plain text/markdown natively

  2. Sanitization — Removes non-ASCII artifacts, normalizes whitespace, strips formatting noise

  3. Tokenization — TF-IDF with unigrams, bigrams, and trigrams; scored by document frequency

  4. Classification — NER with domain-aware disambiguation (e.g. "Java" as language vs. Indonesian city; "Go" as language vs. verb)

  5. Serialization — Maps entities to typed ResumeSchema with confidence scores and data quality metrics


Supported File Formats

Format

Extensions

Parser

PDF

.pdf

pdf-parse v2

DOCX

.docx

mammoth

Plain text

.txt

direct read

Markdown

.md, .markdown

regex-based

URL / HTML

any URL string

cheerio

Max file size: 10 MB


Structured Output Schema

contact        — name, email, phone, location, LinkedIn, GitHub, website, portfolio
summary        — professional summary text
skills[]       — name, category (13 types), proficiency, usage context
experience[]   — company, title, start/end dates, highlights, achievements (with metrics), technologies
education[]    — institution, degree, field, dates, GPA
certifications[] — name, issuer, date, credential URL
projects[]     — name, description, URL, technologies, highlights
languages[]    — spoken language and proficiency

Web UI

The app ships with a full web interface:

Tab

Description

Single Parse

Upload one file or paste a URL. Returns structured data, pipeline visualization, and AI-enhanced analysis

Batch Parse

Upload up to 20 files. Export to JSON / CSV / PDF or email results

Chat

Conversational interface with tool access — ask questions about any parsed resume

ATS

Full pipeline board: jobs, candidates (Kanban), interviews, offers, and analytics dashboard

Switch AI providers from the selector at the top. Supports OpenAI, Anthropic, Google, DeepSeek, GLM, Qwen, OpenRouter, and OpenCode Zen.


REST API Endpoints

All endpoints accept multipart/form-data with optional headers:

Header

Description

x-api-key

Your AI provider API key

x-ai-provider

openai / anthropic / google / deepseek / glm / qwen / openrouter / opencodezen

x-ai-model

Specific model ID

# Parse a single resume
curl -X POST http://localhost:3000/api/parse \
  -H "x-api-key: sk-..." \
  -F "file=@resume.pdf"

# Batch parse (up to 20 files)
curl -X POST http://localhost:3000/api/batch-parse \
  -H "x-api-key: sk-..." \
  -F "files=@resume1.pdf" \
  -F "files=@resume2.docx"

# MCP endpoint (Streamable HTTP)
curl -X POST http://localhost:3000/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

# Export parsed data
curl -X POST http://localhost:3000/api/export \
  -H "Content-Type: application/json" \
  -d '{"format":"csv","results":[...]}'

Tech Stack

Layer

Technologies

Framework

Next.js 16 (App Router, Turbopack), React 19, TypeScript

AI

Vercel AI SDK v6, multi-provider (OpenAI, Anthropic, Google, DeepSeek, GLM, Qwen, OpenRouter)

MCP

@modelcontextprotocol/sdk v1.29 — Streamable HTTP + stdio transports

Parsing

pdf-parse v2, mammoth, cheerio

NLP

TF-IDF, NER, cosine similarity, Jaccard index (all in-process, no external services)

Schema

Zod v4

Export

ExcelJS (CSV/XLSX), jsPDF + jspdf-autotable

Email

Nodemailer

Styling

Tailwind CSS v4, Framer Motion


Development

npm install

# Start dev server (Web UI at :3000 + MCP at /api/mcp)
npm run dev

# Build the standalone MCP CLI (stdio transport)
npm run build:mcp

# Build the Next.js app for production
npm run build

# Test MCP with the official inspector
npx @modelcontextprotocol/inspector http://localhost:3000/api/mcp
npx @modelcontextprotocol/inspector node dist/mcp-stdio.js

# Lint
npm run lint

Project Structure

src/
├── app/
│   ├── page.tsx              # Main UI (tabs, provider selector, chat, ATS)
│   ├── layout.tsx            # Root layout + global styles
│   └── api/
│       ├── parse/route.ts    # Single resume parse
│       ├── batch-parse/route.ts
│       ├── chat/route.ts     # Conversational AI with tool access
│       ├── mcp/route.ts      # MCP server (Streamable HTTP)
│       ├── models/route.ts   # Provider model listing
│       ├── export/route.ts   # JSON / CSV / PDF export
│       └── email/route.ts    # SMTP email
├── components/               # React UI components (parse, batch, chat, ATS)
│   └── ats/                  # ATS-specific views (Kanban, Dashboard, Scheduler…)
└── lib/
    ├── ai-model.ts           # Multi-provider model config (no env fallback)
    ├── mcp-server.ts         # MCP server — registers all 21 tools
    ├── schemas/
    │   ├── resume.ts         # Zod v4 ResumeSchema
    │   └── criteria.ts       # Assessment criteria schema
    ├── analysis/
    │   ├── pipeline.ts       # 5-stage pipeline orchestrator
    │   ├── sanitizer.ts      # Text cleaning
    │   ├── keyword-extractor.ts  # TF-IDF
    │   ├── classifier.ts     # NER with context disambiguation
    │   ├── pattern-matcher.ts    # Regex extraction (metrics, dates, contacts)
    │   └── scoring.ts        # Cosine similarity, Jaccard, skill matching
    ├── parser/
    │   ├── pdf.ts, docx.ts, text.ts, markdown.ts, url.ts
    │   └── index.ts
    ├── ats/
    │   ├── types.ts          # ATS entity types
    │   ├── store.ts          # In-memory ATS state
    │   ├── demo-data.ts      # Realistic seed data generator
    │   └── context.tsx       # React context for ATS state
    └── tools/
        ├── parse-resume.ts       # parse_resume
        ├── inspect-pipeline.ts   # inspect_pipeline
        ├── export-results.ts     # export_results
        ├── send-email.ts         # send_email
        └── mcp/                  # 17 MCP-specific tools
            ├── analyze-resume.ts     # analyze_resume (unified: keywords, patterns, entities, skills, experience, similarity)
            ├── batch-parse.ts        # batch_parse_resumes
            ├── assess-candidate.ts   # assess_candidate
            ├── ats-manage-candidates.ts  # ats_manage_candidates (includes rank/filter/compare/summarize)
            ├── ats-manage-jobs.ts
            ├── ats-manage-offers.ts
            ├── ats-manage-notes.ts
            ├── ats-analytics.ts      # ats_analytics (unified dashboard + pipeline)
            ├── ats-schedule-interview.ts
            ├── ats-interview-feedback.ts
            ├── ats-search.ts
            ├── ats-generate-demo-data.ts
            ├── ats-compliance.ts     # Enterprise: EEO / GDPR / audit
            ├── ats-talent-pool.ts    # Enterprise: passive candidate CRM
            ├── ats-scorecard.ts      # Enterprise: structured scorecards
            ├── ats-onboarding.ts     # Enterprise: onboarding checklists
            └── ats-communication.ts  # Enterprise: email templates & history

License

MIT

Available Tools

24 tools
analyze_resume_comprehensiveA
Read-only

Run a comprehensive algorithmic analysis on a resume in a single call. Accepts raw text or a file (base64-encoded PDF/DOCX/TXT/MD or URL). Runs the full 5-node pipeline (Ingestion → Sanitization → Tokenization → Classification → Serialization) and returns: pipeline confidence scores, classified entities by type, categorized skills with proficiency estimates, structured experience timeline, career analysis, contact info, metrics/achievements, section quality assessment, and data quality scores. Optionally matches against a job description. This is a one-call alternative to chaining parse_resume + inspect_pipeline + classify_entities + extract_skills_structured + extract_experience_structured + compute_similarity.

Inputs: content, fileType, resumeText, jobDescription, +1 more.

assess_candidateA
Read-only

Assess a resume against recruiter-defined criteria. Supports 8 criteria axes: Education, Experience, Skills, Certifications, Knowledge Stack, Competitions, Thresholds, and Job Qualification. Returns per-axis scores, weighted overall score, and a pass/review/reject decision.

Inputs: content (required), criteria (required), fileType (required), model, +2 more.

ats_dashboard_statsB
Read-only

Generate comprehensive ATS dashboard statistics and hiring health report. Provide the full ATS state (candidates, jobs, interviews, offers). Returns key metrics, pipeline health, hiring velocity, and actionable insights.

Inputs: state (required).

ats_generate_demo_dataA

Generate a full set of realistic demo data for the ATS (Applicant Tracking System). Returns a complete ATSState with sample jobs, candidates at various pipeline stages, scheduled interviews, and offers. Useful for testing, demonstrations, or populating an empty ATS instance.

Inputs: includeStats.

ats_interview_feedbackA

Manage interview feedback in the ATS. Actions: submit (add feedback to completed interview), get (retrieve feedback for an interview), update (modify existing feedback), list_pending (interviews awaiting feedback), list_completed (interviews with feedback, optionally filtered by candidate), analyze (aggregate feedback for a candidate across all interviews), summary (hiring signal summary for a job or all jobs).

Inputs: action (required), interviews (required).

ats_manage_candidatesA
Destructive

Manage candidates in the ATS pipeline. Supports add, update, delete, move between stages, bulk move, and list/filter operations. Pass the current candidates record and an action to perform. Returns the updated candidates and a summary.

Inputs: action (required), candidates (required).

ats_manage_jobsA
Destructive

Manage job postings in the ATS. Actions: create (new job posting), update (edit fields), delete, list (with optional status/department filter), search (by keyword in title/description), close, reopen. Pass current jobs record and an action.

Inputs: jobs (required), action (required).

ats_manage_notesA
Destructive

Manage candidate notes in the ATS. Actions: add (create note on candidate), update (edit note content), list (get all notes for a candidate), delete (remove a note), search (find notes by keyword across one or all candidates), bulk_add (add notes to multiple candidates). Pass the current candidates record.

Inputs: action (required), candidates (required).

ats_manage_offersA
Destructive

Manage offers in the ATS. Actions: create (validate & structure), update_status (draft→pending-approval→approved→sent→accepted/declined), delete (remove offer), list (all offers with optional filters), compare (side-by-side offer comparison), validate (check for issues). Returns structured offer data.

Inputs: action (required), existingOffers.

ats_pipeline_analyticsA
Read-only

Analyze the ATS hiring pipeline. Given candidates and optional pipeline stage config, returns stage distribution, conversion rates between stages, average time-in-stage, and bottleneck identification. Useful for hiring funnel analysis.

Inputs: candidates (required), jobId, stageOrder.

ats_schedule_interviewA

Full CRUD for interviews. Actions: create (validate & schedule with conflict detection), update (reschedule/modify), delete (permanent removal), list (filter by candidateId/jobId/status), get (single interview by id). Pass existing interviews record for conflict checks.

Inputs: action (required), existingInterviews.

batch_parse_resumesA
Read-only

Parse multiple resume files at once and run the full algorithmic pipeline on each. Returns raw text, pipeline analysis, keywords, entities, and confidence scores for each file. The LLM client should interpret and structure the results.

Inputs: files (required).

classify_entitiesA
Read-only

Run Named Entity Recognition on resume text. Extracts 12 entity types (PERSON, ORGANIZATION, DATE, SKILL, LOCATION, EMAIL, PHONE, URL, EDUCATION_DEGREE, CERTIFICATION, JOB_TITLE, METRIC) with per-entity confidence scores (0-1) and domain-aware disambiguation (e.g., Java the language vs Java the island). Returns classified entities grouped by type, confidence statistics, and ambiguity analysis. 100% algorithmic — no AI calls needed.

Inputs: resumeText (required), entityTypes, minConfidence.

compute_similarityA
Read-only

Compare a resume against a job description using cosine similarity, Jaccard index, TF-IDF overlap, and skill matching. Returns a computed fit tier (strong/moderate/weak/poor), per-skill gap analysis with categories, and actionable gap recommendations. No AI calls — all scoring is algorithmic.

Inputs: resumeText (required), jobDescription (required).

detect_patternsA
Read-only

Detect and structure date ranges, metrics, sections, and work experience from resume text. Returns structured experience entries with titles, organizations, technologies, and achievements extracted algorithmically using NER, date patterns, and TF-IDF. Also detects career progression trajectory. No AI calls.

Inputs: resumeText (required).

export_resultsA
Read-only

Export parsed resume results to a specified format (JSON or CSV text). Accepts an array of structured resume results and returns formatted output.

Inputs: format (required), results (required).

extract_experience_structuredA
Read-only

Extract and structure work experience from resume text using algorithmic analysis only (no AI). Uses date range detection, metric extraction, NER entity classification (job titles, organizations, skills), and heuristic block splitting to produce structured experience entries. Each entry includes detected title, organization, date range, duration estimate, associated metrics/achievements, and technologies. Returns structured data plus overall career statistics.

Inputs: resumeText (required).

extract_keywordsA
Read-only

Extract keywords from resume text using TF-IDF analysis, then overlay entity classification (NER) and skill categorization. Returns ranked keywords enriched with entity type, skill category, and confidence scores. No AI calls — all computation is algorithmic.

Inputs: resumeText (required), topN.

extract_skills_structuredA
Read-only

Extract and categorize skills from resume text using algorithmic analysis only (no AI). Combines NER entity classification (with disambiguation), TF-IDF keyword ranking, section detection, and frequency-based proficiency estimation. Returns skills organized by 13 categories (programming_language, framework, database, devops_cloud, ml_ai, design, methodology, tool, soft_skill, testing, security, web_frontend, mobile, other) with estimated proficiency levels and supporting evidence. Far more structured than extract_keywords — use this when you need categorized, proficiency-rated skill output.

Inputs: resumeText (required), requiredSkills.

inspect_pipelineA
Read-only

Run the full 5-node atomic deconstruction pipeline (Ingestion → Sanitization → Tokenization → Classification → Serialization) on resume text. Returns stage-by-stage metrics, confidence scores, entity classification with disambiguation, data quality assessment, and assumption audit. Use this to understand HOW the parser processes a resume and WHERE confidence is low.

Inputs: resumeText (required).

manage_candidatesA
Destructive

Manage and analyze candidates: rank by fit, filter by criteria, recommend pipeline stage changes, compare candidates side-by-side, or get a summary. Operates on candidate data passed in — does not access browser storage.

Inputs: action (required), candidates (required), criteria, jobDescription.

parse_resumeA
Read-only

Parse a resume file (PDF, DOCX, TXT, MD) or URL and extract text with algorithmic pre-analysis including keyword extraction, metrics detection, section identification, and experience estimation.

Inputs: content (required), fileType (required).

send_emailA

Send parsed resume results via email using SMTP. Requires SMTP configuration (host, port, user, pass) and recipient email. Sends an HTML summary of all results.

Inputs: to (required), results (required), smtpHost (required), smtpPass (required), +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 24 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is overlap between manage_candidates and ats_manage_candidates, and between extract_keywords and extract_skills_structured. Descriptions clarify the differences, but an agent might still pick the wrong one in ambiguous contexts.

    Naming Consistency5/5

    All tools follow a clear verb_noun pattern, with ATS-specific tools consistently prefixed with ats_. Minor exceptions like analyze_resume_comprehensive are still predictable. This pattern makes tool selection intuitive.

    Tool Count4/5

    With 24 tools, the server is on the heavier side but covers two major domains: resume parsing/analysis and ATS management. Each tool serves a specific sub-function, and while some consolidation is possible, the count is justified for the scope.

    Completeness4/5

    The server covers the full HR workflow: resume ingestion and analysis, candidate assessment, ATS CRUD for candidates, jobs, interviews, offers, notes, feedback, plus analytics and demo data. Minor gaps exist (e.g., no direct job board integration), but core operations are well covered.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables searching over 1 million enriched job listings from 20,000+ companies directly from MCP-compatible AI tools. Provides tools for job search, company profiles, and AI-powered similar job recommendations with real-time data updates.
      4
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An AI job-hunt copilot that enables searching live job boards, shortlisting openings, tracking application pipelines, and generating tailored resumes and cover letters from any MCP client.
      14
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables any MCP-capable AI app to act as a personal job-search assistant by storing resumes and job postings, matching skills, tracking applications, and analyzing market skill demand.
      MIT