MCP Server — KlevrCV

The @klevercv/mcp-server npm package lets AI agents generate tailored resumes via Claude Desktop, Cursor, Cline, or any stdio MCP client — no browser automation required.

Quick Start

KLEVERCV_API_KEY=kv_live_... npx -y @klevercv/mcp-server

Get your API key from Settings. On startup the server is silent; missing API key exits with an error on stderr.

Installation

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "klevercv": {
      "command": "npx",
      "args": ["-y", "@klevercv/mcp-server"],
      "env": {
        "KLEVERCV_API_KEY": "kv_live_your_key_here"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "klevercv": {
      "command": "npx",
      "args": ["-y", "@klevercv/mcp-server"],
      "env": {
        "KLEVERCV_API_KEY": "kv_live_your_key_here"
      }
    }
  }
}

Cline

Open the Cline sidebar → MCP Servers → Configure, then add to cline_mcp_settings.json:

{
  "mcpServers": {
    "klevercv": {
      "command": "npx",
      "args": ["-y", "@klevercv/mcp-server"],
      "env": {
        "KLEVERCV_API_KEY": "kv_live_your_key_here"
      }
    }
  }
}

Other MCP Clients

Any client that supports stdio MCP servers with env vars uses the same shape. Set KLEVERCV_API_KEY in the env block and use npx -y @klevercv/mcp-server as the command.

Tools

`klevercv_generate_resume`

Submit a resume generation job. Returns immediately with a generation_id — does not block while the PDF is generated.

Parameter	Type	Required	Description
`job_description`	string	Yes	Full job description text
`job_title`	string	Yes	Job title (e.g. "Senior Engineer")
`company_name`	string	Yes	Company name (e.g. "Acme Corp")
`template_id`	string	No	Template ID from `klevercv_list_templates`

Example response:

generation_id: abc123
Use klevercv_get_generation_status to poll for completion.

`klevercv_get_generation_status`

Poll a generation job. Waits up to timeout_seconds for completion, then returns a signed download URL.

Parameter	Type	Required	Description
`generation_id`	string	Yes	ID from `klevercv_generate_resume`
`timeout_seconds`	number	No	Max wait time (default: 120)

Example response (complete):

status: complete
download_url: https://...r2.cloudflarestorage.com/...?X-Amz-Expires=3600

Example response (timeout):

isError: true
GENERATION_TIMEOUT: Generation did not complete within 120 seconds. Try polling again.

`klevercv_list_templates`

List available resume templates with stable IDs.

No parameters.

Example response:

Templates (3):
- classic: Classic — Clean single-column format
- modern: Modern — Two-column with accent color
- minimal: Minimal — Compact single-page layout

`klevercv_list_resumes`

List past generated resumes with pagination.

Parameter	Type	Required	Description
`limit`	number	No	Results per page (default: 10)
`offset`	number	No	Pagination offset (default: 0)

`klevercv_get_account_info`

Return credits remaining, email, and account plan.

No parameters.

Example response:

Email: user@example.com
Plan: starter
Credits remaining: 8
Total generations: 12

Error Handling

All business errors return isError: true with an error code so the agent can take corrective action without crashing.

Error Code	Meaning	Agent Action
`AUTH_FAILED`	API key invalid, expired, or missing	Stop and ask user to check their API key
`INSUFFICIENT_CREDITS`	No credits left	Call `klevercv_get_account_info` and inform user
`RATE_LIMITED`	Too many requests; includes `retry_after` seconds	Wait and retry
`INVALID_TEMPLATE_ID`	Template ID not recognized	Call `klevercv_list_templates` to get valid IDs
`GENERATION_TIMEOUT`	PDF not ready within `timeout_seconds`	Retry `klevercv_get_generation_status` with the same `generation_id`
`RESUME_NOT_FOUND`	Resume ID doesn't exist or belongs to another user	Verify ID with `klevercv_list_resumes`
`GENERATION_NOT_FOUND`	`generation_id` not found	Verify ID from `klevercv_generate_resume` response
`NETWORK_ERROR`	Network or API connectivity issue	Retry after a short delay

Requirements

Node.js >= 18
A KlevrCV API key — get one from Settings.