# @snokam/mcp-cvpartner

MCP (Model Context Protocol) server for CVPartner CV management. Enables AI agents to search and retrieve consultant CVs.

## Features

- 🔍 **Search CVs** by name, skills, or experience
- 👥 **List consultants** with their profiles
- 📄 **Get full CV content** in Norwegian or English
- 🛠️ **Find consultants by skill** (React, Python, Azure, etc.)

## Installation

```bash
cd mcp/@snokam/cvpartner
pnpm install
pnpm build
```

## Configuration

```env
CVPARTNER_API_KEY=your_api_key
CVPARTNER_ORG=snokam  # Optional, defaults to "snokam"
```

## Usage with mcporter

Add to your mcporter config:

```json
{
  "mcpServers": {
    "cvpartner": {
      "command": "node",
      "args": ["/path/to/mcp/@snokam/cvpartner/dist/index.js"],
      "env": {
        "CVPARTNER_ORG": "snokam"
      }
    }
  }
}
```

API key should be set in environment or fetched from 1Password.

## Available Tools

| Tool                        | Description                           |
| --------------------------- | ------------------------------------- |
| `list_users`                | List all consultants                  |
| `search_cvs`                | Search CVs by any text                |
| `get_user`                  | Get user profile details              |
| `get_cv`                    | Get full CV content                   |
| `find_consultants_by_skill` | Find consultants with specific skills |

## API Documentation

CVPartner API: https://docs.cvpartner.com/
