# Flatwork ATS MCP MCP > Flatwork ATS connects your AI agent directly to your hiring pipeline. Use this MCP to manage candidate records, track job postings, and update application statuses without leaving your chat client. It gives you full control over the entire recruitment workflow through simple conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** hiring-pipeline, candidate-tracking, job-postings, recruitment-automation, talent-acquisition ## Description Need to keep up with dozens of candidates and changing job requirements? This connector lets your AI agent take over your hiring coordination tasks. You can ask it to pull a list of all open jobs or check on a specific applicant's status across different roles, just by asking. It manages the entire candidate lifecycle, from initial data entry to marking someone as hired or rejected. It’s like having a dedicated Talent Acquisition Coordinator who lives inside your chat client. You don't have to manually navigate tabs and click through spreadsheets anymore. Everything you need—candidate profiles, job details, application status updates—is accessible in natural conversation. Once you connect it via Vinkius, your agent becomes the single source of truth for your entire recruitment process. ## Tools ### create_applicant Adds a brand new person record to the system using provided data. ### get_applicant Retrieves the full details and contact info for one specific candidate. ### get_job Fetches all the required information for a single job posting. ### list_applicants Gets a list of every person currently in your candidate database. ### list_applications Displays all the recorded job applications and their current statuses. ### list_jobs Retrieves a complete list of every active or closed job posting. ### list_webhooks Shows you all the webhooks that are set up for real-time data syncing. ### update_application_status Changes a candidate's hiring stage—for example, moving them from 'Applied' to 'Interview'. ## Prompt Examples **Prompt:** ``` List all active job postings in Flatwork ATS. ``` **Response:** ``` I've retrieved your job postings. You have 3 active positions: 'Senior Full Stack Engineer' (ID: 101), 'Product Designer' (ID: 102), and 'Marketing Lead' (ID: 103). Which one would you like to see applicants for? ``` **Prompt:** ``` Add 'John Doe' (john.doe@example.com) as a new applicant. ``` **Response:** ``` Candidate created! John Doe has been successfully added to your Flatwork database with ID 'cand_456'. Would you like to link him to an active job application now? ``` **Prompt:** ``` Move application ID 'app_987' to the 'Interview' stage. ``` **Response:** ``` Hiring stage updated! Application 'app_987' has been moved to 'Interview'. The candidate and hiring team have been notified of the stage change in the system. ``` ## Capabilities ### Manage Candidate Records Add new candidates to the system or pull up existing profile details with a simple command. ### Track Job Postings View and retrieve full metadata for any job role, including who owns it and what skills are needed. ### Monitor Applications See all active applications and update a candidate's stage (like 'Interviewing' or 'Rejected') instantly. ### Automate Candidate Sourcing Create new records for candidates using external data sources, automating your sourcing pipeline. ### Review System Health List all configured webhooks to verify that your HR tools are syncing data correctly in real time. ## Use Cases ### Interview Prep The hiring manager needs to know the job's original requirements and the candidate's full history before a meeting. They ask their agent, which uses `get_job` and then `get_applicant`, providing all necessary context instantly. ### Pipeline Clean-up A recruiter realizes several candidates need to be moved forward quickly. Instead of opening dozens of files, they use the agent to update application status for a batch of IDs using `update_application_status`. ### Sourcing Leads The TA team finds great leads outside the system. They ask the agent to create records immediately using `create_applicant`, pulling data from their CRM export and getting them into Flatwork ATS. ### Audit Trail Check An HR manager suspects a data sync failure. They run `list_webhooks` via the agent to check all configured endpoints, ensuring high-fidelity synchronization with other core business tools. ## Benefits - Instant Status Updates: Instead of logging into the platform to change a stage, you simply tell your agent to update an application status. It handles the rest. - Automated Data Entry: When sourcing new talent, you can use the `create_applicant` tool to add candidates from external data sources without manual input. - Full Job Visibility: Need to know exactly what a job requires? You can run `get_job` and instantly retrieve all detailed metadata for any posting. - Complete Candidate Directory: Stop searching through files. Use `list_applicants` or `get_applicant` to pull up full profiles and contact info immediately. - System Integrity Check: Before launching a new workflow, you can use `list_webhooks` to verify that data flows are configured correctly across all your HR tools. ## How It Works The bottom line is that your AI acts as a direct interface between your natural language requests and Flatwork ATS’s backend data. 1. First, subscribe to this MCP and get your API Key from Flatwork ATS (Settings > API). 2. Next, connect the key to your preferred AI client. Your agent now sees all available tools. 3. Finally, tell your agent what you need—for instance, 'List all active job postings' or 'Update application app_987 to Interview'. The connection handles the rest. ## Frequently Asked Questions **How do I add a new candidate using the create_applicant tool?** You pass applicant data as a JSON string. You just need to provide all required fields, like name and email, so the system can accept them. **Can I see which jobs are currently open with list_jobs?** Yes, running `list_jobs` provides a complete rundown of every job posting—whether active or closed. It’s perfect for inventorying your roles. **How do I change an application status using update_application_status?** You tell the agent which application ID and what stage you want it moved to. The tool updates the record directly in Flatwork ATS. **What is list_webhooks for?** `list_webhooks` shows you all the real-time data connections set up on your account. You check this when you need to verify that external HR tools are syncing correctly. **If I only have a candidate's ID, how do I use get_applicant to retrieve their full profile?** You pass the unique applicant ID to get_applicant. This tool pulls comprehensive details, including contact information and hiring history, so you don't have to manually look up the record. **What does list_applications show me about the overall hiring pipeline?** list_applications provides a complete snapshot of every active job application. You can review all associated jobs and their current statuses without needing to drill down into individual records first. **How do I use get_job when I need detailed metadata about a specific posting?** You pass the Job ID to get_job. This gives you deep access to job requirements, necessary skill sets, and details about the hiring team assigned to that role. **I want to see everyone in the system; how do I use list_applicants for a full candidate roster?** list_applicants retrieves basic profile data and contact info for every registered candidate. It’s perfect for auditing or when you need a quick overview of your entire pool before running targeted searches. **How do I find my Flatwork API Key?** Log in to your Flatwork account, navigate to **Settings** > **API**, and generate or copy your unique secret key. **Can I move a candidate to a custom hiring stage?** Yes! Use the `update_application_status` tool and provide the string name of your custom stage as defined in your ATS workflow. **How do I add new candidates found via LinkedIn?** Use the `create_applicant` tool and pass a JSON string containing the candidate's details like first name, last name, and email address.