DW

dk017/werkcv-mcp

Developer tools
0 stars 0 forks Quality 73 Trend 20MIT

Remote MCP server: grade a CV for the Dutch job market, compare it with a vacancy, open it in the WerkCV editor. No auth.

Overview

A hosted, remote Model Context Protocol server that grades a CV for the Dutch job market, compares it with a vacancy, and opens it in the WerkCV editor. - https://werkcv.nl/api/mcp - Streamable HTTP (stateless) - none - nl.werkcv/cv-check (official MCP Registry) - https://werkcv.nl/en/ai-assistant (Dutch: https://werkcv.nl/ai-assistent) This repository documents the hosted server: connection instructions, the tool contract and example answers. The server runs as part of the WerkCV web app; there is nothing to install or self-host. Every successful answer is returned as structuredContent and as the same JSON in a text block, and follows the published outputSchema of each tool. Each answer includes nextStep, a suggested follow-up. See examples/ for full answers for a fictional CV. Input for all tools: cv_text (200–25,000 characters), optional locale (nl or en, detected when omitted); match_vacancy and open_in_editor also take vacancy_text (120–18,000 characters).

README

WerkCV – Dutch CV check (MCP server)

A hosted, remote Model Context Protocol server that grades a CV for the Dutch job market, compares it with a vacancy, and opens it in the WerkCV editor.

This repository documents the hosted server: connection instructions, the tool contract and example answers. The server runs as part of the WerkCV web app; there is nothing to install or self-host.

Tools

Tool What it does Notes
check_cv Grades a CV 0–100 (plus a 1–10 grade) on content, readability for application systems (ATS), contact basics and Dutch conventions. Returns the three fixes to make first, each with the section, the place and an exact quote from the CV, plus stats such as weak bullet openers and clichés. Free, no AI, nothing stored.
match_vacancy Compares a CV with one vacancy, requirement by requirement (must / nice, match / partial / missing), with quotes from both texts, missing ATS keywords and the fixes to make first. The score is computed from the requirement list. Uses AI, rate-limited, nothing stored. Never suggests claiming experience the user does not have.
open_in_editor Returns a single-use link that opens the CV (and optionally the vacancy) in the WerkCV editor, no account needed. The text is kept for at most 60 minutes and deleted when the link is first opened.

Every successful answer is returned as structuredContent and as the same JSON in a text block, and follows the published outputSchema of each tool. Each answer includes nextStep, a suggested follow-up. See examples/ for full answers for a fictional CV.

Input for all tools: cv_text (200–25,000 characters), optional locale (nl or en, detected when omitted); match_vacancy and open_in_editor also take vacancy_text (120–18,000 characters). Remove BSN, ID and bank numbers from the CV before sending it.

Connect

Claude (claude.ai / desktop): add it from the Connectors Directory (“WerkCV CV-check”), or Settings → Connectors → Add custom connector → https://werkcv.nl/api/mcp.

Claude Code:

claude mcp add --transport http werkcv https://werkcv.nl/api/mcp

Cursor (.cursor/mcp.json or ~/.cursor/mcp.json):

{
  "mcpServers": {
    "werkcv": { "url": "https://werkcv.nl/api/mcp" }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "werkcv": { "type": "http", "url": "https://werkcv.nl/api/mcp" }
  }
}

Any other MCP client that supports remote Streamable HTTP servers: use the endpoint above, no headers needed.

Try it

Check my CV against Dutch norms: (paste your CV)

Does my CV fit this vacancy? (paste CV and vacancy)

Limits

Per IP address: check_cv 30 per hour, match_vacancy 8 per hour and 20 per day, open_in_editor 5 per hour. When a limit is reached the tool returns a clear “limit reached” message.

Privacy and cost

  • The check and the vacancy comparison store nothing. The vacancy comparison sends the text to OpenAI for the analysis.
  • Only open_in_editor keeps the text, for at most 60 minutes, and deletes it when the link is first opened.
  • Only counts are recorded (tool, locale, outcome), never the CV or vacancy text.
  • The tools are free. In the WerkCV editor, building and previewing a CV is free; downloading the PDF costs €7.95 once, with no subscription.
  • Privacy policy: https://werkcv.nl/en/privacy

Support

[email protected]

License

The documentation and examples in this repository are MIT licensed. The hosted server is operated by WerkCV.

View this README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide

Configuration

{ "mcpServers": { "werkcv": { "url": "https://werkcv.nl/api/mcp" } } }