# HRBlade MCP

> HRBlade. Manage your entire candidate pipeline—from initial job posting to final video review—using a unified ATS that integrates directly with your AI agent. This server lets you create interview templates, send personalized video invitations, and review candidate responses without leaving your chat window.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** video-interviewing, candidate-screening, hiring-pipeline, asynchronous-communication, interview-templates

## Description

You're running a hiring pipeline, and you need to manage it all in one spot. The HRBlade MCP Server lets your AI agent handle everything from building interview templates to reviewing video responses, so you don't have to jump between tabs. You'll get a full overview of your candidates and the status of your interviews, right in your chat window. 

**Manage Interview Templates:** You can use `create_interview` to build a new interview template, letting you specify custom questions, time limits, and instructions. Need to see what you've got? Use `list_interviews` to pull up a list of all existing interview templates. 

**Track Candidate Progress:** You can see who's in the mix by running `list_candidates` to get a list of everyone in the recruitment pipeline. For deep dives, use `get_candidate_details` to fetch specific, detailed info on any candidate's profile. 

**Coordinate Interview Scheduling:** To get someone started, use `send_interview_invitation` to send a personalized video interview invitation straight to a candidate's email, complete with custom instructions. 

**Review Video Responses:** You can use `list_interview_responses` to list every video response submitted by candidates for you to review. You'll also use `list_interview_responses` to see all the video responses submitted by candidates for you to review. This lets you evaluate candidate answers and performance metrics right here.

## Tools

### create_interview
Builds a new interview template, specifying questions, time limits, and instructions.

### get_candidate_details
Retrieves specific, deep information about an individual candidate.

### list_candidates
Lists all candidates currently in the recruitment pipeline.

### list_interview_responses
Lists all video responses submitted by candidates for review.

### list_interviews
Retrieves a full list of all existing interview templates.

### send_interview_invitation
Sends a personalized video interview invitation to a specific candidate's email address.

## Prompt Examples

**Prompt:** 
```
Create a 'Senior Developer' interview with 3 technical questions and send it to 2 candidates.
```

**Response:** 
```
Interview template created! Title: 'Senior Developer — Technical Screen', ID: int_4521. Questions: 1) 'Describe your approach to designing scalable microservices architectures.' (3 min limit). 2) 'Walk us through how you would debug a production performance issue.' (3 min). 3) 'Explain a complex technical decision you made recently and the trade-offs involved.' (3 min). Invitations sent: 1) sarah.chen@email.com (Sarah Chen) — ✅ Invitation delivered. 2) mike.torres@email.com (Mike Torres) — ✅ Invitation delivered. Both candidates will receive a link to record their video responses at their convenience. You now have 8 active interview templates. Would you like to review pending responses?
```

**Prompt:** 
```
Show all candidates in my pipeline and the latest video responses.
```

**Response:** 
```
Your pipeline: 24 candidates total. By status: Invited (8), Responded (12), Reviewed (3), Hired (1). Latest video responses: 1) Ana Costa — 'Product Manager' interview, submitted 2 hours ago. 3 answers recorded (avg 2:15 each). 2) James Rodriguez — 'Senior Developer' interview, submitted yesterday. 3 answers (avg 2:45). 3) Lisa Park — 'UX Designer' interview, submitted 2 days ago. 4 answers (avg 1:50). Pending invitations: 5 candidates haven't opened their invitation yet. Would you like to get details for a specific candidate or send reminders?
```

**Prompt:** 
```
List all interview templates and show which ones have pending responses to review.
```

**Response:** 
```
Interview templates: 8 total. Active: 1) 'Senior Developer — Technical Screen' (int_4521, 3 questions, 12 invited, 8 responded, 4 pending review). 2) 'Product Manager — Case Study' (int_4518, 4 questions, 8 invited, 6 responded, 3 pending). 3) 'UX Designer — Portfolio Review' (int_4515, 5 questions, 6 invited, 5 responded, 2 pending). 4) 'Sales Rep — Pitch Exercise' (int_4510, 3 questions, 15 invited, 10 responded, 5 pending). Archived: 4 templates. Total pending reviews: 14 video responses. Would you like to start reviewing or create a new template?
```

## Capabilities

### Manage Interview Templates
Create and list structured interview templates, defining custom questions and time limits for specific roles.

### Track Candidate Progress
List all candidates in the pipeline and retrieve specific profile details, giving a full status overview.

### Coordinate Interview Scheduling
Send personalized video interview invitations to candidates via email, including custom instructions.

### Review Video Responses
List and review all submitted video responses, allowing you to evaluate candidate answers and performance metrics.

### List Available Interviews
Retrieve a list of all existing interview templates currently stored in the system.

### Get Candidate Details
Fetch specific, deep details for any candidate profile in the system.

## Use Cases

### The First-Time Screener Needs a Template
A recruiter needs a technical screen for 'Data Scientist' but doesn't know how. They ask their agent: 'Create a 'Data Scientist' interview with 3 questions.' The agent uses `create_interview` to build the template instantly, which the recruiter then uses for subsequent candidate outreach.

### Checking Status on a High-Volume Day
A hiring manager needs to know the status of 50 candidates. They ask: 'List all candidates and the latest responses.' The agent runs `list_candidates` and `list_interview_responses`, providing a consolidated report showing who responded, who is pending, and who is hired.

### Following Up on a Specific Candidate
A recruiter needs to check Sarah Chen's full background. They ask the agent to use `get_candidate_details` for Sarah Chen. The agent pulls the full profile, allowing the recruiter to assess her status without navigating away from their workflow.

### Mass Outreach for a Role Launch
A team launches a new role and needs to invite 20 people. They prompt the agent: 'Send an invitation for the 'Product Manager' role to this list of 20 emails.' The agent uses `send_interview_invitation` for mass coordination.

## Benefits

- Review performance instantly. Use `list_interview_responses` to pull all video responses and evaluate candidate answers right from the agent chat, skipping the dashboard.
- Scale your screening. Automate the setup by using `create_interview` to build complex templates with custom questions and time limits for any role.
- Stay coordinated. Send invitations using `send_interview_invitation` with personalized details, ensuring every candidate gets the right prompt.
- Keep track of everyone. Run `list_candidates` to get a real-time roster of every person in the pipeline, plus `get_candidate_details` for deep background checks.
- Never lose a template. Use `list_interviews` to see every single template you've ever created, so you know exactly what's available.

## How It Works

The bottom line is you manage the entire candidate lifecycle by talking to your AI agent, never leaving your chat window.

1. Subscribe to the HRBlade server and provide your API key in your agent's settings.
2. Tell your agent what you need to do (e.g., 'List all candidates who responded last week' or 'Create a new template for Product Manager').
3. The agent executes the required tool calls, pulling data from HRBlade and presenting the results directly in your chat.

## Frequently Asked Questions

**How do I use the `send_interview_invitation` tool with HRBlade?**
You pass the required candidate data (email, name) to your agent, and it sends the personalized video link. This tool sends invitations directly to the candidate's email address.

**Can I use `create_interview` to build a template for a new job?**
Yes, `create_interview` lets you define a new template by title, and crucially, by specifying custom questions and time limits. This establishes a single source of truth for that role's assessment.

**What does `list_interview_responses` actually show me?**
This tool lists all video responses submitted by candidates. It helps you review candidate answers and evaluate their performance metrics from the chat.

**Can I track a candidate's full history using `get_candidate_details`?**
Yes. `get_candidate_details` pulls a full profile of a candidate, giving you a comprehensive view of their status and history within the HRBlade system.

**How do I list all potential interview templates using the `list_interviews` tool?**
It shows every template you've created. This tool returns the titles, IDs, and current status of all templates, letting you see what's active or archived.

**What information does `list_candidates` provide about my candidate pool?**
It gives a comprehensive list of every candidate. You get basic details, their current status (e.g., Invited, Responded), and when they were last active in the pipeline.

**If I use `send_interview_invitation`, what format should the JSON data be in?**
The JSON needs candidate details, the specific interview template ID, and the email address. If any of these are missing, the tool will fail, so check your inputs first.

**Is there a way to check a candidate's status using `get_candidate_details`?**
Yes, it reports the candidate's current stage in the hiring pipeline. You'll see their last recorded status, the associated job title, and their overall progress.

**Can I create an interview template and send invitations to candidates?**
Yes. Use `create_interview` with a JSON payload containing the title, description, and an array of questions. Then use `send_interview_invitation` with the candidate's email, first name, last name, and the interview ID. The candidate will receive an email with a link to record their video responses.

**Can I review all video responses submitted by candidates?**
Yes. The `list_interview_responses` tool retrieves all submitted video responses with candidate details, interview template reference, and submission timestamps. Use `get_candidate_details` to inspect a specific candidate's full profile and response history.

**How does asynchronous video interviewing work with HRBlade?**
HRBlade enables one-way video interviews where candidates record responses at their own pace. You create a template with questions, send an invitation, and the candidate records video answers through a web link. You can then review all responses asynchronously without scheduling live calls. Use `list_interviews` to see all templates and `list_candidates` to track your pipeline.