How do I use 100Hires MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@100Hires MCP Server list candidates for the senior developer position" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

License

MIT

100Hires MCP Server

100Hires MCP Server

Prerequisites

Setup

Claude Code

Claude Code (manual)

Cursor

Windsurf

VS Code (Copilot)

Tools (130)

Candidates (18 tools)

Applications (18 tools)

Jobs (17 tools)

Messages (6 tools)

Notification Messages (4 tools)

Interviews (2 tools)

Notes (5 tools)

Evaluations (1 tool)

Forms (6 tools)

Email Templates (5 tools)

Nurture Campaigns (5 tools)

Users (3 tools)

Companies (11 tools)

Taxonomy & Reference (23 tools)

Attachments (2 tools)

Feedback (1 tool)

Career Site (3 tools, public)

API Documentation

License

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API