# Greenhouse MCP for AI Agents AI Agent Connect > Greenhouse MCP lets you manage your entire recruiting pipeline through a chat interface. You can pull candidate profiles, track job applications in real-time, and audit hiring stages across various departments. It connects your Greenhouse account to your AI client so you can skip the dashboard navigation and get answers instantly. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_v86NWnpAjByKU8ZOhm7a3JnHVlZma28BI9d417ud/ai-agent-connect - **Tags:** hiring-pipeline, candidate-tracking, talent-acquisition, applicant-management, recruiting-automation, job-postings ## Description Managing a high-volume recruiting pipeline usually means jumping between tabs, filtering through hundreds of applicants, and constantly checking where a candidate sits in the hiring funnel. This connector changes that by letting you talk to your data instead of hunting for it. Instead of manually clicking through the dashboard to see who's ready for a final interview, you just ask your agent to pull the latest status. It handles the heavy lifting of navigating complex job configurations, department structures, and user permissions. You can audit your entire hiring process, from office locations to specific job stages, without ever leaving your primary workspace. It's built to make talent acquisition feel less like data entry and more like a conversation. By bringing this into the Vinkius catalog, you get a reliable way to keep your hiring team aligned without the usual friction of manual updates. You get a clear view of your organizational goals and the people moving toward them, all through a single, cohesive interface. ## Tools ### create_candidate Adds a new candidate profile to your system directly through your AI agent. This saves you from manual data entry when onboarding new applicants. ### get_candidate Pulls specific details for a single candidate to help you review their profile quickly. This lets you see their history and status without clicking through multiple pages. ### get_job Fetches the full details of a specific job listing, including its current status and requirements. Use this to see exactly what a role entails and where it stands in the hiring process. ### get_user Retrieves specific details for a Greenhouse user to help with access and role verification. It is useful for auditing who has permission to see sensitive hiring data. ### list_applications Pulls a list of all job applications so you can see the volume of incoming talent. This helps you monitor the health of your hiring pipeline at a glance. ### list_candidates Shows all candidates currently in your Greenhouse system for a high-level overview of your pipeline. Use this to quickly see who is in the mix for various roles. ### list_departments Lists all company departments to help align hiring with your organizational structure. This ensures your job postings are mapped to the correct teams. ### list_job_stages Shows the specific hiring stages for a job to ensure the process is moving correctly. It helps you verify that every candidate follows the same standardized path. ### list_jobs Provides a full list of all active and past jobs in your Greenhouse account. Use this to get a complete picture of your current hiring volume. ### list_offices Retrieves a list of all company offices to help coordinate regional hiring. This is helpful for managing decentralized teams across different locations. ### get_application Fetches the specific details of a single job application to see a candidate's unique progress. Use this to see exactly how far a specific person has moved through the funnel. ### list_users Lists all users in your Greenhouse workspace for auditing permissions and team access. It makes it easy to see who is currently active in your system. ## Prompt Examples **Prompt:** ``` Show me the candidates for the Senior Engineer role. ``` **Response:** ``` I've pulled the candidates for the Senior Engineer position. You have 12 active applicants. Would you like me to list their current stages or show you the top 3 profiles? ``` **Prompt:** ``` What are the hiring stages for the Product Designer job? ``` **Response:** ``` The hiring process for the Product Designer role (ID: 405) currently includes: 1. **Application Review** 2. **Portfolio Review** 3. **Phone Screen** 4. **Design Exercise** 5. **Executive Interview** ``` **Prompt:** ``` Who has access to our Greenhouse workspace? ``` **Response:** ``` | Name | Role | | :--- | :--- | | Jane Doe | Admin | | John Smith | Recruiter | | Sarah Lee | Hiring Manager | Let me know if you need me to check the specific permissions for any of them. ``` ## Capabilities ### Pull candidate profiles Get specific details on any applicant in your system instantly. ### Track application statuses Monitor where every applicant stands in the hiring funnel. ### Audit job configurations Inspect hiring stages and department mappings for any active role. ### Verify user permissions Check who has access to what within your Greenhouse workspace. ### Map office structures Retrieve company office and department lists for organizational alignment. ### Create new candidate profiles Add new applicants to your system without manual entry. ## Use Cases ### Checking candidate status during a sync A hiring manager asks the agent for the status of a specific candidate. The agent uses get_candidate to show the current stage and latest resume update. ### Auditing job stages for a new role An HR lead wants to make sure a new job follows the standard process. They ask the agent to list_job_stages for the new role to verify the steps. ### Onboarding a new batch of leads A sourcer wants to add five new leads. They tell the agent to create_candidate for each one, saving them from manual data entry. ### Verifying office-specific hiring A regional manager wants to see all jobs in a specific city. The agent uses list_offices and list_jobs to filter the results. ## Benefits - Stop clicking through tabs to find candidates. Use list_candidates to get a full view of your pipeline in one sentence. - Audit your hiring stages instantly. Use list_job_stages to ensure every role follows the correct internal process without manual checks. - Verify team access in seconds. Use list_users and get_user to make sure only the right people have permissions in your Greenhouse workspace. - Keep hiring aligned with your org structure. Use list_departments and list_offices to see how your talent acquisition maps to your real-world offices. - Faster candidate onboarding. Use create_candidate to add new applicants to your system without having to leave your chat interface. - Deep dive into specific applications. Use get_application and get_candidate to pull every detail you need for a final hiring decision. ## How It Works The bottom line is you get a conversational interface for your entire Greenhouse recruiting pipeline. 1. Subscribe to the Greenhouse MCP on the Vinkius Marketplace. 2. Provide your Greenhouse Harvest API Key (v1/v2) to your AI client. 3. Ask your agent to list candidates, check job stages, or audit user roles. ## Frequently Asked Questions **Can I use the Greenhouse MCP to see my candidates?** Yes, you can see every candidate in your system and pull specific details on any profile just by asking. **Does the Greenhouse MCP support job application tracking?** It does. You can pull lists of all applications or get the specific status of a single application. **How does the Greenhouse MCP help with HR auditing?** It allows you to quickly list all users, verify their roles, and inspect job configurations across different departments. **Can I add new candidates using the Greenhouse MCP?** Yes, you can use the tool to create new candidate profiles directly through your AI client. **Does the Greenhouse MCP work with my existing Greenhouse account?** It connects to your existing Greenhouse Harvest API to pull and manage your current data. **Can I see our office locations with this Connector?** Yes, you can retrieve a list of all company offices to help coordinate your regional hiring. **Can my agent list all candidates for a specific job in Greenhouse?** Yes. Use the 'list_candidates' tool with the 'job_id' parameter. The agent will fetch all candidates associated with that specific opening flawlessly. **How do I check the current hiring stage of an applicant via chat?** You can use the 'get_application' tool. Provide the Application ID, and the agent will return the full details, including the candidate's current stage in the hiring process natively. **Can I search for candidates who were added recently through the agent?** Absolutely. Use the 'list_candidates' tool with sorting or filtering parameters like 'created_after'. Your agent will retrieve the most recent additions to your Greenhouse database natively.