# Fountain MCP > Fountain automates high-volume hiring pipelines and manages the entire applicant lifecycle through your AI agent. It lets you track job openings, monitor progress against hiring goals, and manage detailed worker profiles conversationally. If you handle recruiting or workforce management, this MCP gives you instant oversight of every candidate stage. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** hiring-automation, applicant-tracking, workforce-management, onboarding, high-volume-hiring, talent-acquisition ## Description Fountain connects to your existing account to automate how you find, vet, and onboard new employees. Instead of clicking through multiple dashboards just to see where a candidate stands, you talk to your agent. Your AI client handles the complex logic: listing all candidates, checking who is stuck in a funnel stage, or pulling up historical notes on specific profiles. You get a full picture of your talent pipeline—from initial job post creation right down to final onboarding status. Using this MCP through Vinkius means you don't have to switch between systems; everything happens inside your chat window. It makes managing huge hiring volumes simple and immediate. ## Tools ### get_account_details Retrieves core attributes about your organization's Fountain account setup. ### get_applicant Fetches the full, detailed profile and history for a specific job applicant. ### get_opening_details Retrieves comprehensive metadata about a specific active job opening. ### list_applicant_notes Fetches the discussion or notes left on a particular applicant's record. ### list_applicants Lists every job applicant currently in your system, making it easy to see who applied and when. ### list_funnels Shows a list of all hiring funnels you use within the company. ### list_hiring_goals Retrieves a summary and status report for your defined corporate hiring targets. ### list_interview_sessions Lists all scheduled interviews, helping you manage calendars and coordination. ### list_job_posts Retrieves a list of job postings that have been published across different channels. ### list_openings Lists all active, current job openings available in the system. ### list_funnel_stages Shows the specific steps or stages that belong to a given hiring funnel. ### list_workers Provides a list of individuals who have successfully completed the entire hiring process and are now employees. ## Prompt Examples **Prompt:** ``` List all active job openings in Fountain. ``` **Response:** ``` Retrieving openings... I found 5 active job positions, including 'Delivery Driver' and 'Warehouse Associate'. Would you like to see the details for any of these? ``` **Prompt:** ``` Show me the last 10 applicants for the 'Delivery' funnel. ``` **Response:** ``` Fetching applicants... I found 10 recent submissions for the 'Delivery' funnel. 3 are currently in the 'Interview' stage and 2 are in 'Background Check'. ``` **Prompt:** ``` Get the hiring goals summary for this quarter. ``` **Response:** ``` Retrieving goals... You are currently at 75% of your 'Warehouse Hiring' goal and 90% of your 'Customer Support' target for this quarter. ``` ## Capabilities ### List all candidates Retrieve a comprehensive list of every applicant in your system, allowing filtering by funnel or email. ### Get individual candidate details Fetch deep information about any single applicant, including their full profile and past transition history. ### View organizational goals Pull current metrics to see how far along you are toward specific hiring targets for the quarter or year. ### Manage job pipeline stages See and list all defined funnels and the specific steps (stages) within them, giving a clear view of process health. ### Oversee active roles List every live job opening and pull detailed metadata about the requirements or status for those positions. ### Check interview schedules Access a list of all interviews that are currently scheduled across your organization's teams. ## Use Cases ### Identifying a Funnel Bottleneck A recruiter notices that 40% of applicants are getting stuck between the 'Screening Call' stage and the 'Technical Assessment.' They ask their agent to list funnel stages, which confirms the bottleneck. They then use list_applicants to pull those specific profiles for review, allowing them to adjust training or process steps. ### Quarterly Goal Review The hiring manager needs a quick status update without pulling reports. They ask their agent about the quarterly goals summary. The MCP immediately returns data showing progress against targets, letting them know exactly which departments are falling behind. ### New Role Setup and Compliance A department head needs to launch a new role. Instead of manually setting up job details, they ask the agent to list active job openings. They grab the required metadata using get_opening_details for compliance checks before posting. ### Onboarding Follow-up The HR team needs to know who actually finished hiring last month. The agent runs a query using list_workers, giving them a clean list of successful hires and their start dates for payroll processing. ## Benefits - Instant Visibility: Instead of clicking through multiple tabs to see who applied, use list_applicants to get a single source of truth for every candidate in seconds. - Goal Tracking Made Easy: Stop manually calculating progress. Use list_hiring_goals to instantly check your team's performance against quarterly targets. - Process Audit Trail: Need to know why a candidate stalled? The agent can fetch the full profile using get_applicant and show you all notes via list_applicant_notes. - Job Planning Power: Before launching a role, use list_openings to ensure you have accurate metadata for every active position, preventing manual errors. - Interview Coordination: Forget calendar invites back-and-forth. Use list_interview_sessions to get an instant overview of who's meeting whom and when. ## How It Works The bottom line is you get an automated view of your entire hiring operation without leaving your chat window. 1. Subscribe to this MCP on the Vinkius Marketplace. 2. Enter your Fountain API Token (found in Company Settings > Developer Settings). 3. Start asking your agent questions, like 'Show me all applicants for Q3,' and it will pull the data immediately. ## Frequently Asked Questions **How do I use Fountain MCP to find a specific applicant's full history?** Use the get_applicant tool and provide the candidate's email address or ID. This fetches their entire profile, including all notes (list_applicant_notes) and past work transitions. **Can Fountain MCP tell me my hiring goal progress?** Yes, use list_hiring_goals to pull a summary report of your targets. It shows exactly what percentage you've hit for each defined corporate objective this quarter. **What is the difference between listing job posts and active openings with Fountain MCP?** list_job_posts gives you a list of all advertisements published, while list_openings shows only the positions that are currently marked as actively recruiting within your system. **How does Fountain MCP help me manage funnels?** You can use list_funnels to see which pipelines exist and then list_funnel_stages for a specific funnel. This helps you audit the exact steps candidates must pass through. **Do I need an API key to use Fountain MCP?** Yes, you must provide your Fountain API Token during setup. You can find this token in your company's Developer Settings area.