matchcv-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., "@matchcv-mcp Check my resume for ATS compatibility and tell me how to improve it."
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.
MatchCV MCP Server
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 |
| Scores resume text 0–100 for ATS compatibility, with a recruiter take, prioritized issues and fixes, and detected strengths |
| Turns a job posting into structured JSON: title, company, seniority, industry, must-have / nice-to-have keywords, responsibilities |
| Prioritized improvement suggestions with example rewrites, optionally targeted at a role, a JD, and specific missing keywords |
| Blunt recruiter-style critique plus an ATS score, returned as a public shareable report link |
| Reads a local PDF/DOC/DOCX/TXT resume and returns plain text, optionally AI-parsed into structured JSON |
| 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-mcpExample prompts
"Read
~/Documents/resume.pdfand 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 | |
| 3/day | 10/day | Unlimited |
| 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 |
|
| 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.jsPoint it at a local MatchCV instance with MATCHCV_BASE_URL=http://localhost:3000.
License
MIT — see LICENSE.
Available Tools
6 toolsanalyze_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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
Resume builder with native MCP — create and edit resumes from your AI assistant.
A job-search companion: tailor your CV to a role, score fit, fix ATS issues. Also via MCP.
Your career companion for ATS checks, resumes, cover letters, job tracking, websites, and more.
Analyze job listings against your resume, track applications, and generate cover letters.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceAn 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
- AlicenseNot gradedqualityDmaintenanceMCP server that evaluates, compares, aligns, generates, and validates resume materials against specific job postings, including ATS parseability checks, match scoring, and gap analysis.1Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables JD-aware resume matching through MCP tools, providing deterministic scoring, gap analysis, bullet rewrites, and tailored cover letter generation.MIT
- AlicenseAqualityDmaintenanceMCP server for AI-powered resume optimization and generation. It enables clients to optimize existing resumes or generate new ones from background info via LLM, producing formatted .docx and .pdf files.21MIT