# formacv

Gives Claude Code the FormaCV toolset: fit a CV into an agency template, tailor it to a vacancy, strip personal details, write it back to the ATS.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 36
- Author: Rocketech-Software-Development
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Rocketech-Software-Development/formacv-mcp
- Updated: 2026-05-06
- HTML: https://affpapa.org/en/nevibecode/mcp/formacv

## What it does

Eight tools come with it: `format_cv`, `tailor_cv`, `anonymize_cv`, `push_to_ats`, `bulk_format`, `list_templates`, `list_integrations` and `get_job_status`. Their JSON contracts match FormaCV's HTTPS endpoints, so a run you did in chat can be replayed from a script or a pipeline.

Slow PDF rendering does not hold the connection open. Ask `get_job_status` for progress. `list_templates` and `list_integrations` exist so the model stops inventing template and integration IDs. Two variables do the wiring: `FORMACV_SERVER_URL` for the origin of your own deployment, `FORMACV_API_KEY` for the bearer token issued at onboarding. The process starts under `npx`, so Node.js 18+ has to be present.

The value `demo` only works against demo origins. Point the server at a production host with `demo` in the key and every call comes back rejected, so get the real token first. Anonymization flows write an audit log. Tenant data sits on isolated infrastructure with AES-256 at rest and TLS in transit, and on-premises deployment is available.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FORMACV_API_KEY`, `FORMACV_SERVER_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add formacv -e FORMACV_API_KEY=<FORMACV_API_KEY> -e FORMACV_SERVER_URL=<FORMACV_SERVER_URL> -- npx -y @formacv/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add formacv --env FORMACV_API_KEY=<FORMACV_API_KEY> --env FORMACV_SERVER_URL=<FORMACV_SERVER_URL> -- npx -y @formacv/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "formacv": {
            "command": "npx",
            "args": [
                "-y",
                "@formacv/mcp"
            ],
            "env": {
                "FORMACV_API_KEY": "<FORMACV_API_KEY>",
                "FORMACV_SERVER_URL": "<FORMACV_SERVER_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "formacv": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@formacv/mcp"
            ],
            "env": {
                "FORMACV_API_KEY": "<FORMACV_API_KEY>",
                "FORMACV_SERVER_URL": "<FORMACV_SERVER_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FORMACV_API_KEY=<FORMACV_API_KEY> -e FORMACV_SERVER_URL=<FORMACV_SERVER_URL> formacv npx -y @formacv/mcp
```
Replace <…> with your own values

## When to use it
- render a candidate CV into the agency template
- rewrite a CV against a specific vacancy
- remove name, photo and contacts for a blind submission
- send the finished file back to a Bullhorn candidate record
- format a stack of CVs in a single call

## Example prompts
- Format `cv.docx` with the `brand-blue` template and give me the finished file
- Anonymize this CV for the client and show me the audit log
- Run `bulk_format` over the attachments on this vacancy, then push the results to Bullhorn

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md