# Join MCP for AI Agents AI Agent Connect

> Join MCP lets you manage your entire hiring pipeline. It handles job listings, candidate profiles, and applicant tracking directly through the JOIN API. Use it to pull candidate data, check job statuses, or organize departments without leaving your AI client.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_d2OYxPKoOH5YH2SjjRMim5rb5SOMzWHRNXv7dT0v/ai-agent-connect
- **Tags:** hiring, job-boards, applicant-tracking, recruitment, talent-acquisition

## Description

Managing a hiring pipeline usually means jumping between tabs to check who applied for what and where they are in the process. This Connector changes that by letting your agent do the heavy lifting for you. Instead of manually digging through a dashboard, you can ask your AI client to pull up a specific candidate's profile or summarize the latest applications for a high-priority role. It pulls in everything from job requirements to internal notes and department structures. You can use it to keep your recruiting workflow moving while you focus on actual interviewing. It's one of the many specialized connectors available in the Vinkius catalog that makes it easy to connect your HR tools to your daily workspace. You get a clear view of your talent pool and can move candidates through the pipeline with just a few prompts.

## Tools

### get_job
Pulls descriptions, requirements, and internal metadata for a specific role. Use this to analyze the specifics of a position.

### get_me
Verifies your identity and checks the connection health of your authenticated session. Use this to ensure your connection is active.

### list_applications
Shows candidate summaries and basic info for all job applications. This is essential for monitoring recent applicant flow.

### list_candidates
Lists all candidate profiles, contact info, and job associations. Use this for bulk talent management tasks.

### list_departments
Lists all organization departments. Use this to filter jobs or organize your recruiting workspace by functional areas.

### list_jobs
Returns job titles, IDs, and current statuses. Use this as the primary entry point to see your hiring pipeline.

### get_application
Fetches answers to form questions, internal notes, and application status for a specific applicant. This helps you evaluate a candidate quickly.

### get_candidate
Retrieves full profile details for a specific candidate. Use this for detailed vetting and interview preparation.

### list_locations
Lists all job locations. Use this when you need to audit region-based recruiting data or specific geographic reach.

### list_users
Lists all users in your JOIN account. This is useful for identifying hiring managers and checking account permissions.

## Prompt Examples

**Prompt:** 
```
Who are the top candidates for our new engineering roles?
```

**Response:** 
```
I've pulled the latest candidates for the Engineering department. Here is a summary of the top leads:

| Candidate Name | Status | Key Notes |
| :--- | :--- | :--- |
| **Alex Rivera** | Interviewing | Strong backend experience; preferred location.
| **Jordan Smith** | Reviewing | Excellent portfolio; currently in initial screening.
| **Casey Chen** | Applied | Recently submitted; high-priority follow-up.

Would you like me to pull the full profile for any of these candidates?
```

**Prompt:** 
```
Give me a summary of the latest applications for the Sales department.
```

**Response:** 
```
I've reviewed the recent applications for the Sales department. Here is what's coming in:

* **Recent Volume:** 12 new applications in the last 48 hours.
* **Top Locations:** Most applicants are coming from the **New York** and **Austin** regions.
* **Status Update:** 8 applications are currently in the 'New' status and need review.

I can pull a detailed list of these 8 applications if you'd like.
```

**Prompt:** 
```
What are the requirements for the Senior Designer job?
```

**Response:** 
```
Here are the requirements and metadata for the **Senior Designer** role:

**Key Requirements:**
* 5+ years of experience in UI/UX design.
* Proficiency in Figma and Adobe Creative Suite.
* Experience leading design sprints.

**Internal Metadata:**
* **Department:** Design
* **Location:** Remote
* **Status:** Active
```

## Capabilities

### Pull candidate profiles
Get full details on applicants for vetting and interview preparation.

### Track job postings
See all open roles, their unique IDs, and current hiring statuses.

### Monitor applications
View candidate summaries and basic info for recent leads in the recruitment process.

### Audit job locations
List all geographic regions where you have active job postings.

### Identify hiring managers
List all users in your account to find the right stakeholders for specific roles.

### Organize departments
View your organization's functional areas to filter job data by team.

## Use Cases

### Preparing for a live interview
A recruiter needs to prep for a 2 PM interview. They ask the agent to pull the profile for a candidate using get_candidate.

### Summarizing recent applicant flow
An HR lead needs to see how many people applied for the Engineering roles. They ask the agent for a summary of recent applications using list_applications.

### Reviewing role requirements
A manager wants to know what the requirements are for a new sales role. They ask the agent to fetch the job description using get_job.

### Auditing hiring permissions
A user needs to know who has permission to see certain hiring data. They ask the agent to see the list of users in the account using list_users.

## Benefits

- Stop manual data entry by using list_candidates to pull entire talent pools into your workspace instantly.
- Speed up candidate vetting by using get_candidate to pull full profiles and internal notes into a single view.
- Keep your team aligned by using list_departments to organize your recruiting workspace by functional area.
- Monitor your hiring pipeline in real time with list_jobs to see exactly which roles are still open.
- Get instant answers to applicant questions by using get_application to see specific form responses and internal notes.
- Audit your geographic reach easily with list_locations to see where your jobs are actually posted.

## How It Works

The bottom line is you can manage your entire recruitment pipeline through a simple conversation with your AI client.

1. Connect your JOIN API credentials to your AI client via the Vinkius platform.
2. Ask your agent to perform actions like listing jobs or fetching candidate details.
3. Receive structured data back to help you make hiring decisions faster.

## Frequently Asked Questions

**Can Join MCP help me manage my hiring pipeline?**
Yes, it connects to your hiring platform to pull job data and candidate info directly into your AI client conversation.

**How does Join MCP handle candidate details?**
It retrieves full candidate profiles, including internal notes and form answers, making it easy to vet applicants without switching tabs.

**Can I use Join MCP to see which departments are hiring?**
Yes, the Connector can list all organization departments, which helps you organize your recruiting workspace and filter job data.

**Does Join MCP work with my existing JOIN account?**
It connects directly to your existing account via the API, so all your current data stays synced with your AI client.

**Can I use Join MCP to find hiring managers?**
Yes, it can list all users in your account, allowing your agent to identify the correct hiring managers and stakeholders for you.

**How does Join MCP help with job auditing?**
It allows you to quickly list all job locations and statuses, providing a clear picture of your hiring footprint across different regions.

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

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