Skip to main content
Glama
ats-scanner-mcp

ats-scanner-mcp

ats-scanner-mcp

A Jobscan-style ATS resume scanner packaged as an MCP server, so Claude Desktop can scan your resume against a job posting, show the match rate and missing keywords, and then propose edits — no subscription, no API key, nothing leaves your machine.

Claude Desktop is the "brain": the server does the deterministic parts an ATS does (keyword extraction, matching, searchability checks, scoring) and hands Claude structured results plus the raw text so it can reason about semantic gaps and rewrite bullets.

What it checks

Area

What the scanner does

Hard skills

Matches ~250 dictionary skills (languages, frameworks, cloud, data, DevOps, AI/LLM, security, practices, tools) with alias handling (Node = Node.js = NodeJS), classifies each as required / preferred / mentioned by reading the posting's section headings, and counts mentions on both sides.

Soft skills

Same, for communication / collaboration / leadership / ownership etc.

Job title

Exact title in the resume, core title (Software Engineer from Senior Software Engineer, Applied AI), or word overlap.

Education

Degree / certification requirements vs what the resume shows; softened when the posting says "or equivalent experience".

Experience

Minimum years in the posting vs the date range in your Experience section.

Searchability

Email, phone, LinkedIn, location, standard section headings, dates, measurable results, weak bullet openers, overlong bullets, length, file name, PDF parsing red flags (unreadable glyphs, multi-column layouts).

Discovered phrases

Recurring phrases in the posting that aren't in the dictionary — Claude judges relevance.

Match rate = hard skills 45% · searchability 20% · title 10% · soft skills 10% · education 10% · experience 5%.

Related MCP server: resume-tailor-mcp-server

Install

git clone https://github.com/<you>/ats-scanner-mcp.git
cd ats-scanner-mcp
npm install
npm run build

Requires Node 18+.

Claude Desktop configuration

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "ats-scanner": {
      "command": "node",
      "args": ["/absolute/path/to/ats-scanner-mcp/dist/index.js"],
      "env": {
        "ATS_RESUME_DIR": "/home/you/Documents/Resumes"
      }
    }
  }
}

Restart Claude Desktop. ATS_RESUME_DIR is optional (defaults to ~/Documents/Resumes); it lets you refer to resumes by bare file name.

Optional: ATS_EXTRA_SKILLS=/path/to/skills.json adds your own dictionary entries:

[
  { "name": "Amplify Gen 2", "aliases": ["amplify gen2"], "category": "cloud" },
  { "name": "Proxyware Detection", "category": "security" }
]

Using it in Claude Desktop

Paste a posting and ask:

Run an ATS scan of EQ_Maitland-Soto_Resume_2026.pdf against this posting and suggest edits: …

Or use the built-in tailor_resume prompt (the "+" / prompts menu in Claude Desktop), which walks Claude through: scan → report gaps → propose honest before/after edits → re-scan the edited draft with resume_text and report the new score.

Tools

Tool

Purpose

scan_resume

Full scan. resume_path or resume_text (to re-score a draft), job_text, optional job_title, format = markdown / json / both.

extract_job_keywords

Title, company, hard/soft skills with importance + counts, education, years, discovered phrases.

parse_resume

What an ATS sees: sections, contact info, dates, bullet stats, warnings, extracted text.

list_resumes

Files in your resume folder.

compare_resumes

Rank several resume variants against one posting.

Resumes: PDF, Markdown, or plain text. (DOCX: export to PDF first.)

CLI (no Claude needed)

npm run cli -- ~/Documents/Resumes/my-resume.pdf posting.txt          # markdown report
npm run cli -- ~/Documents/Resumes/my-resume.pdf posting.txt --json   # structured

Try it with the bundled sample: npm run cli -- examples/Alex-Sample-Resume.pdf examples/sample-posting.txt

Development

npm test        # vitest
npm run dev     # tsc --watch

Layout: src/skills.ts (dictionary) · src/text.ts (matching) · src/extract.ts (posting → profile) · src/resume.ts (resume parsing) · src/score.ts (scoring + checks) · src/report.ts (markdown) · src/index.ts (MCP server) · src/cli.ts.

Honest-use note

The scanner tells you which words are missing; it does not know whether you have the skill. The tailor_resume prompt instructs Claude to only add skills you can evidence and to say plainly when you don't have something. Keyword stuffing gets past filters and then fails in interviews.

License

MIT

Available Tools

5 tools
compare_resumesCompare several resumes against one postingA
Read-only

Scores multiple resume files against the same job posting and ranks them — useful for picking which variant of a master resume to tailor.

Inputs: job_text (required), resume_paths (required), job_title.

extract_job_keywordsExtract keywords from a job postingA
Read-only

Pulls the ATS-relevant signals out of a job posting: title, company, hard skills and soft skills (with required/preferred importance and mention counts), education/certification requirements, minimum years of experience, and recurring phrases not in the skills dictionary.

Inputs: job_text (required), job_title.

list_resumesList resume filesA
Read-only

Lists resume files (.pdf, .md, .txt) in the resume folder (default /root/Documents/Resumes; set ATS_RESUME_DIR to change) or a folder you pass.

Inputs: dir.

parse_resumeParse resume the way an ATS wouldA
Read-only

Shows what an ATS extracts from the resume: detected sections and headings, contact info, date range and estimated years of experience, bullet stats (metrics, weak verbs, overly long bullets), formatting/parsing warnings, and the raw extracted text.

Inputs: resume_path, resume_text, include_text.

scan_resumeATS scan resume against job postingA
Read-only

Jobscan-style ATS scan. Scores a resume against a job posting (0-100 match rate), lists matched and MISSING hard/soft skills with importance (required vs preferred) and counts, checks title/education/years-of-experience fit, runs searchability & formatting checks, and returns concrete suggestions. Use resume_text to re-score a draft after edits.

Inputs: job_text (required), format, job_title, resume_path, +1 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct responsibility: scanning a resume, extracting job keywords, parsing a resume, listing resume files, and comparing multiple resumes. Even though scan_resume and compare_resumes both score resumes, one targets a single resume while the other ranks multiple files, so there is no real ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent lowercase snake_case verb_noun pattern: scan_resume, extract_job_keywords, parse_resume, list_resumes, compare_resumes. The verbs are distinct and descriptive, making the tool set easy to predict and navigate.

    Tool Count5/5

    Five tools is a well-scoped size for an ATS scanning server. The set covers the core workflow without unnecessary duplication or bloat, and every tool clearly earns its place.

    Completeness5/5

    The tool surface covers the full resume-scanning workflow: list available resumes, parse and inspect a resume, extract job posting requirements, scan a resume against a posting, and compare multiple resume variants. There are no obvious dead ends or missing operations for the server's stated purpose.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to intelligently query and analyze your resume using RAG technology. Supports skill matching against job requirements and answering questions about your professional background from locally stored resume files.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude Desktop to act as an ATS resume checker: lists resume files and evaluates them against job descriptions, providing formatting audits and keyword match scores.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching and evaluating job postings from LinkedIn and freehire.me directly through Claude Desktop. Provides tools to search jobs, fetch full posting details, and assess candidate fit using eligibility scans and a scoring rubric.
      MIT