Connect your AI Agents to SmartRecruiters in minutes
Available tools
list_applications
List candidates (applications) for a specific job in SmartRecruiters. Returns candidates with their application status in primaryAssignment. Use list_jobs to find valid job IDs. Supports cursor pagination.
list_candidates
List candidates in SmartRecruiters with optional text search and cursor pagination. Filter by job ID or application status. Returns candidates array and page_info with cursor for the next page.
get_candidate
Get full profile for a SmartRecruiters candidate by ID, including contact info, tags, and primary job assignment. Use list_candidates to find valid candidate IDs.
create_candidate
Create a new candidate in SmartRecruiters and assign them to a job. Requires job_id, first_name, and last_name. Use list_jobs to find valid job IDs. Returns the created candidate record.
update_candidate
Update a candidate's profile in SmartRecruiters. All fields are optional — only provide what you want to change. Use list_candidates to find valid candidate IDs.
list_departments
List all departments configured in SmartRecruiters. Returns department IDs and labels, which can be used to filter jobs by department.
list_jobs
List jobs in SmartRecruiters with optional filtering and cursor pagination. Filter by status, department, text query, or date. Returns jobs array and page_info with cursor for the next page.
get_job
Get full details for a SmartRecruiters job by ID, including location, status, hiring team links, and posting info. Use list_jobs to find valid job IDs.
list_users
List users in SmartRecruiters with offset-based pagination. Filter by role (ADMINISTRATOR, REGULAR, RESTRICTED, EMPLOYEE) or active status. Returns users array and page_info with next offset.
get_user
Get full details for a SmartRecruiters user by ID, including name, email, role, and active status. Use list_users to find valid user IDs.
validate_credential
Validate SmartRecruiters credentials by verifying API access. Returns success status and the authenticated user's name.
How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's SmartRecruiters MCP server
FAQs on using Merge's SmartRecruiters MCP server
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
