Skip to main content
Glama
resume-scorer-mcp

resume-scorer-mcp

by KhushalB25

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.

MIT License Node ≥ 18 MCP

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-mcp

Or run directly via npx:

npx resume-scorer-mcp

Use with Claude Desktop

Add to claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %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 start

Test with @modelcontextprotocol/inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Rubric 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

Khushal Bhandari · GitHub

License

MIT

Available Tools

2 tools
score_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

    A4.5/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    Both tools follow the same `score_resume` prefix, with the second having a descriptive suffix `_from_freeform`. The pattern is consistent and predictable.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP 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.
      -
    • A
      license
      B
      quality
      D
      maintenance
      Deterministic 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.
      75
      MIT