Werkcv MCP Server

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.

• Endpoint: https://werkcv.nl/api/mcp
• Transport: Streamable HTTP (stateless)
• Authentication: none
• Registry name: nl.werkcv/cv-check (official MCP Registry)
• Docs: 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.

Tools

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

contact@werkcv.nl

License

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