ATS Scanner MCP Server

An MCP (Model Context Protocol) server that automates ATS resume scanning through Jobscan. Connect it to Claude (or any MCP-compatible AI assistant) and let it scan, analyze gaps, optimize, and rescan your resume against any job description automatically.

What It Does

Instead of manually copying your resume and job description into an ATS scanner, reading the gaps, editing, and rescanning over and over, this server lets Claude do the entire loop:

Scan your resume against a job description
Read the gaps (missing hard skills, soft skills, keyword matches)
Edit the resume to close those gaps
Rescan to verify the score improved
Repeat until the match rate hits your target (e.g., 90%+)

All in one conversation. No tab switching. No manual copy-paste.

Tools Exposed

| Tool | Description | |---|---| | jobscan_login | Authenticate with Jobscan. Auto-runs on first scan if not called explicitly. | | jobscan_scan | Scan a resume against a job description. Returns match rate, found/missing skills. | | jobscan_rescan | Rescan with an updated resume (JD already loaded from previous scan). Faster than a full scan. | | jobscan_get_gaps | Get a focused list of missing keywords from the most recent scan. | | jobscan_raw_results | Get the full raw scan results as JSON for detailed analysis. |

Prerequisites

Node.js 18+
A Jobscan account (free or paid)
Chrome/Chromium installed (Playwright uses it in headed mode for Cloudflare bypass)

Setup

Clone the repo:

git clone https://github.com/jhansy29/ats-scanner-mcp.git
cd ats-scanner-mcp

Install dependencies:

npm install
npx playwright install chromium

Create your .env file:

cp .env.example .env

Then edit .env with your Jobscan credentials:

JOBSCAN_EMAIL=your-email@example.com
JOBSCAN_PASSWORD=your-password

Build:
```
npm run build
```

Connect to Claude

Add this to your Claude MCP config (e.g., claude_desktop_config.json or .claude/settings.json):

{
  "mcpServers": {
    "ats-scanner": {
      "command": "node",
      "args": ["path/to/ats-scanner-mcp/dist/index.js"]
    }
  }
}

Usage

Once connected, just tell Claude:

"Here's my resume and the job description. Scan it, find the gaps, update the resume, and rescan until it's above 90%."

Claude will call the MCP tools in sequence to handle the full optimization loop.

Important: Build a Knowledge Base First

This works best when the AI has access to a knowledge base of your real experiences, projects, and bullet variants. Without it, the AI is guessing when it edits. With it, every optimization is grounded in work you actually did. No fabrication, just better keyword alignment.

How It Works

Uses Playwright to automate a real Chrome browser session with your Jobscan credentials
Launches Chrome in headed mode to handle Cloudflare verification
Parses scan results (match rate, hard/soft skill gaps, searchability, recruiter tips) and returns structured data to the AI
The rescan tool reuses the existing session so the JD stays loaded, making iterations fast

Tech Stack

TypeScript
Model Context Protocol SDK
Playwright
Zod for input validation

License

MIT

MCP Servers