MCP Server Documentation

CVpop MCP Server

CVpop exposes an MCP server that lets compatible AI assistants create professional CVs, customize draft styling, and hand users off to CVpop through a secure claim URL.

MCP endpoint Open CVpop

Server name

CVpop

Protocol

MCP, Streamable HTTP

Endpoint

https://mcp.cvpop.com/mcp

Overview

The CVpop MCP server is designed for ChatGPT, Claude Desktop, and other MCP-compatible clients. It creates structured CV drafts and returns a claim URL that opens the CV in CVpop Web.

Setup

Configure the CVpop MCP server in your MCP client using the Streamable HTTP endpoint.

{
  "mcpServers": {
    "cvpop": {
      "url": "https://mcp.cvpop.com/mcp"
    }
  }
}

Tools

`createCv` — Create a new CV

Creates a professional CV based on a user's first name, last name, job title, and preferred language. Each call creates a new CV draft and a new claim URL.

Parameter	Type	Required	Description
`userFirstName`	string	Yes	User's first name.
`userLastName`	string	Yes	User's last name.
`userJobTitle`	string	Yes	Target job title used to tailor the CV content.
`userLanguage`	string	Yes	Supported language code.

Supported languages: en, it, bg, cs, da, de, el, es, et, fi, fr, hr, hu, is, lt, lv, mk, mt, nl, nb, pl, pt, ro, sl, sk, sv, tr, zh, ja, ar.

Returns: claimUrl, expiresAt, and the generated CV object.

`editCvColor` — Change CV theme color

Updates the accent color of an existing MCP-created draft CV. This tool works only before the claim URL is opened and the CV is associated with a CVpop account.

Parameters: cvId, hexColor. Example color: #247BA0.

`editCvModel` — Change CV layout

Changes the layout template of an MCP-created draft CV. Supported layout categories are classic, creative, simple, and dynamic.

Claimed CVs cannot be edited through MCP tools. Ask the user to continue editing inside CVpop.

`editCvFont` — Change CV font

Updates the base font used in an MCP-created draft CV. Supported fonts include Alegreya Sans, Barlow, Montserrat, Roboto, Poppins, Raleway, and others.

Claim Flow

The MCP client calls createCv.
The server creates a CV draft and a claim record.
The server returns a claim URL, for example https://cvpop.com/claim-cv/{token}.
The user opens the claim URL. Desktop users continue in CVpop Web; mobile users can open CVpop or install it from the store.
If the user is not signed in, CVpop creates an anonymous account before claiming.
The CV is associated with the user account and the claim becomes CLAIMED.
Further editing happens in CVpop, not through MCP tools.

Draft Editing Rules

State	MCP editing	Description
`READY`	Allowed	The claim is pending, not expired, and the CV is not associated with a user.
`CLAIMED`	Blocked	The CV belongs to a CVpop account and must be edited inside CVpop.
`EXPIRED`	Blocked	The claim expired and the draft may be cleaned up automatically.

UI Resource

The server exposes an optional UI resource for MCP clients that support inline widgets.

Resource name: cv-widget
URI: ui://widget/index.html
MIME type: text/html+skybridge
Production domain: https://mcp.cvpop.com

Error Handling

Tools return structured responses with a status field. On failure, responses include errorCode and errorMessage.

editCv/cv-already-claimed: the CV has already been claimed in CVpop.
editCv/claim-expired: the claim has expired.
editCv/claim-not-found: no claim record was found for the CV.
editCv/claim-not-editable: the claim is not in an editable draft state.
getCv/cv-not-found: the CV identifier does not exist.

Privacy and Data Retention

CVs created through the MCP server are stored as draft CVs until they are claimed or expire. Claim URLs are temporary. Expired unclaimed drafts may be removed automatically.

Once a user claims a CV, it is associated with that user's CVpop account. MCP tools can no longer edit it.