MCP Server Documentation

CVpop MCP Server

CVpop exposes an MCP server that lets compatible AI assistants create professional CV previews, customize them, 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. CV content remains in the conversation and preview until the user explicitly chooses to continue in CVpop.

Setup

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

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

Tools

`createCvPreview` — Create or update a CV preview

Renders the complete CV in the interactive app UI. The assistant calls it again with the full CV after every requested content change. The preview is not persisted by this tool.

Required parameter: cv, a complete structured CV object. The response includes cvLight and indicates whether temporary contact placeholders were added.

`createCvClaim` — Continue in CVpop

Transfers the CV selected in the app UI to CVpop and creates a temporary claim URL. This tool is available to the app UI and is called only after an explicit user action, never as an automatic conversational follow-up.

Required parameter: cv. The optional style parameter contains the layout choices made in the preview UI.

Claim Flow

The assistant calls createCvPreview with the complete CV.
The user reviews and customizes the CV in the app UI.
The user explicitly chooses to continue in CVpop.
The app UI calls createCvClaim.
The server stores the CV and returns a temporary 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.

Endpoint compatibility

https://mcp.cvpop.com/mcp is the canonical endpoint for new configurations. The legacy /mcp-v2 path temporarily exposes the same server contract for already-approved clients and should not be used for new integrations.

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;profile=mcp-app
Production domain: https://mcp.cvpop.com

Error Handling

Tool inputs and outputs are validated against their published schemas. Claim creation can fail if a unique CV identifier or claim token cannot be created, or if storage is unavailable.

Privacy and Data Retention

CV previews are not stored by createCvPreview. The CV is stored only when the user explicitly continues to CVpop and createCvClaim creates a temporary claim.

Once a user claims a CV, it is associated with that user's CVpop account.