# Pinpoint MCP

> Pinpoint MCP automates your entire recruitment lifecycle, letting you manage jobs, track applications, and update candidate records directly through natural conversation with any AI agent. Stop jumping between tabs; get real-time data on job postings, interview schedules, and pipeline status from one place.

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

## Description

Connecting Pinpoint to your AI client turns your communication tool into a dedicated recruitment coordinator. Instead of logging into the ATS to check statuses or build reports, you just ask your agent. You can quickly list active jobs across departments or fetch all application metadata for a candidate based on their stage in the pipeline. Need an update? Your agent handles that too; you can revise job seeker records or update existing applications without navigating complex forms. This gives recruiters and hiring managers immediate access to everything from department structures to interview schedules, keeping everyone aligned. You get instant visibility into your talent funnel, whether you’re listing all current requisitions or checking out public job postings for company awareness. It's like having a senior HR ops specialist sitting right next to you.

This capability is managed through the Vinkius catalog, giving your AI client access to hundreds of other specialized tools when you need them.

## Tools

### create_application
Builds a new job application record in the system.

### create_job_seeker
Adds a brand-new individual to your pool of prospective candidates.

### create_job
Establishes a new job opening within the company records.

### create_requisition
Generates a formal internal request for a specific role.

### delete_application
Removes an application record from the system.

### delete_job_seeker
Permanently removes a job seeker's profile data.

### delete_job
Deactivates and deletes an existing job posting.

### delete_requisition
Removes a formal hiring requisition from the system.

### delete_user
Deletes an active user account within Pinpoint.

### get_application
Retrieves all specific details for one application ID.

### get_candidate
Fetches the full profile and metadata for a candidate by name or ID.

### get_department
Gets details on any specific company department.

### get_division
Fetches information about a specific business division.

### get_interview
Retrieves the full schedule and details for one scheduled interview.

### get_job_seeker
Gets all known information about a job seeker profile.

### get_job
Retrieves the full description and status of any specific open job role.

### get_location
Gets details for a physical office location or site.

### get_public_postings
Shows the company's current public job postings without needing an API key, just your subdomain.

### get_requisition
Retrieves all details for a specific internal hiring requisition ID.

### get_user
Fetches the profile information for any user account in Pinpoint.

### list_applications
Retrieves a list of all applications currently stored in your system.

### list_candidates
Provides an overview and summary list of all job candidates.

### list_custom_attributes
Lists the specialized data fields you use to track candidate information.

### list_departments
Retrieves a list of all departments set up in your company structure.

### list_divisions
Provides an overview and listing of all business divisions.

### list_interviews
Lists all scheduled interviews across the entire organization.

### list_job_seekers
Retrieves a list summary of every job seeker profile you have on file.

### list_jobs
Lists all open jobs, allowing filtering by status, visibility, department, or location.

### list_locations
Provides a list of every physical work location you manage.

### list_onboarding_applications
Lists applications specifically related to new employee onboarding paperwork.

### list_questions
Retrieves a list of standard interview questions used by the company.

### list_requisitions
Lists all formal hiring requisitions, providing status and details for each one.

### list_scorecards
Provides a list of standardized evaluation forms used during the interview process.

### list_users
Lists all user accounts that have access to Pinpoint.

### update_application
Changes or corrects details for an existing application record.

### update_candidate
Modifies the general profile information of a job candidate.

### update_interview
Makes changes to an already scheduled interview event.

### update_job_seeker
Updates the personal contact or background details of a job seeker.

### update_job
Modifies the description, status, or requirements of an active job posting.

### update_requisition
Updates the details on a formal hiring requisition after initial creation.

### update_user
Changes user permissions or personal data for an internal employee account.

## Prompt Examples

**Prompt:** 
```
List all active jobs in the Engineering department.
```

**Response:** 
```
I've found 3 active jobs in Engineering: 'Senior Backend Engineer' (ID: 101), 'DevOps Lead' (ID: 105), and 'Frontend Developer' (ID: 110). Would you like more details on any of these?
```

**Prompt:** 
```
Show me the details for application ID 55443.
```

**Response:** 
```
Application 55443 is for the 'Product Manager' role. The candidate is currently in the 'Interview' stage. The last update was 2 days ago. Should I list the scheduled interviews for this candidate?
```

**Prompt:** 
```
Get the interview schedule for candidate ID 9988.
```

**Response:** 
```
Candidate 9988 has one upcoming interview: 'Technical Round' scheduled for tomorrow at 10:00 AM with the Engineering team. Would you like to see the scorecard requirements?
```

## Capabilities

### Manage Job Postings and Vacancies
You can list all active jobs across various departments or create new job postings and requisitions in the system.

### Track Candidate Progress
Retrieve full application details, filter candidates by their current stage (applied, interview, hired), or update candidate profiles directly from your chat interface.

### Coordinate Interviews and Teams
List existing interview schedules, fetch specific interview details, or query organizational structures like departments and divisions to ensure the hiring team is aligned.

### Handle Core Records
Create new job seekers or applications, delete outdated records, or get detailed information on any user, job, or location record.

## Use Cases

### Need to assess 50 applications for the Product Manager role.
Instead of running reports and manually checking each file, you ask your agent to list all applications. Then, you tell it to get candidate details for those who haven't been interviewed yet. The system pulls up the necessary metadata instantly.

### A hiring manager needs to know if a role is still open.
The manager asks their agent for all active jobs in Engineering. The agent runs `list_jobs` and immediately tells them which roles are visible and require attention, saving the manager from checking department by department.

### A recruiter needs to correct an applicant's phone number.
The recruiter doesn't need to navigate to the profile. They simply tell their agent to update the job seeker record with the new phone number, using `update_job_seeker`.

### HR Ops needs a full overview of all open positions for Q3.
The specialist asks the agent to list all requisitions. The agent runs `list_requisitions`, providing a clean summary that helps them plan resource allocation across divisions.

## Benefits

- You get immediate visibility into job requirements and application statuses. Instead of opening the ATS to check a specific role, you ask your agent, and it pulls up details for any job using `get_job` or listing all openings via `list_jobs`.
- The system handles candidate data updates automatically. You can update candidate profiles or revise existing applications using `update_candidate` or `update_application`, telling your agent what to change instead of clicking through forms.
- Coordination is effortless. If you need to see the next steps for a hire, your agent lists all scheduled interviews (`list_interviews`) and fetches details for any specific meeting with `get_interview`. No more checking calendars manually.
- Data reporting becomes instant. You can query organizational structure by listing departments or divisions, which helps HR Ops staff plan future hiring needs without manual data gathering.
- The workflow stays contained. Whether you're creating a new job (`create_job`) or onboarding a new employee with `list_onboarding_applications`, all actions stay within your conversation tool.

## How It Works

The bottom line is you get instant access to deep ATS data without leaving your conversation window.

1. Subscribe to this MCP and provide your Pinpoint API Key and Subdomain.
2. Connect the service to your preferred AI client (Claude, Cursor, Windsurf, etc.).
3. Ask your agent questions like, 'List all open roles in Engineering' or 'What is the status of application 55443?'

## Frequently Asked Questions

**How do I list active jobs using the Pinpoint MCP?**
You ask your agent to list all open roles. It uses `list_jobs` and provides a filterable summary, allowing you to see which departments currently have vacancies.

**Can Pinpoint MCP update candidate records?**
Yes. You can use the tool to modify general profile information or correct specific details using `update_candidate`, ensuring your data stays current without manual input.

**Does this MCP help me schedule interviews?**
It helps you manage them. By calling `list_interviews` and `get_interview`, you can check the schedule and details, keeping the whole hiring team aligned on timing.

**What if I need to find public job postings?**
You can use the `get_public_postings` tool. It retrieves what's currently visible outside your system without needing an API key, just your subdomain.

**Can Pinpoint MCP create new hires records?**
Yes, you can initiate this by using `create_job_seeker`, which adds a brand-new profile to your candidate pool so the hiring team can start tracking them.