Skip to main content
Glama
matchcv-mcp

matchcv-mcp

by 18boys

MatchCV MCP Server

npm License: MIT

Resume tools for MCP clients. Check a resume against ATS rules, parse a job description into structured requirements, get rewrite-level suggestions, and generate a fully tailored resume with a shareable preview link — all from inside Claude, Cursor, Codex, or any other MCP-compatible client.

Powered by MatchCV · MCP docs · Get started free


Tools

Tool

What it does

ats_check

Scores resume text 0–100 for ATS compatibility, with a recruiter take, prioritized issues and fixes, and detected strengths

analyze_job_description

Turns a job posting into structured JSON: title, company, seniority, industry, must-have / nice-to-have keywords, responsibilities

optimize_resume

Prioritized improvement suggestions with example rewrites, optionally targeted at a role, a JD, and specific missing keywords

roast_resume

Blunt recruiter-style critique plus an ATS score, returned as a public shareable report link

extract_resume_text

Reads a local PDF/DOC/DOCX/TXT resume and returns plain text, optionally AI-parsed into structured JSON

tailor_resume

Full pipeline — analyze the JD, rewrite the resume for that role, return the tailored JSON plus a preview page you can open and download as PDF

Related MCP server: resume-kit MCP Server

Install

Requires Node.js 20+. No API key and no account are needed to start.

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json, or run claude mcp add):

{
  "mcpServers": {
    "matchcv": {
      "command": "npx",
      "args": ["-y", "matchcv-mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "matchcv": {
      "command": "npx",
      "args": ["-y", "matchcv-mcp"]
    }
  }
}

Codex CLI

~/.codex/config.toml:

[mcp_servers.matchcv]
command = "npx"
args = ["-y", "matchcv-mcp"]

Any other MCP client

The server speaks MCP over stdio. Run it directly with:

npx -y matchcv-mcp

Example prompts

  • "Read ~/Documents/resume.pdf and tell me how it scores against ATS."

  • "Here's a job posting — what keywords is my resume missing?"

  • "Roast my resume, I want the honest version."

  • "Tailor my resume to this job description and give me the preview link."

Usage limits

The tools call MatchCV's public endpoints, so free usage is capped per day, per IP address:

Free (no account)

Signed in

Pro

ats_check, analyze_job_description, optimize_resume, roast_resume, structured parsing

3/day

10/day

Unlimited

tailor_resume

1/day

3/day

Unlimited

Plain text extraction (extract_resume_text without structured: true) is unlimited — it runs no AI.

Quota errors come back as a readable message telling you how to raise the limit. See matchcv.co/pricing.

Configuration

Environment variable

Default

Purpose

MATCHCV_BASE_URL

https://matchcv.co

API origin. Only needed to point at a development deployment.

Privacy

This server holds no credentials and stores nothing locally. Resume and job description text is sent to the MatchCV API over HTTPS for processing. roast_resume and tailor_resume create a page at an unguessable public URL so you can open and share the result; the other tools store nothing. See the privacy policy.

Development

npm install
npm run build
node dist/index.js

Point it at a local MatchCV instance with MATCHCV_BASE_URL=http://localhost:3000.

License

MIT — see LICENSE.

Available Tools

6 tools
analyze_job_descriptionExtract structured requirements from a job descriptionA

Parse a job posting into structured data: title, company, seniority, industry, must-have keywords, nice-to-have keywords, and key responsibilities. Feed the result into optimize_resume to find keyword gaps.

Inputs: jdText (required).

ats_checkCheck a resume against ATS rulesA

Score resume text for applicant tracking system (ATS) compatibility. Returns a 0-100 score, a recruiter take, prioritized issues with concrete fixes, and detected strengths. Use for "is my resume ATS friendly", "why am I not getting interviews", or before tailoring to a specific job.

Inputs: resumeText (required).

extract_resume_textExtract plain text from a local resume fileA

Read a local PDF/DOC/DOCX/TXT resume and return its plain text, optionally also parsing it into structured JSON (name, experience, education, skills). Text extraction is unlimited; set structured=true only when the structured form is needed, since that path uses a daily AI credit. Scanned/image-only PDFs will fail — ask the user to paste the text instead.

Inputs: filePath (required), structured.

optimize_resumeGet targeted resume improvement suggestionsA

Return prioritized, rewrite-level suggestions for a resume, optionally aimed at a specific role or job description. Each suggestion has a type, priority, tip, and an example rewrite. Pass missingMustHave / missingNiceToHave from analyze_job_description to close keyword gaps.

Inputs: resumeText (required), jdText, jobTitle, missingMustHave, +1 more.

roast_resumeGet a blunt recruiter-style critique of a resumeA

Run the MatchCV "resume roast": a brutally honest recruiter reaction plus an ATS score. Returns a public shareable report URL. Use when the user wants candid feedback rather than a polite checklist.

Inputs: resumeText (required), jobTitle.

tailor_resumeGenerate a resume tailored to a specific jobA

The full MatchCV pipeline: analyze the job description, structure the resume, then rewrite it for that role with must-have keywords worked in and bullets rewritten. Returns the tailored resume JSON, an ATS score, and a public preview link the user can open and download as PDF. This is the heaviest tool — it uses one generation credit plus the parse and JD-analysis credits, so run it once the user has settled on a target job.

Inputs: jdText (required), resumeText (required), templateId, targetLanguage.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 6 tools

    Disambiguation4/5

    Most tools map to a distinct pipeline stage: extract, analyze, optimize, tailor. ats_check and roast_resume overlap somewhat since both return ATS scores and recruiter feedback, but their descriptions clearly separate polite actionable feedback from a candid shareable roast, and optimize_resume vs tailor_resume are differentiated by suggestion-level vs full rewrite.

    Naming Consistency4/5

    All tool names use lowercase snake_case and mostly follow an imperative verb_noun pattern: analyze_job_description, optimize_resume, extract_resume_text, tailor_resume. ats_check is the only deviation, reading more like a noun phrase than check_ats, but the overall naming remains predictable and readable.

    Tool Count5/5

    Six tools is a well-scoped size for a resume/CV assistant, covering input extraction, job description parsing, ATS feedback, optimization, roasting, and full tailoring. Each tool has a clear role in the workflow, and there is no sense of bloat or excessive granularity.

    Completeness5/5

    The tool surface covers the core resume workflow end to end: extract text, parse job descriptions, diagnose ATS issues, suggest improvements, and generate a fully tailored resume with a preview link. There are no obvious dead ends, and the descriptions include appropriate guidance for handling limitations such as scanned PDFs or AI credit usage.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers