# Homerun MCP for AI Agents AI Agent Connect > Homerun MCP lets you manage your entire hiring pipeline from within your AI client. You can create job applications, update candidate statuses, and pull up specific notes without ever leaving your chat window. It turns your AI into a dedicated recruiting assistant that handles the repetitive data entry of an ATS, allowing you to focus on interviewing and making hiring decisions. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_RTaFfNnI05vlXHbsZinaCxoXAYkJYCEqj3erlqos/ai-agent-connect - **Tags:** hiring, applicant-tracking, recruitment, candidate-management, hr-tech ## Description Stop jumping between tabs to move a candidate from 'Interview' to 'Hired.' This Connector connects your Homerun account to your AI agent so you can handle recruitment tasks using natural language. Instead of digging through a complex dashboard, you just tell your agent to find specific applications or update a candidate's status on the fly. It handles the heavy lifting of record management, like fetching metadata or uploading resumes, so you can focus on actually talking to people. You can ask your agent to list all active applications for a specific vacancy or pull up the notes from a previous screening call. It knows how to fetch the notes, sources, and answers you need to stay informed during a high-pressure interview. By adding this to your Vinkius setup, you turn your AI into a functional member of your HR team that keeps your talent pipeline organized and up to date. You can create new applications, upload resumes, and manage your vacancies without ever leaving your chat window. It turns your recruitment process into a conversation rather than a series of manual data entry steps. For operations leads, it provides a way to quickly check vacancy statuses and candidate flows across the whole organization without running manual reports. ## Tools ### create_job_application Create a new job application record for a candidate. It lets you build new profiles quickly. ### get_vacancy Retrieve detailed information about a specific job vacancy. It shows all the specifics of an open role. ### list_job_applications Get a list of all job applications with filters. You can sort by stage or vacancy status. ### list_vacancies View all current job vacancies in your account. This gives you a high level view of open roles. ### ping Test your Homerun API connection. Use this to make sure your credentials work. ### upload_job_application_photo Add an applicant photo to their profile. This helps put a face to the name in your records. ### create_job_application_note Add a specific note to an existing job application. Use this to log interview feedback. ### delete_job_application Remove a job application from your records. It helps keep your database clean. ### get_job_application Fetch full details for a specific job application. You can see notes, sources, and answers here. ### update_job_application Change details or the stage of a job application. Move candidates to 'Hired' or 'Rejected' easily. ### upload_job_application_file Attach a resume or assignment file to an application. It links documents directly to the candidate. ## Prompt Examples **Prompt:** ``` List all active job applications for vacancy ID 'vac_123'. ``` **Response:** ``` I've found 3 active applications for that vacancy. Candidates include: | Name | Stage | Source | | :--- | :--- | :--- | | John Doe | Review | LinkedIn | | Jane Smith | Interview | Referral | | Alex Brown | Review | Indeed | Would you like to see the details for any of them? ``` **Prompt:** ``` Get the full details for job application 887766, including notes and sources. ``` **Response:** ``` Fetching details for application 887766... **Candidate:** Michael Scott **Source:** LinkedIn **Recruiter Notes:** * Strong leadership background. * Highly recommended for the regional manager position. * Great culture fit. Would you like me to update the status or add a new note? ``` **Prompt:** ``` Update application 554433: set the stage to 'hired'. ``` **Response:** ``` Successfully updated application 554433. The candidate has been moved to the **'hired'** stage. Is there anything else you'd like me to do for this vacancy? ``` ## Capabilities ### Filter job applications View candidates based on their current stage, specific vacancy, or disqualification status. ### Create new applications Add new candidates to your pipeline with personal info and social profiles. ### Fetch interview notes Pull up complete metadata and notes for specific candidates instantly. ### Move candidates between stages Update a candidate's status to 'hired' or move them through the pipeline. ### Upload resumes and photos Attach assignment files or applicant photos directly to a job application. ### Maintain clean records Delete or update existing records to keep your talent database accurate. ## Use Cases ### Quick status updates during a call A hiring manager is on a call and asks their agent to move candidate 554433 to the 'hired' stage using update_job_application. ### Retrieving notes for a final review A recruiter asks the agent to fetch all notes and sources for a specific candidate using get_job_application. ### Mass filtering of active roles An ops lead asks the agent to list all active job applications for a specific vacancy ID using list_job_applications. ### Organizing new applicant files An HR admin asks the agent to upload a resume and an applicant photo to a new record using upload_job_application_file and upload_job_application_photo. ## Benefits - Skip the dashboard by using list_job_applications to see who's in the pipeline at a glance. - Keep records fresh by using update_job_application to move candidates through stages instantly. - Save time on data entry by using create_job_application to build new profiles without manual typing. - Access context faster with get_job_application to see interview notes and sources during calls. - Organize your files by using upload_job_application_file to attach resumes to the right person. - Maintain a clean database by using delete_job_application to clear out old entries and noise. ## How It Works The bottom line is you get a voice-controlled interface for your entire recruitment database. 1. Subscribe to the Homerun MCP via the Vinkius catalog. 2. Enter your Homerun API Key in the connection settings. 3. Ask your agent to list vacancies or update a candidate's status. ## Frequently Asked Questions **How does the Homerun MCP help with my hiring process?** It lets you manage your candidate pipeline using natural language. You can move people between stages, fetch interview notes, and update job applications without leaving your AI chat window. **Can I use the Homerun MCP to upload resumes?** Yes, you can ask your agent to attach resumes or assignment files directly to a specific job application record. **Will the Homerun MCP keep my candidate notes organized?** Absolutely. You can ask your agent to retrieve specific notes or create new ones for any candidate, ensuring all feedback is stored in one place. **Can I filter applications using the Homerun MCP?** Yes, you can ask your agent to list applications based on their current stage, specific vacancy, or whether they have been disqualified. **Is the Homerun MCP good for high-volume recruiting?** It's perfect for high-volume work because it removes the need to click through a dashboard for every single update, saving you significant time on data entry. **Does the Homerun MCP support multiple vacancies?** Yes, it can list all your current vacancies or pull up specific details for any individual role in your account. **Can I filter job applications to see only those who have been hired?** Yes! Use the `list_job_applications` tool and set the `stage` parameter to 'hired'. You can also combine this with `hired_after` to see recent hires. **How do I retrieve the full profile and notes for a specific candidate?** Use the `get_job_application` tool with the specific `job_application_id`. To see notes, ensure you include 'notes' in the `include` parameter. **Is it possible to move a candidate to a different stage via the AI?** Absolutely. Use the `update_job_application` tool and provide the new stage name within the `stage` JSON object (e.g., `{"name": "interview"}`).