DEV Community

Louis Desclous
Louis Desclous

Posted on AI-assisted

I gave Claude a resume parser: an MCP server that parses CVs and ranks candidates

I run HireLayer, a small French company that sells recruiting APIs: resume parsing, job description parsing, candidate matching and ranking, and skills normalization. Developers call it over REST. But a lot of the people who actually screen candidates now live inside Claude or ChatGPT, so I shipped an MCP server for it.

This post shows what it does and how to plug it in, in about two minutes.

What the server exposes

Five tools, one per API:

Tool What it does
parse_resume Resume file (PDF, DOCX, images…) → structured JSON: contact details, experience, education, languages, skills, full text
extract_job_criteria Job description → weighted criteria (weight 1–3, mandatory flag, rationale)
match_candidate One resume vs. one job, criterion by criterion, with a 0–1 score
rank_candidates Up to 10 resumes ranked for one job, with a rationale each
resolve_skills Free-text skills → taxonomy skills (11,061 skills)

There are also prompts for common flows (screen_candidates, summarize_resume, normalize_skills).

Connect it

Hosted server, OAuth sign-in, no key to paste:

  • Claude Code: claude mcp add --transport http hirelayer https://hirelayer.co/mcp
  • Claude / ChatGPT: add https://hirelayer.co/mcp as a custom connector and sign in.
  • Cursor / VS Code: one-click install links are on hirelayer.co/mcp.

Prefer local? npx -y hirelayer-mcp with a HIRELAYER_API_KEY env var. Source: github.com/HireLayer/hirelayer-mcp.

A real prompt

Here are 6 CVs and a job description for a senior backend engineer. Rank the candidates and tell me who to call first and why.

Claude parses the CVs with parse_resume, sends their text to rank_candidates with the job description, and answers with a ranked list where each candidate comes with a score and a rationale. For a criterion-by-criterion check on the top picks, it calls extract_job_criteria and then match_candidate. The rationales come back in French today, so the assistant translates them when you write in English. The scores are there to support the recruiter's decision, not to replace it.

Cost

Every successful tool call is one credit. The free plan has 50 credits a month, no card; paid plans start at €24 for 500 credits (pricing). Resumes are processed in Paris, France.

I also wrote up a vendor-neutral list of MCP servers for recruiting (parsing, matching, and the official Greenhouse, Ashby, Workable and Teamtailor servers) if you're comparing options.

If you build recruiting tools or agents, I'd love feedback on the tool design: what would you want an agent to be able to do with candidates that these five tools don't cover?

Top comments (0)