@aicandidatehub/mcp

An MCP server for CandidateHub — providing AI agents with tools to manage profiles, resumes, jobs, and compensation data.

Features

• Profile Management — fetch and manage your candidate profile
• Resume Ingestion — import resumes from text, URLs, or file uploads
• Job Tracking — import and track job opportunities
• Job Analysis — analyze fit between your profile and job postings
• CV Generation — generate role-customized resumes
• Cover Letters — generate tailored cover letters
• Compensation Intelligence — lookup salary and benefits benchmarks

Installation

Prerequisites

• Node.js 20 or later
• A CandidateHub Personal Access Token (create at https://aicandidatehub.com/account/mcp-tokens)

Claude Desktop

1. Create a Personal Access Token at https://aicandidatehub.com/account/mcp-tokens
2. Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "aicandidatehub": {
      "command": "npx",
      "args": ["-y", "@aicandidatehub/mcp"],
      "env": {
        "CANDIDATEHUB_TOKEN": "chmcp_your_token_here"
      }
    }
  }
}

3. Restart Claude Desktop. The MCP server will connect automatically.

Claude Code

1. Create a Personal Access Token at https://aicandidatehub.com/account/mcp-tokens
2. Set your environment:

export CANDIDATEHUB_TOKEN=chmcp_your_token_here

3. Start Claude Code with the MCP server:

npx @aicandidatehub/mcp

Cursor

1. Create a Personal Access Token at https://aicandidatehub.com/account/mcp-tokens
2. Edit ~/.cursor/mcp_config.json:

{
  "mcpServers": {
    "aicandidatehub": {
      "command": "npx",
      "args": ["-y", "@aicandidatehub/mcp"],
      "env": {
        "CANDIDATEHUB_TOKEN": "chmcp_your_token_here"
      }
    }
  }
}

3. Restart Cursor.

OpenClaw

1. Create a Personal Access Token at https://aicandidatehub.com/account/mcp-tokens
2. Configure in your OpenClaw settings:

{
  "servers": {
    "aicandidatehub": {
      "command": "npx -y @aicandidatehub/mcp",
      "env": {
        "CANDIDATEHUB_TOKEN": "chmcp_your_token_here"
      }
    }
  }
}

Codex

Install and run directly:

npm install -g @aicandidatehub/mcp
export CANDIDATEHUB_TOKEN=chmcp_your_token_here
aicandidatehub-mcp

Goose

1. Create a Personal Access Token at https://aicandidatehub.com/account/mcp-tokens
2. Edit your Goose config:

mcpServers:
  aicandidatehub:
    command: npx
    args:
      - '-y'
      - '@aicandidatehub/mcp'
    env:
      CANDIDATEHUB_TOKEN: chmcp_your_token_here

3. Restart Goose.

Available Tools

Profile & Data

• get_profile — Fetch your candidate profile
• import_resume_from_text — Import a resume from plain text
• import_resume_from_url — Import a resume from a URL or LinkedIn profile
• import_resume_from_source — Import from URL or base64-encoded content
• import_job_from_url — Import a job from a URL

Job & Career

• list_jobs — List tracked job opportunities
• get_job — Get details of a specific job
• analyze_job_fit — Analyze how well your profile matches a job
• rewrite_cv_for_job — Generate a role-customized resume
• generate_cover_letter — Generate a tailored cover letter

Compensation

• analyze_compensation — Analyze compensation for a job or role
• get_compensation_for_role — Lookup salary benchmarks for a role

Account

• signup_url — Generate a signup link (no authentication required)

Environment Variables

• CANDIDATEHUB_TOKEN — Your Personal Access Token (required)
• CANDIDATEHUB_API_BASE — API endpoint (defaults to https://www.aicandidatehub.com). The apex (aicandidatehub.com) is intentionally not the default: Cloudflare 301-redirects apex → www, and 301 drops POST bodies → PAT exchange fails with 405. If you must use the apex, configure Cloudflare to issue 308 (or set this variable explicitly).
• MCP_CLIENT — Client identifier for tracking (defaults to 'unknown')

Development

npm install
npm run build
npm test
npm run test:integration  # Requires MCP_INTEGRATION=1 and MCP_TEST_PAT
npm run dev              # Watch mode

License

Proprietary — CandidateHub