@doverhq/mcp/README.md

Dover MCP server for accessing Dover job data

# Dover MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with access to Dover job data.

## Installation

Customers can use this MCP server without installation by configuring Claude Desktop:

```json
{
  "mcpServers": {
    "dover": {
      "command": "npx",
      "args": ["-y", "@doverhq/mcp@latest"],
      "env": {
        "DOVER_API_KEY": "your-dover-api-key-here"
      }
    }
  }
}
```

## Getting Your Dover API Key

1. Log into your Dover account
2. Go to Settings & Members > API Key
3. Copy your API key

## Available Tools

### `list_jobs`

Lists all active, non-private jobs from your Dover account.

**Example usage in Claude:**
"Show me all my active jobs in Dover"

**Response format:**
```json
{
  "total_jobs": 3,
  "jobs": [
    {
      "id": "job-uuid",
      "title": "Senior Software Engineer", 
      "stages": ["Initial Screening", "Technical Interview", "Final Interview"],
      "stage_count": 3
    }
  ]
}
```

### `add_candidate`

Add a candidate to a Dover job without sending email outreach. This directly adds the candidate to your ATS.

**Example usage in Claude:**
"Add John Doe to my Senior Engineer job with email john@example.com"

**Required parameters:**
- `job_id`: UUID of the job (get from list_jobs)
- `first_name`: Candidate's first name
- `last_name`: Candidate's last name  
- `pipeline_stage`: Stage name (e.g., "Initial Screening")

**Optional parameters:**
- `email`: Candidate's email address
- `linkedin_url`: LinkedIn profile URL
- `resume_url`: URL to candidate's resume (PDF/DOC/DOCX/TXT)
- `notes`: Additional comments (max 5000 chars)

### `source_candidate`

Source a candidate with personalized email outreach. This is a two-step process with email preview and confirmation.

**Example usage in Claude:**
1. "Source this candidate from LinkedIn for my job" (shows preview)
2. "Send the email" (actually sends after confirmation)

**Step 1 - Preview Mode (default):**
```json
{
  "job_id": "job-uuid",
  "first_name": "John",
  "last_name": "Doe", 
  "linkedin_url": "https://linkedin.com/in/johndoe"
}
```

**Step 2 - Send Mode:**
```json
{
  "job_id": "job-uuid",
  "first_name": "John", 
  "last_name": "Doe",
  "linkedin_url": "https://linkedin.com/in/johndoe",
  "send_email": true
}
```

**Key Features:**
- **Automatic email discovery**: Finds candidate emails if not provided
- **AI-powered personalization**: Generates personalized outreach content
- **Email preview**: Shows generated email before sending
- **Custom overrides**: Can customize subject and message
- **User confirmation**: Requires explicit confirmation before sending

## Configuration Locations

### macOS
`~/Library/Application Support/Claude/claude_desktop_config.json`

### Windows  
`%APPDATA%/Claude/claude_desktop_config.json`

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Test locally
DOVER_API_KEY=your-key npm run dev
```