# Ashby MCP for AI Agents AI Agent Connect > Ashby MCP lets you manage your entire recruiting pipeline through a natural language interface. You can track job listings, search for candidates, and monitor application statuses without leaving your current workspace. It turns your hiring process into a conversation, making it easy to find the right talent and keep your team updated on every stage of the hiring funnel. ## Overview - **Category:** human-resources - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Vs9SUJTu7eDnVehNeQMdBwTkERKtxtSKUVnQwDvg/ai-agent-connect - **Tags:** applicant-tracking, talent-acquisition, hiring-pipeline, candidate-management, recruitment-automation, scheduling ## Description Managing a high-volume hiring pipeline usually means jumping between dozens of tabs to check where a candidate stands or to see if a job posting is still active. You spend your day hunting for a specific application ID or manually filtering through endless lists of candidates just to find one person's email. The Ashby MCP changes that by giving your AI agent direct access to your Ashby data. Instead of doing the manual digging yourself, you can just ask your agent to do the heavy lifting. You can pull up candidate profiles, summarize interview schedules, or check the status of a specific role in seconds. Because Vinkius makes it so easy to connect these types of tools, you can actually spend your time talking to people instead of auditing spreadsheets. It's about moving from manual data entry to active talent management. Your agent handles the retrieval of information, and you handle the actual decisions. You can audit your entire pipeline, search for specific talent, and keep your team updated on every stage of the hiring funnel without ever leaving your workspace. This means no more copy-pasting candidate details into notes or manually checking if a job is still live. It turns a series of manual clicks into a natural conversation about your hiring goals. Whether you're looking for a specific candidate by name or need to see every open position in one list, this connection makes that data instantly accessible. You get to stay focused on the human side of hiring while your agent handles the logistics of the Ashby platform. ## Tools ### create_ashby_candidate Create candidate ### list_ashby_feedback List feedback ### list_ashby_interviews List interviews ### get_ashby_application Get application details ### get_ashby_candidate Get candidate details ### get_ashby_job Get job details ### list_ashby_applications List applications ### list_ashby_candidates List candidates ### list_ashby_jobs List jobs ### list_ashby_users List users ## Prompt Examples **Prompt:** ``` Who are our top candidates for the Product Designer role? ``` **Response:** ``` I've pulled the candidates currently in the final stages for the **Product Designer** role. Here's the summary: | Candidate Name | Current Stage | Tags | | :--- | :--- | :--- | | Alex Rivera | Technical Interview | Engineering, Referral | | Jordan Smith | Final Review | Design, Internal | Would you like me to pull the full profile for either of them? ``` **Prompt:** ``` List all jobs that are currently in the 'Draft' status. ``` **Response:** ``` I found **3** jobs currently in the **Draft** status: * **Senior DevOps Engineer** (ID: job_442) * **Marketing Manager** (ID: job_901) * **Customer Success Lead** (ID: job_112) Let me know if you'd like to see the requirements for any of these. ``` **Prompt:** ``` Give me the details for application app_998877. ``` **Response:** ``` Here are the details for application **app_998877**: * **Role:** Senior Frontend Engineer * **Status:** Technical Interview * **Created On:** Feb 1st * **Notes:** Candidate has completed the initial screening and is moving to the technical round. ``` ## Capabilities ### Search for candidates by name or email Find specific people in your talent pool instantly using natural language. ### List all active and archived jobs Get a full overview of every job listing in your organization. ### View detailed job metadata Pull specific requirements and details for any job role. ### Track application statuses Monitor where candidates stand in the hiring funnel at any time. ### Retrieve interview schedules Get a clean list of upcoming and past interviews for your team. ### Filter job listings by status Quickly see which roles are open, closed, or still in draft. ## Use Cases ### The Who's Next Check A recruiter asks the agent to find all candidates in the 'Technical Interview' stage for the Senior Engineer role. The agent uses `list_applications` to pull the specific group and presents it instantly. ### The Quick Audit A hiring manager wants to know how many open roles are currently in the 'Draft' status. The agent uses `list_jobs` to filter the status and give a summary. ### The Candidate Deep Dive An agent pulls the full profile and tags for a candidate found via `search_candidates` to prep for a call. This saves the recruiter from clicking through multiple profile pages. ### The Interview Sync A team lead asks for a list of all interviews happening this week to coordinate a peer review. The agent pulls all data from `list_interviews` into a clean summary. ## Benefits - Stop manual searching with `search_candidates` to find talent in seconds. - Get instant status updates on any role using `list_jobs` to filter by status. - Keep your calendar organized by pulling all upcoming dates with `list_interviews`. - Avoid digging through tabs by pulling specific details with `get_candidate_info`. - Stay on top of your funnel by viewing every active application with `list_applications`. - Verify your connection instantly with `get_account_check` to ensure data flows correctly. ## How It Works The bottom line is you get a conversational interface for your entire Ashby recruiting pipeline. 1. Connect your Ashby API key to the Vinkius platform. 2. Grant your AI client permission to access your recruiting data. 3. Ask your agent to find candidates, list jobs, or check application statuses. ## Frequently Asked Questions **Can the Ashby MCP help me find candidates faster?** Yes, it lets your agent search your entire database by name or email instantly. This replaces the need to manually scroll through long lists of names. **Can I use the Ashby MCP to see my interview schedule?** Yes, it pulls all your scheduled interviews into a list you can read. You can ask your agent to summarize them or check for specific dates. **Does the Ashby MCP work with my current hiring workflow?** It connects directly to your Ashby data so you can query it during your normal workday. You can use it to audit your pipeline or check application statuses. **Can I use the Ashby MCP to see all my open jobs?** Yes, it can list every job and even filter them by their current status. This gives you a high-level view of your active hiring goals. **How does the Ashby MCP help hiring managers?** It lets you quickly check the status of specific applications without digging through folders. You can get summaries of where candidates stand in seconds. **How do I find my Ashby API Key?** Log in to Ashby, go to **Admin > API Keys**, and click **Create API Key**. Ensure you grant the necessary permissions (e.g., `jobsRead`, `candidatesRead`). **Why does this server use POST for all requests?** The Ashby API is designed as an RPC-style API where even data retrieval (reading) endpoints require a POST request with a JSON body. **Can I search for candidates by email?** Yes, use the `search_candidates` tool and provide the `email` parameter to find a specific candidate in your database. **Can I retrieve interview feedback via AI?** Yes! The `list_ashby_feedback` tool allows your agent to retrieve high-fidelity feedback reports submitted by interviewers. **How do I create a new candidate record?** Use the `create_ashby_candidate` tool and provide a JSON object with the candidate's name and contact details programmatically.