Skip to main content

Announcing StackOne Defender: leading open-source prompt injection guard for your agent • Read More →

Connect

Connectors Agent Auth MCP Connector Builder

Optimize

Tool Discovery Falcon Engine

Secure

Defender
Connectors

HRIS / HCM

Employee Onboarding Employee Offboarding

Recruiting

Application Screening Interview Scheduling

Customer Support

Ticket Triage Voice Call Summarization

Sales & CRM

Deal Risk Scoring Lead Qualification

Accounting & Finance

Invoice Processing Month-End Accruals

Marketing

Campaign Reports Lead Nurture Sequences
View all use cases

Developers

Docs Changelog Status

Learn

Blog Case Studies Events Partners
Pricing
Login Book Demo Start Free

SmartRecruiters MCP Server
for AI Agents

Production-ready SmartRecruiters MCP server with 164 extensible actions — plus built-in authentication, security, and optimized execution.

Start Free Book Demo Read Docs →
SmartRecruiters logo
SmartRecruiters MCP Server
Built by StackOne StackOne

Coverage

164 Agent Actions

Create, read, update, and delete across SmartRecruiters — and extend your agent's capabilities with custom actions.

MCP Actions → Create Actions →

Authentication

Agent Tool Authentication

Per-user OAuth in one call. Your SmartRecruiters MCP server gets session-scoped tokens with zero credentials stored on your infra.

Agent Auth →

Security

Agent Protection

Every SmartRecruiters tool response scanned for prompt injection in milliseconds — 88.7% accuracy, all running on CPU.

Prompt Injection Defense →

Performance

Max Agent Context. Min Cost.

Free up to 96% of your agent's context window to enhance reasoning and reduce cost, on every SmartRecruiters call.

Tools Discovery →

What is the SmartRecruiters MCP Server?

A SmartRecruiters MCP server lets AI agents read and write SmartRecruiters data through the Model Context Protocol — Anthropic's open standard for connecting LLMs to external tools. StackOne's SmartRecruiters MCP server ships with 164 pre-built actions, fully extensible via the Connector Builder — plus managed authentication, prompt injection defense, and optimized agent context. Connect it from MCP clients like Claude Desktop, Cursor, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.

All SmartRecruiters MCP Tools and Actions

Every action from SmartRecruiters's API, ready for your agent. Create, read, update, and delete — scoped to exactly what you need.

Candidate Applications

  • Create Candidate Application

    Create a new candidate application for a job posting

  • Get Candidate Application

    Get details of a candidate's job application

  • Delete Candidate Application

    Delete a candidate's job application

Job Applications

  • Get Job Application

    Get a job application by its ID

  • Delete Job Application

    Delete a job application by its ID

Approval Requests

  • Create Approval Request

    Create a new approval request based on an existing approval

  • Get Approval Request

    Get an approval request by its ID

Approval Comments

  • Add Approval Comment

    Add a comment to an approval request

  • List Approval Comments

    Get all comments for an approval request

Candidates

  • Create Candidate

    Create a new candidate and assign to a Talent Pool

  • Search Candidates

    Search for candidates in SmartRecruiters with optional filters

  • Get Candidate

    Get detailed information about a specific candidate

  • Update Candidate

    Update personal information for an existing candidate

  • Delete Candidate

    Delete a candidate from SmartRecruiters

Candidate Tags

  • Add Candidate Tags

    Add new tags to a candidate without replacing existing tags

  • Get Candidate Tags

    Retrieve all tags assigned to a candidate

  • Update Candidate Tags

    Replace all tags for a candidate with a new set of tags

  • Delete Candidate Tags

    Remove all tags from a candidate

Candidate Onboarding Status For Jobs

  • Get Candidate Onboarding Status For Job

    Get onboarding status for a candidate in context of a specific job

  • Update Candidate Onboarding Status For Job

    Set onboarding status for a candidate in context of a specific job

Candidate Attachments

  • List Candidate Attachments

    Retrieve all attachments for a candidate

  • Get Candidate Attachment

    Retrieve a specific attachment by its unique ID

  • Delete Candidate Attachment

    Delete a specific attachment by its unique ID

Candidate Status

  • Get Candidate Status

    Get public-facing application status for a candidate

  • Update Candidate Status

    Update a candidate's status for a specific job application

Access Groups

  • Create Access Group

    Create a new access group with given properties and criteria

  • List Access Groups

    List access groups configured in your company

  • Get Access Group

    Get details of a specific access group

  • Update Access Group

    Update an existing access group

Job Propertys

  • Create Job Property

    Create a new job property

  • Get Job Property

    Get details of a specific job property

Job Property Values

  • Create Job Property Value

    Create a new value for a job property

  • Get Job Property Values

    Get available values for a job property

Job Property Dependents

  • Create Job Property Dependents

    Create dependencies between job properties

  • Get Job Property Dependents

    Get dependent properties for a job property

Job Property Dependent Values

  • Add Job Property Dependent Value

    Add a dependent value for a specific job property value

  • Get Job Property Dependent Values

    Get values for a dependent job property

Departments

  • Create Department

    Create a new department

  • List Departments

    Get all departments configured in the company

  • Get Department

    Get a department by its ID

Candidate Property Values

  • Create Candidate Property Value

    Create a new value for a SINGLE_SELECT candidate property

  • Get Candidate Property Values

    Get available values for a candidate property

  • Get Candidate Property Value

    Get a specific candidate property value by ID

Source Values

  • Get Source Values

    Get all source values for a specific source type

  • Get Source Value

    Get a specific candidate source by ID

Career Sites

  • List Career Sites

    Get all career sites configurations

  • Get Career Site

    Get details of a specific career site configuration

Predefined Locations

  • Create Predefined Location

    Create a new predefined location

  • List Predefined Locations

    Get all predefined locations configured in the company

  • Get Predefined Location

    Get a predefined location by its ID

  • Update Predefined Location

    Update an existing predefined location

  • Delete Predefined Location

    Delete a predefined location

Interview Templates

  • Create Interview Template

    Create a new interview template

  • Get Interview Template

    Get interview template by ID

  • List Interview Templates

    Get interview templates for the current company

  • Update Interview Template

    Update an interview template

  • Delete Interview Template

    Delete an interview template

Job Interview Templates

  • Get Job Interview Templates

    Find job-level interview templates for a job

  • List Job Interview Templates

    Find all job-level interview templates for a job

  • Search Job Interview Templates

    Find job-level interview templates by job and application IDs

  • Update Job Interview Template

    Update a job-level interview template

Interview Types

  • Get Interview Types

    Get available interview types in SmartRecruiters

  • Delete Interview Type

    Remove an interview type with the given name

Interviews

  • Create Interview

    Create a new interview for a candidate application

  • List Interviews

    Get a list of interviews in SmartRecruiters

  • Get Interview

    Get a specific interview by its ID

  • Update Interview

    Modify an existing interview

  • Delete Interview

    Delete an existing interview

Timeslots

  • Create Timeslot

    Add a new timeslot to an existing interview

  • Get Timeslot

    Retrieve a specific timeslot from an interview

  • Update Timeslot

    Modify an existing timeslot in an interview

  • Delete Timeslot

    Delete a timeslot from an interview

Jobs

  • Create Job

    Create a new job in SmartRecruiters

  • Publish Job

    Publish the job's default ad to internal sources and job aggregators

  • Search Jobs

    Search for jobs in SmartRecruiters with optional filters

  • Get Job

    Get detailed information about a specific job

  • Update Job

    Fully update a job with all fields including location, compensation, and properties

Job Positions

  • Create Job Position

    Create a new position for a job

  • List Job Positions

    List all positions for a job

  • Get Job Position

    Get details of a specific position

  • Update Job Position

    Update an existing position

  • Delete Job Position

    Delete a position from a job

Job Ads

  • Create Job Ad

    Create a new job advertisement

  • Publish Job Ad

    Publish a job ad to internal sources and job aggregators

  • List Job Ads

    List all job advertisements for a job

  • Get Job Ad

    Get details of a specific job ad

  • Update Job Ad

    Update an existing job advertisement

Hiring Team Members

  • Add Hiring Team Member

    Add a member to the job's hiring team

  • Remove Hiring Team Member

    Remove a member from the job's hiring team

Job Notes

  • Get Job Note

    Get the note associated with a job

  • Update Job Note

    Update the note associated with a job

Candidate Offers

  • List Candidate Offers

    Get all offers for a candidate's job application

  • Get Candidate Offer

    Get a specific offer for a candidate's job application

Offer Documents

  • List Offer Documents

    Get list of documents related to sent offer

  • Get Offer Document

    Get a specific document from a sent offer

Postings

  • List Postings

    Lists active postings published by a given company

  • Get Posting

    Get posting by posting id or uuid for a given company

Reviews

  • Create Review

    Creates a review for a candidate

  • Get Review

    Retrieves a review by ID

  • Update Review

    Updates a review by ID

  • Delete Review

    Deletes a review by ID

Users

  • Create User

    Create a new user in your company

  • List Users

    List users of your company

  • Get User

    Get details of a user by ID

Other (60)

  • Upload Candidate Attachment For Job

    Upload a file attachment to a candidate in the context of a specific job application. The file must be provided as base64 encoded content — do not pass a file path or URL.

  • Create A New Candidate And Assign To A Job

    Create a new candidate and assign to a job

  • Send User Activation Email

    Send an activation email to a user

  • Get Application Configuration For Posting

    Get application configuration including screening questions and privacy policies

  • Get Application Status

    Get the current status of a candidate's application for a job posting

  • List Pending Approvals

    Get all pending approval requests for the authenticated user

  • Get Candidate Onboarding Status

    Get onboarding status for a candidate (deprecated - use job-specific endpoint)

  • List Candidate Attachments For Job

    Retrieve all attachments for a candidate's job application

  • Get Candidate Status History For Job

    Get status history for a candidate's specific job application

  • Get Candidate Properties For Job

    Get property values for a candidate's job application

  • Get Candidate Consent Status

    Get consent status for a candidate

  • Get Candidate Consent Decisions

    Get consent decisions for a candidate

  • Get Candidate Screening Answers

    Get screening question answers for a candidate

  • Get Company Information

    Get all information about your company

  • List Job Properties

    Get a list of all available job properties

  • Get Job Property Value Dependents

    Get dependent values for a specific job property value

  • List Hiring Processes

    Get all hiring processes configured in the company

  • Get Hiring Process

    Get a hiring process by its ID

  • List Offer Properties

    Get all available offer properties

  • List Candidate Properties

    Get all available candidate properties

  • Get Candidate Property

    Get a candidate property by its ID

  • Get Source Types

    Get all available candidate source types with subtypes

  • Get Source By Identifier

    Get a candidate source by its unique identifier

  • List Rejection Reasons

    Get all available rejection reasons

  • List Withdrawal Reasons

    Get all available withdrawal reasons

  • Get Managed Hiring Process Steps

    Get managed hiring process steps for a job

  • Get Application Interview Templates

    Find job-level interview templates by job application ID

  • Get User Schedule Preferences

    Find schedule preferences for a user

  • Get Job Status History

    Get the status change history for a job

  • Get Job Approvals

    Get the latest approval request for a job

  • List Job Ad Postings

    List all publications for a job ad

  • List Job Publications

    List all publications for a job's default ad

  • Get Hiring Team

    Get the hiring team for a job

  • Get Offer Approval

    Get latest approval request for candidate's offer

  • Search Offers

    Search offers with filters

  • List Company Departments

    List departments for a given company

  • Get Candidate Reviews

    Retrieves all reviews for specified candidate and job

  • Get Job Review Criteria

    Retrieves all criteria for specified job

  • Get Current User

    Get details of the authenticated user

  • List System Roles

    List all available system roles

  • Update Candidate Source

    Update the source information for a candidate

  • Update Candidate Property Value Label

    Update the label of a candidate property value

  • Update Interviewer Status

    Change an interviewer's status in a given timeslot

  • Update Timeslot Candidate Status

    Change a candidate's status in a given timeslot

  • Update Timeslot No-Show

    Change the no-show value for a timeslot

  • Update Job Status

    Update the status of a job

  • Remove User From Access Group

    Remove a user from an access group

  • Approve Approval Request

    Approve an approval request by its ID

  • Reject Approval Request

    Reject an approval request by its ID

  • Parse Resume

    Parse a resume file and extract structured candidate data. The file must be provided as base64 encoded content — do not pass a file path or URL.

  • Archive Job Property Value

    Archive a job property value

  • Activate Job Property

    Activate a job property

  • Save Job Interview Template

    Save or replace job-level interview template for a hiring stage and step

  • Patch Job Interview Template Interviewers

    Update interviewers pool for a job-level interview template

  • Unpublish Job Ad

    Unpublish a job ad from all distribution channels

  • Unpublish Job

    Unpublish the job from all publication sources

  • Reset User Password

    Send a password reset email to a user

  • Activate User

    Activate a user account

  • Deactivate User

    Deactivate a user account

  • Assign Users To Access Group

    Assign multiple users to an access group

Set Up Your SmartRecruiters MCP Server in Minutes

One endpoint. Any framework. Your agent is talking to SmartRecruiters in under 10 lines of code.

MCP Clients

Agent Frameworks

Claude Desktop
{
  "mcpServers": {
    "stackone": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.stackone.com/mcp?x-account-id=<account_id>",
        "--header",
        "Authorization: Basic <YOUR_BASE64_TOKEN>"
      ]
    }
  }
}

More Recruiting MCP Servers

JobAdder

246+ actions

Vincere

206+ actions

Ashby

137+ actions

Factorial

127+ actions

HiBob

123+ actions

HiBob (with Webhooks)

123+ actions

Teamtailor

106+ actions

All Recruiting MCP Servers →

SmartRecruiters MCP Server Resources

MCP Code Mode: Keeping Tool Responses Out of Agent Context

Anthropic's code_execution processes data already in context. Custom MCP code mode keeps raw tool responses in a sandbox. 14K tokens vs 500.

11 min

Comparing BM25, TF-IDF, and Hybrid Search for MCP Tool Discovery

Benchmarking BM25, TF-IDF, and hybrid search for MCP tool discovery across 916 tools. The 80/20 TF-IDF/BM25 hybrid hits 21% Top-1 accuracy in under 1ms.

10 min

Indirect Prompt Injection Defense for MCP Tools: A Technical Guide

MCP tools that read emails, CRM records, and tickets are indirect prompt injection vectors. Here's how we built a two-tier defense that scans tool results in ~11ms.

12 min

SmartRecruiters MCP Server FAQ

SmartRecruiters MCP server vs direct API integration — what's the difference?
A SmartRecruiters MCP server and direct API integration serve different use cases. Direct API integration is for software-to-software — backend code calling SmartRecruiters. A SmartRecruiters MCP server is for AI agents — MCP clients like Claude and Cursor, plus framework agents built with OpenAI, LangChain, or Vercel AI — discovering and calling SmartRecruiters at runtime. StackOne provides both.
How does SmartRecruiters authentication work for AI agents?
SmartRecruiters authentication for AI agents works through a StackOne Connect Session. Create one via the dashboard or the SDK — you get an auth link and ready-to-paste config for Claude Desktop, Cursor, and other MCP clients. Your user authenticates their own SmartRecruiters account; StackOne handles token exchange, storage, and refresh. Credentials never reach the LLM, and each user is isolated via origin_owner_id.
Are SmartRecruiters MCP tools vulnerable to prompt injection?
Yes — SmartRecruiters MCP tools can be vulnerable to indirect prompt injection. Any tool that reads user-written content — documents, messages, tickets, records, or free-text fields — is a potential vector. StackOne Defender scans every tool response before it enters the agent's context — regex patterns in ~1ms, then a MiniLM classifier in ~4ms. 88.7% accuracy, CPU-only.
What is the context bloat of a SmartRecruiters agent and how do I avoid it?
Context bloat happens when SmartRecruiters tool schemas and API responses eat your SmartRecruiters agent's memory, preventing it from reasoning effectively. A single SmartRecruiters query can return a massive JSON response, and connecting multiple tools compounds the problem. Tools Discovery and Code Mode reduce context bloat — loading only relevant tools per query and keeping raw responses out of the agent's context.
Can I limit which actions my SmartRecruiters agent can access?
Yes — you can limit which actions your SmartRecruiters agent can access directly from the StackOne dashboard. Toggle actions on or off, or restrict them to specific accounts, with no code changes to your agent. Session tokens can be scoped to exact actions so if one leaks, exposure stays contained.
Can I create custom agent actions for my SmartRecruiters MCP server?
Yes — you can create custom agent actions for your SmartRecruiters MCP server using Connector Builder. It's an integration agent your coding assistant (Claude Code, Cursor, or Copilot) can invoke to research SmartRecruiters's API, generate production-ready connector YAML, test against the live API, and validate before you ship.
When should I NOT use a SmartRecruiters MCP server?
Skip a SmartRecruiters MCP server if your integration is purely software-to-software — direct SmartRecruiters API integration is simpler when no AI agent is involved. For deterministic, compliance-critical operations (financial transactions, regulatory reporting), direct API gives you predictable behavior without agent-driven decision-making. MCP shines when AI agents need to dynamically discover and call SmartRecruiters actions at runtime.
What AI frameworks and AI clients does the StackOne SmartRecruiters MCP server support?
The StackOne SmartRecruiters MCP server supports both. MCP clients (paste-and-go apps): Claude Desktop, Claude Code, Cursor, VS Code, Goose. Agent frameworks (code SDKs you build with): OpenAI Agents SDK, Anthropic, Vercel AI, Google ADK, CrewAI, Pydantic AI, LangChain, LangGraph, Azure AI Foundry.

Put your AI agents to work

All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.

Start Free Book Demo