Skip to main content

BrightHire MCP

Written by Jennifer Steinker

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


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

Enable the MCP Server in BrightHire

Most MCP-compatible AI tools support OAuth authentication, which means you can sign in with your BrightHire account directly—no API key required.

To get started, add the BrightHire MCP server to your AI assistant's MCP or Connectors settings. Depending on the tool you're using, this may be called Connectors, Integrations, Apps, Tools, or MCP Servers.

Use the following BrightHire MCP endpoint:

{
"brighthire": {
"type": "http",
"url": "https://app.brighthire.ai/mcp/v1"
}
}

Note: Every AI client handles MCP setup differently. Some tools provide a user interface where you can add a connector, while others require updating a configuration file. Refer to your AI client's documentation for specific instructions.

Examples:

  • ChatGPT: Add a custom MCP connector in your workspace settings.

  • Claude: Add a custom connector from the Connectors settings page.

  • Other MCP clients: Add the BrightHire MCP endpoint using the client's MCP configuration process.

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

Connect with Claude (Coming Soon)

BrightHire can be connected directly within Claude, making setup quick and configuration-free.

  1. Open Claude and navigate to Settings → Connectors

  2. Search for BrightHire

  3. Click Connect and sign in with your BrightHire account

  4. You're ready to go

Once connected, Claude can access your BrightHire data to answer questions, generate summaries, and support hiring decisions.

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

Output


FAQ:

Q: Does the BrightHire MCP Provide Access to Screen Data?

A: No. The BrightHire MCP does not currently provide access to Screen product data.

Q. Will Brighthire data getting stored locally on someone's machine automatically?

A: No, BrightHire does not automatically store your interview recordings/transcripts “locally on someone’s machine” as a product behavior—the system of record is BrightHire’s cloud, though the user’s browser/meeting app may temporarily cache data during normal operation.

BrightHire retention is controlled by org Data Retention, and some orgs can be configured for transcript-only (audio/video deleted after transcription).

Q: By enabling :brighthire: MCP, are we enabling all use cases, including ones which involve local versus secured cloud storage?

A: Enabling the BrightHire MCP enables MCP access to BrightHire data via our secured cloud API; it doesn’t “turn on” a separate local-storage mode.

The MCP client you connect (e.g., Cursor/Claude Desktop) may store conversation context locally depending on that vendor’s settings. (Customer-controlled)

Did this answer your question?