# CVforge MCP Server

> Official [Model Context Protocol](https://modelcontextprotocol.io) server for **[CVforge](https://cvforge.co)** —
> AI résumé (CV) optimization built to beat Applicant Tracking Systems (ATS).

CVforge lets AI assistants and automation tools optimize résumés on the user's behalf: upload a CV,
tailor it to a job offer, read the **ATS match score (0–100)**, and download the optimized PDF — all
through a standard MCP interface.

- 🌐 Website: https://cvforge.co
- 📖 Developer docs: https://cvforge.co/developers
- 🤖 `llms.txt`: https://cvforge.co/llms.txt
- 🔌 MCP endpoint: `https://api.cvforge.co/mcp`

## Why CVforge

- **Real GDPR anonymization** — personal data is stripped *before* any AI processing, then re-injected locally (not after).
- **Precise 0–100 ATS match score** based on semantic analysis of the job offer vs your résumé.
- **Native multilingual** support: FR, EN, ES, DE, IT, PT.
- **Web, Android & iOS** apps.

## Transport & Auth

| | |
|---|---|
| Protocol | MCP `2025-03-26`, JSON-RPC 2.0 over HTTP |
| Endpoint | `https://api.cvforge.co/mcp` |
| Auth | Bearer token — Personal Access Token (`mcp_pat_…`) or OAuth2 (Authorization Code + PKCE) |
| Requirement | CVforge **Expert** plan |
| OAuth2 discovery | `https://api.cvforge.co/.well-known/oauth-authorization-server` |
| MCP manifest | `https://api.cvforge.co/.well-known/mcp.json` |

## Tools

| Tool | Description |
|---|---|
| `get_profile` | Get the connected user's profile and subscription |
| `get_credits` | Get credit balances (subscription, paid, free) |
| `list_cvs` | List all uploaded CV profiles |
| `get_cv` | Get a specific CV profile by ID |
| `upload_cv` | Upload a CV (PDF or DOCX, base64) → returns the parsed profile ID |
| `list_generations` | List AI-optimized CVs with ATS scores and job-offer info |
| `get_generation` | Get a specific optimized CV generation |
| `download_generation` | Get a signed URL (15 min) to download an optimized CV PDF |

## Usage with an MCP client

Most desktop MCP clients (e.g. Claude Desktop) connect to remote HTTP MCP servers via
[`mcp-remote`](https://www.npmjs.com/package/mcp-remote):

```json
{
  "mcpServers": {
    "cvforge": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.cvforge.co/mcp"]
    }
  }
}
```

You will be guided through OAuth2 authorization on first use. A Personal Access Token can also be
created from your CVforge account (Expert plan) and used as a Bearer token.

### Example prompts

- "List my optimized CVs on CVforge"
- "What's the ATS score of my last CV?"
- "Upload my résumé to CVforge"
- "Download my latest optimized CV"

## Links

- CVforge — https://cvforge.co
- Pricing (Expert plan) — https://cvforge.co/pricing
- Developer documentation — https://cvforge.co/developers

## License

Documentation © CVforge. The CVforge MCP server is a hosted service operated by CVforge.