100Hires MCP Server

Official Model Context Protocol server for 100Hires — the applicant tracking system for recruiting teams.

Exposes the full 100Hires API v2 as 130 MCP tools, enabling AI assistants to manage candidates, jobs, applications, interviews, messages, and more.

Prerequisites

Get your API key at Settings > Integrations > API.

Setup

Claude Code

Run in your terminal:

claude mcp add 100hires \
  -e API_KEY=your-api-key \
  -- npx -y @100hires/mcp-server

Claude Code (manual)

Add to your project's .mcp.json:

{
  "mcpServers": {
    "100hires": {
      "command": "npx",
      "args": ["-y", "@100hires/mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Open Settings > MCP and add:

{
  "mcpServers": {
    "100hires": {
      "command": "npx",
      "args": ["-y", "@100hires/mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Windsurf

Open Settings > MCP and add:

{
  "mcpServers": {
    "100hires": {
      "command": "npx",
      "args": ["-y", "@100hires/mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "100hires": {
      "command": "npx",
      "args": ["-y", "@100hires/mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Tools (130)

Candidates (18 tools)

| Tool | Description | |------|-------------| | hires_list_candidates | List candidates with filters (job, stage, email, search, linkedin, timestamps) | | hires_create_candidate | Create a new candidate with profile data | | hires_get_candidate | Get candidate by ID or alias | | hires_update_candidate | Update candidate fields | | hires_delete_candidate | Delete a candidate | | hires_list_candidate_tags | List candidate's tags | | hires_add_candidate_tags | Attach tags to a candidate | | hires_remove_candidate_tag | Remove a specific tag | | hires_batch_add_tags | Bulk add tags to multiple candidates | | hires_batch_remove_tags | Bulk remove tags from multiple candidates | | hires_list_candidate_files | List candidate attachments | | hires_upload_candidate_file | Upload a file (base64) | | hires_get_candidate_resume | Get resume with optional text content | | hires_list_candidate_activities | Get candidate timeline | | hires_disqualify_candidate | Reject all active applications | | hires_list_candidate_interviews | List candidate's interviews | | hires_list_candidate_messages | List email history | | hires_send_candidate_message | Schedule an email |

Applications (18 tools)

| Tool | Description | |------|-------------| | hires_list_applications | List applications with filters (candidate, job, stage, status, AI score) | | hires_create_application | Link candidate to job | | hires_get_application | Get application details | | hires_update_application | Update application fields | | hires_delete_application | Delete an application | | hires_move_application | Move to a specific pipeline stage | | hires_advance_application | Advance to the next stage | | hires_hire_application | Mark as hired | | hires_reject_application | Reject with optional reason | | hires_unreject_application | Undo rejection | | hires_transfer_application | Transfer to another job | | hires_get_ai_score | Get AI scoring breakdown | | hires_list_application_attachments | List attachments | | hires_upload_application_attachment | Upload attachment | | hires_list_application_evaluations | List filled evaluations | | hires_create_interview | Schedule interview for application | | hires_batch_move_applications | Bulk move to stage | | hires_batch_reject_applications | Bulk reject |

Jobs (17 tools)

| Tool | Description | |------|-------------| | hires_list_jobs | List jobs with filters | | hires_create_job | Create a job | | hires_get_job | Get job by ID or alias | | hires_update_job | Update job fields | | hires_delete_job | Delete a job | | hires_set_job_status | Change status (publish/archive/close) | | hires_list_job_boards | List available job boards | | hires_publish_to_job_board | Publish to a board | | hires_remove_from_job_board | Remove from a board | | hires_batch_job_boards | Get batch job board status | | hires_batch_publish_to_boards | Publish to multiple boards | | hires_batch_remove_from_boards | Remove from multiple boards | | hires_list_hiring_team | List hiring team members | | hires_add_hiring_team_member | Add hiring team member | | hires_list_job_webhooks | List job webhooks | | hires_create_job_webhook | Register a job webhook | | hires_delete_job_webhook | Delete a job webhook |

Messages (6 tools)

| Tool | Description | |------|-------------| | hires_list_messages | List messages by mail account | | hires_get_message | Get a scheduled message | | hires_update_message | Full update of scheduled message | | hires_patch_message | Partial update of scheduled message | | hires_delete_message | Cancel a scheduled message | | hires_batch_create_messages | Batch schedule up to 100 messages |

Notification Messages (4 tools)

| Tool | Description | |------|-------------| | hires_get_notification_message | Get a notification email (e.g. rejection) by ID | | hires_update_notification_message | Update subject, body, reschedule send time | | hires_delete_notification_message | Cancel a scheduled notification | | hires_cancel_all_notification_messages | Cancel all scheduled notifications for a candidate |

Interviews (2 tools)

| Tool | Description | |------|-------------| | hires_list_interviews | List interviews with filters | | hires_get_interview | Get interview details |

Notes (5 tools)

| Tool | Description | |------|-------------| | hires_list_notes | List candidate notes | | hires_create_note | Create a note | | hires_get_note | Get note details | | hires_update_note | Update a note | | hires_delete_note | Delete a note |

Evaluations (1 tool)

| Tool | Description | |------|-------------| | hires_get_evaluation | Get evaluation form with answers |

Forms (6 tools)

| Tool | Description | |------|-------------| | hires_list_forms | List application forms | | hires_create_form | Create an application form | | hires_get_form | Get form definition | | hires_update_form | Update a form | | hires_delete_form | Delete a form | | hires_update_form_question | Update question visibility on a form |

Email Templates (5 tools)

| Tool | Description | |------|-------------| | hires_list_email_templates | List email templates | | hires_create_email_template | Create a template | | hires_get_email_template | Get template details | | hires_update_email_template | Update a template | | hires_delete_email_template | Delete a template |

Nurture Campaigns (5 tools)

| Tool | Description | |------|-------------| | hires_list_nurture_campaigns | List campaigns | | hires_create_nurture_campaign | Create multi-step campaign | | hires_get_nurture_campaign | Get campaign details | | hires_update_nurture_campaign | Update a campaign | | hires_delete_nurture_campaign | Delete a campaign |

Users (3 tools)

| Tool | Description | |------|-------------| | hires_list_users | List company users | | hires_get_user | Get user details | | hires_list_user_mail_accounts | List user's mail accounts |

Companies (11 tools)

| Tool | Description | |------|-------------| | hires_list_companies | List accessible companies | | hires_create_company | Create a company | | hires_get_company | Get company details | | hires_update_company | Update company | | hires_delete_company | Delete a company | | hires_list_company_mail_accounts | List company mail accounts | | hires_list_company_id_mail_accounts | List mail accounts for specific company | | hires_restore_company | Restore deleted company | | hires_list_webhooks | List company webhooks | | hires_create_webhook | Register a webhook | | hires_delete_webhook | Delete a webhook |

Taxonomy & Reference (23 tools)

| Tool | Description | |------|-------------| | hires_list_sources | Candidate sources (LinkedIn, Referral, etc.) | | hires_list_origins | Candidate origins | | hires_list_rejection_reasons | Rejection reason dictionary | | hires_list_statuses | Job/application statuses | | hires_list_departments | Company departments | | hires_list_categories | Job categories | | hires_list_education_levels | Education levels | | hires_list_experience_levels | Experience levels | | hires_list_employment_types | Employment types | | hires_list_boards | Available job boards | | hires_list_tags | All tags | | hires_list_workflows | Hiring workflows | | hires_list_workflow_stages | All pipeline stages | | hires_get_workflow_stages | Stages for specific workflow | | hires_list_questions | Reusable questions | | hires_create_question | Create a question | | hires_get_question | Get question details | | hires_update_question | Update a question | | hires_delete_question | Delete a question | | hires_list_question_types | Available question types | | hires_list_template_placeholders | Email template placeholders | | hires_prepare_template_placeholders | Render placeholders | | hires_get_billing | Check account pricing/features |

Attachments (2 tools)

| Tool | Description | |------|-------------| | hires_download_attachment | Download an attachment by absolute URL (resume, candidate file, application file, mail attachment, call recording). Returns base64-encoded bytes + metadata. 25 MB limit. | | hires_upload_attachment | Upload a file as voicemail/candidate/application attachment. Voicemail upload produces a uuid usable as attachment_uuid in nurture-campaign voicemail steps. |

Feedback (1 tool)

| Tool | Description | |------|-------------| | hires_submit_feedback | Submit structured API feedback about issues or improvements |

Career Site (3 tools, public)

| Tool | Description | |------|-------------| | hires_list_career_jobs | Public job openings | | hires_get_career_job | Get public job details | | hires_submit_career_application | Submit application via career site |

Career site tools use company_slug instead of API key authentication.

API Documentation

• 100Hires API Docs
• OpenAPI Spec

License

MIT