Matchcv

io.github.18boysPublished by GitHub account 18boysv0.1.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyProductivity & WorkflowAI & ML

Overview

AI-generated overview

A local MCP server that lets an assistant score resumes for ATS compatibility, analyze job descriptions, suggest rewrites, and generate tailored resumes via the

What you can do
Score resume text for ATS compatibility with prioritized issues, fixes and strengths, and get a blunt recruiter-style critique as a shareable report link. Parse a job posting into structured requirements such as title, company, seniority and must-have keywords. Get prioritized improvement suggestions with example rewrites, optionally targeted at a role or job description. Read a local PDF, DOC, DOCX or TXT resume into plain text, optionally parsed into structured JSON. Run a full tailoring pipeline that rewrites the resume for a role and returns tailored JSON plus a preview page downloadable as PDF.
When to use it
Useful when job seekers want an assistant to check a resume against ATS rules, compare it with a specific job posting, or produce a tailored version with a preview link, without leaving their MCP client.
Requirements
Node.js 20 or later; runs locally over stdio, typically started with npx. No account or API key is needed to start. Network access to the MatchCV API is required; the MATCHCV_BASE_URL variable can override the API origin. Free usage is capped per day per IP address.
Before you install
Resume and job description text is sent to the MatchCV API over HTTPS for processing. The roast and tailor tools create a page at an unguessable public URL that can be shared. Free usage is limited per day per IP address, and higher limits require signing in or a paid plan. Plain text extraction runs no AI and is unlimited.

Installation

In SourceWeft

  1. Open Matchcv in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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):

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

Cursor

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

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

Codex CLI

~/.codex/config.toml:

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

Any other MCP client

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

bash
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

bash
npm installnpm run buildnode dist/index.js

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

License

MIT — see LICENSE.

Source: README.md at commit c3ceccf

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts