Back to Browse

Matchcv MCP Server

by 18boys
Developer ToolsModerate5.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

ATS resume checking, job description analysis, and AI resume tailoring powered by MatchCV.

About

ATS resume checking, job description analysis, and AI resume tailoring powered by MatchCV.

Security Report

5.2
Moderate5.2Moderate Risk

MatchCV MCP is a well-structured resume analysis tool with good security practices. No hardcoded credentials, no dangerous code patterns, and appropriate input validation. The server requires no authentication but calls a public API with rate limits; all data transmission is HTTPS and properly scoped. Minor code quality observations do not materially impact security. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

7 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Override MatchCV API origin. Defaults to https://matchcv.co.Optional

Environment variable: MATCHCV_BASE_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-18boys-matchcv": {
      "env": {
        "MATCHCV_BASE_URL": "your-matchcv-base-url-here"
      },
      "args": [
        "-y",
        "matchcv-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

ToolWhat it does
ats_checkScores resume text 0–100 for ATS compatibility, with a recruiter take, prioritized issues and fixes, and detected strengths
analyze_job_descriptionTurns a job posting into structured JSON: title, company, seniority, industry, must-have / nice-to-have keywords, responsibilities
optimize_resumePrioritized improvement suggestions with example rewrites, optionally targeted at a role, a JD, and specific missing keywords
roast_resumeBlunt recruiter-style critique plus an ATS score, returned as a public shareable report link
extract_resume_textReads a local PDF/DOC/DOCX/TXT resume and returns plain text, optionally AI-parsed into structured JSON
tailor_resumeFull 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

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 inPro
ats_check, analyze_job_description, optimize_resume, roast_resume, structured parsing3/day10/dayUnlimited
tailor_resume1/day3/dayUnlimited

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 variableDefaultPurpose
MATCHCV_BASE_URLhttps://matchcv.coAPI 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.

Reviews

No reviews yet

Be the first to review this server!