resume-scorer-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., "@resume-scorer-mcp Score my resume against the rubric"
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.
resume-scorer-mcp
MCP server that scores a structured resume against a deterministic 4-category engineering rubric. Numeric score, evidence per category, bonus points, deductions, concrete improvement areas — all without an LLM call.
What it scores
Four categories tuned for modern engineering profiles:
Category | Max |
Open Source contributions | 35 |
Self Projects | 30 |
Production Experience | 25 |
Technical Skills | 10 |
Bonus (portfolio, LinkedIn, etc.) | +20 |
Deductions (missing links, tutorial projects) | up to −15 |
Total | 100 (+20 bonus) |
Related MCP server: decroche-mcp
Why use it
Candidates — self-check before applying. Iterate until score crosses your target.
Recruiters — bulk-screen JSON Resumes without sending content to a paid LLM.
AI agents — a deterministic scoring primitive for agent workflows.
Privacy — no resume content leaves your machine.
Install
npm install -g resume-scorer-mcpOr run directly via npx:
npx resume-scorer-mcpUse with Claude Desktop
Add to claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"resume-scorer": {
"command": "npx",
"args": ["-y", "resume-scorer-mcp"]
}
}
}Restart Claude Desktop. Ask:
"Score this resume against the rubric" + paste a JSON Resume
Tools
score_resume
Score a structured resume in JSON Resume format.
{
"resume_json": {
"basics": {
"name": "Your Name",
"url": "https://yoursite.dev",
"profiles": [
{ "network": "GitHub", "url": "https://github.com/you" },
{ "network": "LinkedIn", "url": "https://linkedin.com/in/you" }
]
},
"work": [
{ "name": "Company", "startDate": "2025-03", "endDate": "2026-04",
"highlights": ["Built X with Y …"] }
],
"projects": [
{ "name": "Project", "url": "https://project.dev",
"description": "Real-time LLM thing using OpenAI/Claude…",
"technologies": ["Next.js", "Firebase", "OpenAI"] }
],
"skills": [{ "name": "Languages", "keywords": ["Python", "TypeScript", "React"] }]
}
}Also accepts resume_json_path (absolute path) instead of inline data.
score_resume_from_freeform
Best-effort scoring of plain text. Less accurate. Use score_resume when possible.
Example response
{
"scores": {
"open_source": { "score": 6, "max": 35, "evidence": "GitHub URL present but no external contributions detected …" },
"self_projects": { "score": 22, "max": 30, "evidence": "Per-project breakdown: Project: 3 complexity signals, link present -> 8/10 …" },
"production": { "score": 19, "max": 25, "evidence": "~3.1 years total production tenure across 3 role(s) (LLM production weighting +2)." },
"technical_skills":{ "score": 9, "max": 10, "evidence": "18 distinct technologies/keywords detected." }
},
"bonus_points": { "total": 3, "breakdown": "+2 portfolio URL - +1 LinkedIn profile" },
"deductions": { "total": 2, "reasons": "-2 for 1 project(s) without links: …" },
"key_strengths": [
"Solid production tenure with multi-year track record.",
"Personal projects show technical depth and shipped artefacts.",
"Broad polyglot stack signal."
],
"areas_for_improvement": [
"Land 2-3 merged pull requests to popular open-source repos to break out of the <=10 self-only cap.",
"Add live demo or repo URL to every project to remove missing-link deductions."
],
"total": 59,
"max_total": 100
}Local development
git clone https://github.com/KhushalB25/resume-scorer-mcp.git
cd resume-scorer-mcp
npm install
npm run build
npm startTest with @modelcontextprotocol/inspector:
npx @modelcontextprotocol/inspector node dist/index.jsRubric design
The scoring rubric is the author's own design. Bands are tuned for early-career to mid-career software engineers. Categories and weightings can be customised by forking src/index.ts — pure functions, no external scoring service.
Author
License
MIT
Available Tools
2 toolsscore_resumeA
Score a structured resume (JSON Resume format) against the HackerRank hiring-agent rubric. Returns category scores (open_source 0-35, self_projects 0-30, production 0-25, technical_skills 0-10), bonus points, deductions, strengths, and improvement areas.
Inputs: resume_json, resume_json_path.
score_resume_from_freeformA
Score a resume passed as free-form text. The server makes best-effort regex extraction of email, GitHub, project names, and tech keywords. Less accurate than score_resume with structured input.
Inputs: text (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
Both tools have clearly distinct purposes: one expects structured JSON Resume input, the other accepts free-form text. Descriptions explicitly state the difference and accuracy trade-off, leaving no ambiguity.
Both tools follow the same `score_resume` prefix, with the second having a descriptive suffix `_from_freeform`. The pattern is consistent and predictable.
Two tools is minimal but appropriate for this narrow domain—scoring resumes in two input formats. Could potentially add a third for batch processing, but current count is reasonable.
The set covers the two likely input types (structured and freeform). No obvious gaps like scoring from a file path or returning additional output formats, but the core functionality is complete.
Maintenance
Related MCP Connectors
MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.
Pay-per-call AI evaluation MCP server. Score LLM outputs against benchmark rubrics via Workers AI.
MCP server for VC pitch-deck scoring, thesis-fit matching, and deal-flow management.
Evidence-readiness MCP server: validate, audit, and score briefs, memos, and evidence packs.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server for candidate scoring. Post a resume and job description, get back structured scores across skills match, experience, industry background, and education — plus strengths and gaps grounded in the actual text. Hosted API at recruit api .app or self-host on Railway.-
- AlicenseBqualityDmaintenanceDeterministic MCP server for job-landing pipeline that parses CVs into validated JSON Resume, detects sections, scores parse confidence, and exposes FR/US market profiles to help beat ATS and LLM screeners honestly.75MIT
- AlicenseNot gradedqualityDmaintenanceAn intelligent, zero-cost MCP server that securely parses local resumes and compares them against live job postings for ATS scoring, skill gap analysis, and interview prep.MIT
- FlicenseAqualityDmaintenanceAn MCP server that tailors LaTeX resumes to job descriptions using Claude, returning a structured diff with keywords, gap summary, bullet changes, and a guardrails report.2-