> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# SmartRecruiters

**Authentication:** API key. See [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) for setup.

## Sample use cases

* List all open jobs in the Engineering department and show applicant counts per role.
* Find candidates who applied in the last 7 days and haven't been contacted yet.
* Pull all active job postings and check which ones have no candidates in the pipeline.

## Available Tools

#### list_applications

List candidates (applications) for a specific job in SmartRecruiters. Returns candidates with their application status

#### list_candidates

List candidates in SmartRecruiters with optional text search and cursor pagination. Filter by job ID or application status

#### get_candidate

Get full profile for a SmartRecruiters candidate by ID, including contact info, tags, and primary job assignment

#### create_candidate

Create a new candidate in SmartRecruiters and assign them to a job. Requires job_id, first_name, and last_name

#### update_candidate

Update a candidate's profile in SmartRecruiters. All fields are optional — only provide what you want to change

#### list_departments

List all departments configured in SmartRecruiters. Returns department IDs and labels

#### list_jobs

List jobs in SmartRecruiters with optional filtering and cursor pagination. Filter by status, department, or text search

#### get_job

Get full details for a SmartRecruiters job by ID, including location, status, hiring team links, and posting info

#### list_users

List users in SmartRecruiters with offset-based pagination. Filter by role (ADMINISTRATOR, REGULAR, RESTRICTED)

#### get_user

Get full details for a SmartRecruiters user by ID, including name, email, role, and active status