# JOIN MCP MCP

> The JOIN MCP lets your agent manage the entire candidate lifecycle right from your workflow. List open job postings, pull detailed profiles for candidates, and track application statuses automatically. It handles everything needed to automate talent acquisition.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** hiring, job-boards, applicant-tracking, recruitment, talent-acquisition

## Description

This MCP connects your AI client directly to the core functions of the JOIN platform. Instead of jumping between tabs or exporting CSVs just to get a hiring status update, you tell your agent what you need done. You can pull detailed job descriptions, run lists of active candidates, and fetch specific application data points like internal notes or form answers. It’s designed for people who manage high-volume hiring pipelines.

For example, you can ask your system to identify all open roles in a certain department, then find the top three candidates associated with those jobs, and finally check their most recent activity. This MCP provides that data structure right out of the gate. By connecting through Vinkius, your agent gains access to this entire catalog, making complex recruiting tasks feel like simple conversation.

## Tools

### get_application
Retrieves all details for one specific job application, including answers and notes.

### get_candidate
Pulls the full profile data for an individual candidate's record.

### get_job
Gets the description, requirements, and metadata for a specific job posting.

### get_me
Verifies your connection identity and retrieves basic account details.

### list_applications
Lists multiple applications across the system for monitoring applicant flow.

### list_candidates
Returns a comprehensive list of all candidates, including their contact info and job associations.

### list_departments
Lists every functional department (e.g., Engineering, Sales) within the organization.

### list_jobs
Provides an overview of all job postings by title and current status.

### list_locations
Retrieves a list of physical locations where jobs are available or based.

### list_users
Lists every user account connected to your JOIN system for access auditing.

## Prompt Examples

**Prompt:** 
```
List all active job postings in JOIN.
```

**Response:** 
```
I'll fetch the list of open job postings from your JOIN account.
```

**Prompt:** 
```
Show me the latest candidate applications.
```

**Response:** 
```
I'll retrieve the most recent applications across all your jobs.
```

**Prompt:** 
```
Get details for candidate ID '123'.
```

**Response:** 
```
I'll retrieve the full profile and status for that specific candidate from JOIN.
```

## Capabilities

### Find Open Job Listings
It retrieves a list of all current job postings and their status within the system.

### Review Candidate Profiles
You can pull complete profiles for any specific candidate, including contact information.

### Get Application Details
This pulls all data related to a single job application, such as answers or internal notes.

### Identify Organizational Structure
It lists every department within the organization for filtering jobs or grouping users.

### Audit User Accounts
The system provides a list of all authenticated user accounts in your JOIN instance.

## Use Cases

### Hiring Manager needs a shortlist of qualified people.
A hiring manager asks their agent, 'Find me the top 5 candidates for the Senior Dev role.' The agent calls get_job to grab requirements, then uses list_candidates and get_candidate on the best matches, delivering a vetted shortlist.

### Recruiter needs to segment applicants by location.
The recruiter asks the agent to compile all applications from California. The agent calls list_locations first to validate 'California,' then uses list_applications to pull only those records tied to that area.

### HR Ops needs an audit of job structure.
The operations manager asks the agent, 'What departments are we hiring for right now?' The agent calls list_departments and then uses list_jobs, filtering the results by department name to give a clean report.

### Checking system health after an integration failure.
The user asks the agent to verify which accounts exist in JOIN. The agent runs list_users and calls get_me just to confirm connection stability, making it easy to spot access gaps immediately.

## Benefits

- Stop manually checking statuses. Use list_applications to get a real-time count of recent applicants, letting your agent filter them by status immediately.
- Vet candidates faster than ever. Instead of opening multiple tabs, call get_candidate for full details and use get_job to compare their skills directly against the job requirements.
- Filter job roles precisely. If you need all open jobs in a specific functional area, list_departments lets your agent narrow down the search before calling list_jobs.
- Streamline onboarding data capture. Need to know who's on staff? Use list_users to audit account access and verify that every role has the correct permissions.
- Manage entire cohorts. When you need a mass report, call list_candidates to pull profiles for everyone and then use get_application to cross-reference their best work.

## How It Works

The bottom line is that your AI client executes complex recruiting queries using simple commands.

1. You tell your agent the goal, for example: 'Show me the status of applications for candidates in Sales.'
2. Your agent identifies the necessary steps, calling tools like list_departments and then get_application to gather all required data points.
3. The system returns a consolidated summary containing only the filtered candidate details you asked for.

## Frequently Asked Questions

**How do I use list_jobs with the JOIN MCP?**
You call list_jobs to pull all open job titles and IDs in your account. This is the starting point when you need an overview of your current hiring needs.

**What's the difference between get_candidate and list_candidates?**
list_candidates gives you a roster—a summary of everyone. You must use get_candidate to pull all the deep, specific details for one person only.

**Can I find out which departments exist using list_departments?**
Yes. list_departments provides a clean list of every functional area (like HR or Sales) you can use to filter jobs or users later on.

**How does get_application help with pipeline management?**
get_application pulls the granular data for one job submission, including form answers and notes. This is key for seeing exactly where a candidate stalled out in the process.

**How do I check my connection status and permissions using the get_me tool?**
Calling get_me confirms your authentication and retrieves details about the connected account. This is a quick, reliable way to validate account access before running complex data pulls like listing all users or jobs.

**What specific information does the get_job tool provide beyond just the job title?**
The get_job tool retrieves detailed descriptions, required skills, and internal metadata for a single role. Use this when your agent needs to analyze the full requirements of a posting rather than just viewing the list of open positions.

**If I need a summary view of all recent applicants, should I use list_applications?**
Yes, list_applications gives you candidate summaries and basic application info across multiple roles. This is ideal for monitoring overall applicant flow or identifying new leads quickly, which differs from getting deep details on one specific record.

**How can I find all possible job sites within the system using list_locations?**
Running list_locations retrieves a complete roster of every location where jobs are posted. Use this when you need to audit recruiting coverage or filter roles based on availability in a specific region.

**How do I get JOIN API credentials?**
Log in to your JOIN account, navigate to User Settings > API Credentials, and generate a new token.

**Can I see candidates for specific jobs?**
Yes, you can retrieve applications and candidates associated with your job postings using this MCP.

**Does it support departments and locations?**
Yes, you can list all configured departments and office locations using the corresponding tools.