# Homerun MCP > Homerun connects your AI client directly to your applicant tracking system, letting you handle every part of recruitment conversationally. Manage job applications, track candidate details, update statuses, and oversee vacancies without ever switching tabs or logging into a dashboard. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** hiring, applicant-tracking, recruitment, candidate-management, hr-tech ## Description Managing hiring shouldn't mean living in a dozen different browser tabs. This MCP lets you talk to your agent about recruiting tasks—from listing open roles to updating a candidate’s status—and it handles the heavy lifting within Homerun for you. You can build out an entire talent pipeline conversationally, pulling up specific application notes or gathering detailed metadata on any applicant. It's like having your ATS built right into your chat window. When you connect this MCP via Vinkius, you get access to all of Homerun’s core features without needing a dedicated dashboard login. You simply ask your agent what you need done, and it executes the commands—whether that’s moving a candidate to 'hired,' creating a new application record, or just fetching the full details on where they came from. ## Tools ### create_job_application Builds an entirely new job application record for a candidate. ### create_job_application_note Adds a specific note or comment to an existing job application file. ### delete_job_application Removes a specific job application record from the system. ### get_job_application Pulls all detailed information, notes, and source data for one single job application. ### get_vacancy Retrieves detailed information about a specific open job vacancy. ### list_job_applications Generates a list of multiple job applications, which you can filter by various criteria. ### list_vacancies Provides a full listing of all current open vacancies in the organization. ### ping Checks if your API connection to Homerun is working properly. ### update_job_application Makes changes to an existing job application, like changing the status or adding new data points. ### upload_job_application_file Attaches a file, such as a resume or assessment result, to any applicant's profile. ### upload_job_application_photo Adds an official photo to the candidate’s job application record. ## 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 John Doe (Stage: Review), Jane Smith (Stage: Interview), and Alex Brown (Stage: Review). 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... This is for 'Michael Scott'. He was sourced via LinkedIn. There is one note from the recruiter: 'Strong leadership background, highly recommended for the regional manager position'. ``` **Prompt:** ``` Update application 554433: set the stage to 'hired'. ``` **Response:** ``` Successfully updated application 554433. The candidate has been moved to the 'hired' stage. Would you like me to check if there are any other pending tasks for this vacancy? ``` ## Capabilities ### View job applications Retrieves a list of existing job applications, allowing you to filter by stage, vacancy ID, or disqualification status. ### Build new candidate profiles Creates an entirely new job application record, including personal details and social media links. ### Get specific candidate records Fetches all the complete data—notes, source information, answers to questions—for a single job application ID. ### Change candidate status Updates an existing job application’s details or moves the candidate between hiring stages (e.g., from 'review' to 'interview'). ### Upload files and photos Attaches resumes, assignments, or headshots directly to a specific job application record. ## Use Cases ### Need a quick status report on open roles. A recruiter asks their agent: 'List all active job applications for vacancy ID 123.' The agent returns three names and their current stage, letting the recruiter know instantly who to follow up with before opening any dashboards. ### Interview notes need centralizing. A hiring manager finishes an interview. Instead of emailing a note back to HR, they tell their agent: 'Add a note to John Doe's application saying he needs more experience in X.' The note is instantly attached and searchable on the profile. ### Need to clean up stale accounts. An operations lead wants to remove several expired job applications. They simply ask their agent to run a cleanup command, executing the delete_job_application tool for multiple records at once. ### Candidate data needs refreshing. When an applicant submits a new portfolio piece, the recruiter uses the upload job application file tool through the chat. The agent links the file directly to the correct profile and notifies the hiring team. ## Benefits - Stop switching tabs. Instead of jumping between the vacancy dashboard and candidate records, you can ask your agent to list all job applications for a specific role ID and get results instantly. - Keep detailed notes without manual data entry. Use the tool that creates a new note on a job application when reviewing an interview, ensuring context is attached immediately. - Manage full compliance with record keeping. You can retrieve complete metadata for any job application, finding not just the name but also the source and historical notes in one query. - Handle candidate onboarding in conversation. When hiring someone, you can create a new job application, update its status to 'hired,' and even upload their official photo—all in sequence. - Stay organized when records change. If an applicant leaves or if data needs updating, you don't have to manually delete old records; your agent handles that cleanup for you. ## How It Works The bottom line is that you treat complex ATS management like a simple conversation with your agent. 1. First, subscribe to this MCP in Vinkius and provide your Homerun API key. 2. Next, reference the MCP within your AI client prompt, telling it exactly which hiring task you need done. 3. Finally, your agent executes the request against Homerun, confirming the action—like updating an application or listing candidates—right in the chat. ## Frequently Asked Questions **How does Homerun MCP help with candidate tracking?** It lets you run a query through your agent to list all job applications and apply advanced filters by stage or vacancy ID. You don't need to manually filter tables. **Can I add notes using Homerun MCP?** Yes, you can use the tool that creates a new note on a job application. This ensures all commentary stays linked directly to the specific candidate record for historical accuracy. **Is Homerun MCP just for viewing data?** No, it's fully actionable. You can also update job applications and create new ones from scratch using your agent without accessing the full web interface. **What if I need to upload a resume or photo?** You use the specific tools for uploading files or photos, linking those assets directly to an existing job application record through your chat conversation. **How do I start using Homerun MCP?** Start by subscribing to this MCP in Vinkius and providing your API key. Then, you can begin asking your agent questions about vacancies or applications immediately.