# Flatwork ATS MCP for AI Agents AI Agent Connect

> Flatwork ATS MCP lets you manage your entire hiring pipeline through an AI agent. It handles job postings, candidate profiles, and application stages without you having to jump between tabs. You can create new applicants from external data, update statuses like "Interview" or "Hired," and monitor your recruitment flow in real-time.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_BpmNpv1flpIuPUg5JAwa39CddXbBDCverLUwwSxw/ai-agent-connect
- **Tags:** hiring-pipeline, candidate-tracking, job-postings, recruitment-automation, talent-acquisition

## Description

Managing a high-volume hiring pipeline usually means staying glued to a dashboard, constantly refreshing tabs to see if a candidate moved from "Applied" to "Interview." This Connector changes that by letting your AI agent do the heavy lifting. Instead of manually updating statuses or digging through spreadsheets to find a specific applicant's phone number, you just tell your agent what needs to happen. It pulls the data you need and pushes the updates into Flatwork ATS automatically. It's a huge time saver for teams that need to keep things moving without the administrative overhead. By connecting this to the Vinkius catalog, you get a centralized way to handle everything from job orchestration to candidate discovery. You can create new profiles on the fly or check your webhook configurations to make sure your HR tools are staying in sync. It turns your AI into a dedicated recruitment coordinator that knows your specific hiring workflow inside and out.

## Tools

### get_job
Retrieve all the metadata and requirements for a specific job posting. It helps you see who is hiring and what they need.

### list_applicants
Get a full list of every candidate currently in your system. This is great for auditing your total talent pool.

### list_applications
See every job application across all your active postings. Use this to get a sense of the volume of current activity.

### list_jobs
View all your open and closed job postings at once. This helps you keep track of every role your team is filling.

### list_webhooks
Check your configured webhooks to ensure your HR tools are syncing correctly. This helps maintain data integrity.

### update_application_status
Change a candidate's hiring stage instantly. This is useful for moving people into interviews or marking them as hired.

### create_applicant
Add a new candidate to your database using a JSON string. This helps you ingest data from external sourcing tools.

### get_applicant
Pull specific details for a single candidate. Use this to quickly grab contact info without searching manually.

## Prompt Examples

**Prompt:** 
```
Show me all the active job postings we have right now.
```

**Response:** 
```
I've pulled your current job postings. Here are the active roles:

| Job Title | ID | Hiring Team |
| :--- | :--- | :--- |
| Senior Engineer | 101 | Engineering |
| Product Designer | 102 | Design |
| Marketing Lead | 103 | Marketing |

Would you like to see the applicants for any of these?
```

**Prompt:** 
```
Create a new candidate named Sarah Jenkins with email sarah@example.com.
```

**Response:** 
```
I've added Sarah Jenkins to your candidate database. 

**Candidate Details:**
- **Name:** Sarah Jenkins
- **Email:** sarah@example.com
- **System ID:** cand_882

Would you like to link her to an active job application?
```

**Prompt:** 
```
Move the application for ID app_987 to the Interview stage.
```

**Response:** 
```
Done! I've updated the status for application **app_987**. 

- **Previous Stage:** Applied
- **New Stage:** Interview

The candidate and the hiring team have been notified of this change in the system.
```

## Capabilities

### Update candidate hiring stages
Move applicants from one stage to another like 'Interview' or 'Rejected' with a single command.

### Create new applicants
Add new candidates to your database using external information passed as a JSON string.

### Retrieve specific candidate profiles
Get detailed contact information and profile data for any applicant in your system.

### Manage job posting metadata
Access the specific requirements and hiring team details for any job posting.

### Monitor real-time data flows
Check your configured webhooks to ensure your HR tools are syncing correctly.

### List all active and closed jobs
Get a full list of every job posting in your system to see what's currently open.

## Use Cases

### Automated Candidate Sourcing
A recruiter finds a lead on a job board and tells their agent to create a new applicant in Flatwork ATS using the lead's contact info.

### Interview Preparation
A hiring manager asks the agent to pull the profile for a specific candidate to review their experience before a 2 PM interview.

### Bulk Status Updates
An HR lead asks the agent to move five specific applications to the 'Hired' stage after a successful weekend of interviews.

### Pipeline Auditing
A manager wants to see all active job postings and their current hiring teams in a single list to prepare for a leadership meeting.

## Benefits

- Stop manual status updates by using update_application_status to move candidates through the funnel without clicking buttons.
- Build your database faster with create_applicant to ingest external sourcing data directly into your system.
- Get instant answers on job requirements by pulling data with get_job instead of searching through old PDFs.
- Keep your HR tech stack synced by checking your list_webhooks configuration to ensure real-time data flow.
- Save time on research by pulling specific profiles with get_applicant instead of digging through long candidate lists.

## How It Works

The bottom line is you stop doing manual data entry and start managing your pipeline through conversation.

1. Subscribe to the Connector and grab your API key from the Flatwork ATS settings.
2. Connect your preferred AI client to the Vinkius platform.
3. Start asking your agent to update statuses, pull candidate lists, or create new profiles.

## Frequently Asked Questions

**Can the Flatwork ATS MCP help me manage my hiring pipeline?**
Yes. It allows your AI agent to interact directly with your hiring data, letting you move candidates through stages and manage jobs using natural language.

**How does the Flatwork ATS MCP handle candidate data?**
It lets your agent pull specific details for any applicant or create new candidate profiles from external information you provide.

**Can I use the Flatwork ATS MCP to update interview statuses?**
Absolutely. You can tell your agent to move specific applications to the Interview, Hired, or Rejected stages instantly.

**Does the Flatwork ATS MCP support creating new applicants?**
Yes, you can have your agent create new candidates in the system by providing their information, which helps automate your sourcing workflow.

**Can I check my webhooks using the Flatwork ATS MCP?**
Yes, you can use the Connector to list your configured webhooks to ensure your HR tools are syncing correctly with your ATS.

**Is the Flatwork ATS MCP good for high-volume recruiting?**
It's designed for it. By automating the status updates and candidate creation, it removes the manual data entry that slows down high-volume hiring.

**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.