# Lever MCP > Lever MCP lets you manage your entire hiring pipeline directly from your AI client. You can list all active job postings, view detailed candidate profiles, and move applicants through specific hiring stages like 'Interview' or 'Offer.' It handles everything from creating new jobs to updating a candidate’s status without opening the Lever dashboard. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** applicant-tracking, talent-acquisition, hiring-pipeline, candidate-management, job-postings ## Description Recruitment used to mean toggling between tabs: checking posting details, hunting down a candidate’s name, and then manually changing their stage in another view. This MCP changes that. It lets your AI agent handle the whole mess through natural conversation. You can ask it to list all job ads or pull up a specific candidate's full history instantly. Want to move John Doe from 'Screening' to 'Interview'? Just tell your client, and it updates the record for you. This MCP gives you total control over job postings and applicant opportunities. When you connect this to Vinkius, you get access to dozens of specialized tools that lets your agent do everything from drafting new jobs to automating candidate follow-ups. ## Tools ### archive_hiring_opportunity Marks a candidate opportunity as archived in your system. ### create_hiring_opportunity Generates a new record for an applicant with specific details. ### create_job_posting Publishes and drafts a brand-new job advertisement within Lever. ### get_candidate_profile Retrieves all available details for a specific candidate by name or ID. ### get_opportunity_details Fetches the full history and current status of one particular job application. ### get_posting_details Pulls all configuration details for a specific, active job posting. ### list_hiring_opportunities Lists every candidate opportunity (application) currently in your system. ### list_job_postings Retrieves a list of all job advertisements you have active or drafted. ### list_hiring_stages Shows every specific stage (like 'Screen' or 'Interview') defined in your hiring pipeline. ### update_opportunity_stage Moves a candidate to a different, specified stage within the hiring process. ## Prompt Examples **Prompt:** ``` List all my current job postings in Lever. ``` **Response:** ``` I've retrieved your job postings. You have 8 active postings, including 'Senior Software Engineer', 'Product Manager', and 'Sales Director'. Would you like to see details for any of them? ``` **Prompt:** ``` Move opportunity ID 'opp-123' to the 'Interview' stage (ID: 'stage-abc'). ``` **Response:** ``` Successfully moved opportunity opp-123 to the 'Interview' stage in your Lever hiring pipeline. ``` **Prompt:** ``` Get the full profile for candidate ID 'cand-987'. ``` **Response:** ``` I've fetched the profile for candidate cand-987. It's 'Jane Smith', currently living in San Francisco. Her headline is 'Experienced UX Designer' and she has 3 linked opportunities. ``` ## Capabilities ### List and View Job Postings You retrieve a list of all current job ads and grab deep details on any specific posting. ### Manage Candidate Records The system lets you fetch complete profiles, including contact information and interaction histories, for any candidate. ### Update Applicant Status You change a candidate’s status within the pipeline—for instance, moving them from 'Applied' to 'Interview'. ### Automate Job Creation The agent can draft and create brand new job postings right through your AI client. ### Define Pipeline Stages You list all the specific, defined stages (like 'Screen' or 'Offer') that make up your company’s hiring process. ## Use Cases ### The Candidate Status Update A recruiter just finished an interview with Jane Smith. Instead of logging into Lever and clicking through three tabs to change her status, they simply tell their agent: 'Move candidate cand-987 to the Offer stage.' The system executes the `update_opportunity_stage` tool immediately. ### The Missing Job Ad A hiring manager needs a new role filled fast. Instead of manually building the job description, they prompt their agent: 'Create a posting for Senior Backend Engineer.' The system uses `create_job_posting`, gets it live in Lever, and sends confirmation. ### The Profile Deep Dive A sourcer finds an interesting name. They ask their agent to get the full profile using `get_candidate_profile`. The system immediately returns Jane Smith's contact info, headline, and all three linked opportunities. ### Pipeline Health Check The HR Ops team needs an audit. They prompt their agent to run `list_hiring_opportunities` to get a count of all applications and check if any are stuck in old stages, ensuring the data is accurate. ## Benefits - Update candidate statuses immediately. You can use `update_opportunity_stage` to move an applicant from 'Applied' to 'Interview' with a single prompt, logging the change without opening the application record. - Never start from scratch again. Use `create_job_posting` to generate and publish new job ads instantly, feeding all necessary details directly into Lever. - Get full candidate context fast. The `get_candidate_profile` tool retrieves a person's entire history, letting you know who they are and what roles they applied for without searching multiple records. - Maintain clean data integrity. You can list defined stages using `list_hiring_stages`, ensuring your agent only uses valid pipeline names when processing updates. - Streamline oversight. Use `list_job_postings` and `list_hiring_opportunities` to get a real-time, comprehensive overview of everything happening in your talent acquisition funnel. ## How It Works The bottom line is you manage complex HR tasks through simple natural language prompts, bypassing multiple dashboards and manual clicks. 1. Subscribe to this MCP and provide your Lever API key. 2. Your AI client connects, authenticating the connection to your recruiting accounts. 3. You simply ask your agent to perform an action—like listing all current jobs or moving a candidate's status—and it executes the command. ## Frequently Asked Questions **Does Lever MCP help me list all my current job postings?** Yes. You use `list_job_postings` to get a roster of every ad you have active or drafted in your account. **How do I move an applicant's status using Lever MCP?** You tell your agent the opportunity ID and the target stage. The tool `update_opportunity_stage` executes the change instantly within the pipeline. **Can I use Lever MCP to create a new candidate record?** Yes, you can generate a new applicant using `create_hiring_opportunity`, which requires providing all necessary details in a structured format. **Is Lever MCP only for active users?** No. You can use the `archive_hiring_opportunity` tool to mark applications as archived when they are no longer relevant to your current hiring cycle. **Do I need an API key for Lever MCP?** Yes, you must provide your specific Lever API Key during setup so the agent can connect and perform actions on your behalf.