Overview
The BrightHire MCP (Model Context Protocol) Connector allows AI tools to securely access and work with your BrightHire data. By connecting an MCP-compatible client (like Claude, Cursor, or others), you can query interview data, generate summaries, and analyze hiring signals directly within your AI workflows.
What is MCP?
The Model Context Protocol (MCP) is an open standard that enables AI tools to connect to external data sources in a structured and secure way.
With the BrightHire MCP connector, AI tools can retrieve and reason over:
Interview transcripts
Scorecards and interviewer feedback
AI-generated summaries
Hiring signals (strengths, concerns, recommendations)
Supported Clients
Claude (Desktop/Chat)
ChatGPT
Codex
Cursor
BrightHire Slack Agent
Claude Code
Connect with Claude (Coming Soon)
BrightHire can be connected directly within Claude, making setup quick and configuration-free.
Open Claude and navigate to Settings → Connectors
Search for BrightHire
Click Connect and sign in with your BrightHire account
You're ready to go
Once connected, Claude can access your BrightHire data to answer questions, generate summaries, and support hiring decisions.
Getting Started with OAuth (Recommended)
Most MCP-compatible clients support OAuth-based authentication. This is the simplest way to connect, as users authenticate directly with their BrightHire account—no API key required.
1. Configure the BrightHire MCP server
Add the BrightHire MCP endpoint to your MCP client configuration:
{ "brighthire": { "type": "http", "url":"https://app.brighthire.ai/mcp/v1" } }Each MCP client handles configuration differently. Some require editing a local config file, while others provide MCP settings in the UI. Refer to your client’s documentation for exact instructions.
2. Authenticate with BrightHire
When your MCP client connects for the first time, it will initiate an OAuth flow. A browser window will open prompting you to log in to your BrightHire account and approve access.
After approval, the client receives an access token that allows it to retrieve data on your behalf.
3. Start using BrightHire data
Once authentication is complete, your MCP client can begin requesting structured data from BrightHire.
You can now:
Ask questions across interviews
Generate summaries and insights
Analyze hiring trends and signals
Access is limited to data the authenticated user already has permission to view
Data is only retrieved when explicitly requested by the MCP client
OAuth tokens and API keys can be revoked at any time
BrightHire follows secure, least-privilege access principles
What can I use the BrightHire MCP integration for?
The BrightHire MCP connector enables deeper analysis and workflows across your interview data using AI tools. Common use cases include:
Review candidates across your hiring pipeline
Summarizing multiple interviews to prepare for debriefs
Analyzing interview quality or interview guide coverage
Tracking patterns such as interview volume by role or stage
These workflows allow teams to move faster and make more informed hiring decisions directly within their AI tools.
What data can the MCP integration access?
The MCP connector provides access to data stored in BrightHire, including:
Interview transcripts and interview guides
Scorecards and interviewer feedback
AI-generated summaries and insights for interviews and candidates
Metadata (e.g., role, interviewer, stage, date)
Access through MCP follows the same permission model as BrightHire. Users can only access data they already have permission to view.
Available MCP Tools
🔍 Search & Discovery
search — The main entry point. Search interviews using filters like candidate name, interviewer, position, department, stage, date range, outcome, call type, and more. Returns interview metadata including call IDs you can pass to other tools.
get_scheduled_interviews — Fetch upcoming scheduled interviews (defaults to next 7 days). Can filter by candidate name or position title, and scope to just your own interviews or your whole org.
📋 Interview Prep
get_interview_context — Get full prep context for a scheduled interview: start time, candidate/position metadata, interview guide, and candidate summary. Takes a scheduled_interview_id.
get_interview_guide — Retrieve the interview guide(s) for one or more scheduled interviews (up to 20 at once).
📝 Post-Interview Content
get_interview_summary — Get a post-interview summary for a single interview: interviewer notes, emoji reactions (thumbs up/down, stars, flags), and action links (BrightHire URL, share URL, ATS scorecard URL).
get_call_ai_notes — Fetch AI-generated Q&A pairs extracted from the transcript for up to 20 interviews at once. Much lighter than full transcripts. Supports filtering by keyword or speaker type (candidate vs. interviewer).
get_transcripts — Pull full verbatim transcripts and user-created call notes for up to 20 interviews. Large payload — best used when you need exact wording rather than summaries.
get_candidate_summary — Get the most recent candidate summary notes for a candidate.
📊 Evaluation & Scoring
get_scorecards — Retrieve ATS scorecards (overall recommendation, attributes, questions) for up to 20 interviews. Can query by call_ids or by candidate_id + position_id.
get_job_description — Get the job description for a position using its position_id (found in search results). Useful for evaluating candidate fit against actual role requirements.
🏋️ Coaching
get_coaching_report — Returns your personal AI coaching report as markdown, summarizing trends and feedback from your recent interviews. No arguments needed — it infers you from the session.
Help and troubleshooting
If you have any problems connecting your MCP client to BrightHire, please reach out to us.
Use Cases
Cross-Functional Hiring Alignment
Hiring decisions often involve multiple stakeholders (recruiting, hiring managers, execs), each with different priorities. The BrightHire MCP connector can help align everyone by synthesizing interview data into a shared, consistent narrative.
Instead of manually stitching together feedback, AI tools can pull insights across interviews and present a unified view of candidate strengths, risks, and tradeoffs tailored to different audiences.
What you can build:
A stakeholder-ready briefing that automatically adapts the same candidate data for different audiences (e.g., exec summary for leadership, detailed evaluation for hiring panels), ensuring everyone is aligned before final decisions.
Offer Risk & Close Strategy Insights
Beyond evaluating candidates, interview data contains signals about candidate intent, motivation, and potential offer risk. By analyzing language across interviews, you can identify candidates who may be hesitant, have competing priorities, or need a more tailored close.
This shifts MCP from just evaluation → conversion optimization.
What you can build:
A pre-offer risk report that highlights signals like hesitation, competing offers, compensation expectations, or misalignment—along with recommended talking points for recruiters to improve close rates.
Knowledge Capture & Interview Intelligence
Your interviews contain a huge amount of institutional knowledge—about roles, technologies, competitors, and candidate expectations. MCP allows you to systematically capture and reuse that knowledge.
This turns interviews into a continuously growing knowledge base.
What you can build:
A searchable knowledge layer across all interviews, allowing teams to quickly answer questions like:
“How are candidates talking about X tool?”
“What experience do strong candidates typically have in Y domain?”
“How have I been selling [company name] this month?”
Example: How are BrightHire Engineering Candidates talking about AI?
Example Prompt - Offer Risk & Close Strategy Insights
Review all interview data for candidate Joe Brown and generate an offer risk and close strategy brief:
Include:
Key motivation drivers (what this candidate cares about most)
Signals of risk (hesitation, concerns, competing offers, misalignment)
Confidence level in offer acceptance (high / medium / low, with rationale)
Recommended closing strategy (talking points, areas to emphasize, potential objections to address)
Keep the output concise and actionable for a recruiter preparing to extend an offer
Use the attached rubric and company values documents to help create the brief



