SmartRecruiters MCP Server
for AI Agents
Connect your AI agent to StackOne's SmartRecruiters MCP server and give it 164 MCP tools out of the box. Auth, tool execution, and security all managed.
StackOne 
Coverage
164 Agent Actions
Create, read, update, and delete across SmartRecruiters — and extend your agent's capabilities with custom 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, observability, and agent execution runtime. Connect it from MCP clients like Claude Desktop, Claude Code, Cursor, Goose, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.
All SmartRecruiters MCP Tools
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
SmartRecruiters AI Agent Use Cases
Connect your AI agent to SmartRecruiters and help your team scale the recruiting operations they run by hand today.
Use StackOne to connect your AI agent to your ATS and job boards to automate job posting distribution.
ViewUse StackOne to connect your AI agent to your ATS, survey tools, and messaging systems to automate reference checks.
ViewUse StackOne to connect your AI agent to your ATS, HRIS, and document management tools to automate offer letter generation.
ViewSet Up Your SmartRecruiters MCP Server in Minutes
One endpoint. Any framework. Your agent is talking to SmartRecruiters in under 10 lines of code.
Agent Frameworks
JSON{
"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>"
]
}
}
}SmartRecruiters Resources
How I Built an AI Hiring Analyst in Under an Hour
A Head of People connected Claude to Ashby through StackOne's MCP gateway to answer hiring questions from real-time data via chat. No code required.
5 min read
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
MCP vs A2A: Architecture, Security, and When to Use Each
MCP vs A2A: what each protocol standardizes, how they differ, their shared security risks including indirect prompt injection, and when to use one, both, or a hybrid architecture.
12 min
MCP vs API: What 200+ Connector Builds Taught Us
MCP wraps APIs, it doesn't replace them. After building 200+ connectors that serve both, here's when each approach wins.
14 min read
SmartRecruiters MCP Server FAQ
Does StackOne have a SmartRecruiters MCP server?
SmartRecruiters MCP server vs direct API integration — what's the difference?
How does SmartRecruiters authentication work for AI agents?
origin_owner_id.Are SmartRecruiters MCP tools vulnerable to prompt injection?
What is the context bloat of a SmartRecruiters agent and how do I avoid it?
Can I limit which actions my SmartRecruiters agent can access?
Can I create custom agent actions for my SmartRecruiters MCP server?
When should I NOT use a SmartRecruiters MCP server?
What AI frameworks and AI clients does the StackOne SmartRecruiters MCP server support?
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.