ats-scanner-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ats-scanner-mcp Run an ATS scan of my resume against this job posting and suggest edits."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 ( |
Soft skills | Same, for communication / collaboration / leadership / ownership etc. |
Job title | Exact title in the resume, core title ( |
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 buildRequires 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.pdfagainst 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 |
| Full scan. |
| Title, company, hard/soft skills with importance + counts, education, years, discovered phrases. |
| What an ATS sees: sections, contact info, dates, bullet stats, warnings, extracted text. |
| Files in your resume folder. |
| 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 # structuredTry 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 --watchLayout: 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 toolscompare_resumesCompare several resumes against one postingARead-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 postingARead-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 filesARead-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 wouldARead-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 postingARead-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
Scored across 5 tools
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.
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.
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.
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
Build an ATS-friendly resume and check it against a job description, fully offline.
AI resume triage for recruiters. Query your candidate pool from Claude or ChatGPT.
Your career companion for ATS checks, resumes, cover letters, job tracking, websites, and more.
Read your CVPosh resumes, check ATS compatibility and match keywords to a job posting.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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
- FlicenseNot gradedqualityCmaintenanceHelps job seekers tailor their resume and generate cover letters against a specific job posting, powered by Claude.-
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseNot gradedqualityDmaintenanceEnables 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