---
title: Using AI Interviewer with the Ashby MCP
slug: using-ai-interviewer-with-the-ashby-mcp
createdAt: 2026-11-16T19:41:19.811Z
---

AI Interviewer works with Ashby Assistant and external AI tools connected to the Ashby Model Context Protocol (MCP) server. You can use these tools to review screening interviews, compare candidate responses, understand interviewer setup, analyze performance, and create or refine draft interview outlines. This article explains the AI Interviewer-specific workflows and boundaries. For MCP setup, supported clients, authentication, and general permissions, see [Ashby MCP Server (Beta)](https://docs.ashbyhq.com/ashby-mcp-server-beta).

:::hint{type="warning"}
**Prerequisites**

Connect an MCP-compatible client by following [Ashby MCP Server (Beta)](https://docs.ashbyhq.com/ashby-mcp-server-beta). Your organization must also have AI Interviewer enabled, and you must have AI access.
:::

:::hint{type="info"}
To understand how AI Interviewer works, see [AI Interviewer](https://docs.ashbyhq.com/ai-interviewer) .
:::

# Permissions and access

- Ashby Assistant provides read-only access to AI Interviewer information. It cannot create interviewers, create draft versions, or edit outlines.
- An external MCP client is required to create interviewers, create draft versions, or edit draft outlines.
- Viewing interviewer setup, creating interviewers, creating draft versions, and editing draft outlines require the `Administer AI Interviews` permission.
- Candidate data follows your existing Ashby permissions. AI Interviewer tools do not expose candidates, applications, transcripts, or analytics that you cannot access in Ashby.
- For general MCP connection and access requirements, see [Ashby MCP Server (Beta)](https://docs.ashbyhq.com/ashby-mcp-server-beta).

# Read AI Interviewer information

You can ask Ashby Assistant or an MCP-connected AI tool to retrieve AI Interviewer information. Read operations do not change Ashby data.

## Review a screening interview

Ask the AI tool to summarize one candidate's AI screening interview or focus on a specific part of the result. Available information includes:

- Interview status and timeline, including invitation, start, completion, decline, and abandonment details
- Decline reasons and notes left by the candidate
- The AI-generated summary, pros and cons, overall signal, and evaluation for each section and topic
- Minimum qualification results
- Integrity signals, when available, such as tab switches, time away, slow responses, fraud reports, and topic warnings
- Questions the candidate asked that the AI Interviewer could not answer
- Candidate sentiment and written feedback
- A link to open the interview in Ashby

The evaluation is the AI Interviewer's assessment. It is not the candidate's own words and does not replace human review or a hiring decision.

## Read transcripts and compare candidates

You can retrieve the full transcript of a screening interview after the candidate starts the interview. Transcripts are grouped by section and topic and include speaker names and timestamps.

To compare candidates, ask about one topic or section. The AI tool can compare that topic across up to 10 interviews without retrieving each full transcript. You can retrieve up to five full transcripts at a time.

## Find interviews and review performance

Ask the AI tool to find or filter screening interviews using fields such as:

- Status and timestamps
- Minimum qualification results
- Review status and assigned reviewer
- Decline reason
- Outcomes and related candidate, application, and job fields
- Per-topic signals

You can also ask for analytics for one AI Interviewer, including:

- Funnel counts for invited, viewed, started, completed, abandoned, and declined interviews
- Decline reasons
- Median and 90th-percentile completion time compared with the estimated length
- Advanced, rejected, and hired outcomes
- Candidate sentiment
- Topic results by interviewer version
- Recent unanswered candidate questions

Analytics can be narrowed by interviewer version, job, or invitation date range. Results include only applications that you can access.

## Review interviewer setup

With the `Administer AI Interviews` permission, you can ask an AI tool to explain an interviewer's setup, including:

- Internal title, status, and estimated length
- Published and current draft versions
- Sections, topics, questions, and topic settings
- Competency scoring bands
- Version history
- Jobs and interview stages that use the interviewer

The AI tool can return a summary or provide more detail when you need to review the outline or evaluation criteria.

# Create an AI Interviewer with an MCP client

Use an external MCP-connected AI tool to create a new AI Interviewer from a job posting or from your own instructions. Ashby Assistant cannot create an interviewer.

1. Share a job posting or describe the role, interview goals, and required qualifications.
2. Ask the AI tool to create an AI Interviewer. Provide an internal title and, if needed, a separate title that candidates see.
3. Ask the AI tool to build the draft outline by adding sections and topics.
4. Open the draft link in Ashby, review the outline, resolve validation issues, attach the interviewer to a job's interview plan, and publish it in Ashby.

A new interviewer starts with a draft Version 1 containing an empty Minimum Qualifications section, an empty General section named `Key Competencies`, and a Wrap Up section with its standard `Candidate Questions` topic.

The AI tool can add multiple sections and topics in the same conversation. Starting with a job posting gives it the context needed to select relevant minimum qualifications and competency topics.

:::hint{type="warning"}
**Review before publishing**

Review every draft in Ashby before publishing. A person resolves validation issues, attaches the interviewer to a job's interview plan, and publishes the version. AI Interviewer does not make the hiring decision.
:::

# Create a draft version of an existing interviewer

To change an interviewer without changing the version that candidates currently use, ask an MCP-connected AI tool to create a draft version.

1. Name the interviewer and ask the AI tool to create a new draft version.
2. Choose whether to copy the active version, copy a specific version, or start with the default empty sections.
3. Add an optional label for the draft.
4. Review and edit the draft outline.
5. Open the draft in Ashby, resolve validation issues, and publish it when it is ready.

A copied draft keeps the topics and evaluation criteria from the source version. A new draft is not live until a person publishes it in Ashby, so candidates already in progress are not affected.

# Edit a draft outline

MCP-connected AI tools can edit a draft outline. They cannot edit a published version directly. Create a new draft version when you need to change a published version.

## Sections

You can ask the AI tool to:

- Add, rename, move, and remove General sections
- Keep sections in the required outline order
- Move topics between sections
- Remove a section and its topics

Every outline contains these section types in order:

- **Introduction:** Pinned first and not editable.
- **Minimum Qualifications:** Pinned after Introduction. Use this section for criteria that can end the interview when a candidate does not meet them.
- **General:** Contains competency, criteria, and open-ended topics. Every outline keeps at least one General section.
- **Wrap Up:** Pinned last and contains new open-ended topics, including candidate questions.

You cannot move or remove Introduction, Minimum Qualifications, or Wrap Up. You cannot remove the last General section.

## Topics

You can ask the AI tool to add, edit, duplicate, move, or remove topics in a draft.

- **Competency:** Evaluates how a candidate demonstrates a skill. Add requirements and a question.
- **Criteria:** Checks a pass or fail condition. Add a question and choose Affirmative, Negative, or Custom criteria. Custom criteria also require a prompt that explains the pass condition.
- **Open-ended:** Collects a qualitative response. Add a question.

Duplicating a topic copies its question, settings, and evaluation criteria. Removing a section also removes every topic in that section.

## Validation and timing

AI Interviewer validates topics and regenerates competency scoring bands in the background. After an edit, wait about a minute, then ask the AI tool to read the draft again and address any validation issues.

You can request up to 25 outline changes together. Changes are applied in order. If one change fails, the response identifies what was applied and what was skipped so you can correct the request and retry the remaining changes.

# Get better results from your AI tool

Use these practices when you work with AI Interviewer through MCP:

- Name the AI Interviewer and the job. A job can use more than one interviewer, so include both when possible.
- Say `draft` when you want to make changes. If no draft exists, ask the AI tool to create one copied from the live version.
- Start with the job posting when creating a new interviewer.
- Ask for a plan before removals or other destructive changes, for example, “List the changes you would make, then wait for my confirmation.”
- Ask the AI tool to re-read the draft after validation and scoring bands finish in the background.
- Compare one topic at a time when reviewing multiple candidates.
- Use the review or edit link returned by the AI tool to verify the result in Ashby.

## Example prompts

### Review an interview

:::BlockQuote
Summarize the AI screening interview for \[Candidate Name] for the \[Job Title] role. Include the overall signal, minimum qualification results, weak or unclear signals, and three areas for the next human interviewer to explore.
:::

### Create an interviewer

:::BlockQuote
Create an AI screening interviewer for this job posting. Include only the minimum qualifications stated in the posting, group competency topics by theme, and target a 20-minute interview. Create the outline as a draft for my review.
:::

### Edit a draft safely

:::BlockQuote
Review the draft for \[Interviewer Name]. Identify overlapping topics and recommend which topics to remove. Do not make changes until I confirm.
:::

# What AI Interviewer tools cannot do

AI Interviewer tools do not:

- Publish a version
- Delete an interviewer or version
- Edit topics on a published version
- Attach an interviewer to a job's interview plan
- Accept or dismiss validation issues
- Edit scoring bands directly
- Advance, reject, or re-invite candidates

Complete these actions in Ashby. Always review AI-generated results and draft changes before using them in your recruiting workflow.

# FAQs

### Can Ashby Assistant create or edit an AI Interviewer?

No. Ashby Assistant provides read-only AI Interviewer access. Use an MCP-connected AI client to create an interviewer, create a draft version, or edit a draft outline.

### Can an AI tool change the live interviewer?

No. Read operations do not change Ashby. Write operations create interviewers or drafts and edit draft outlines. A person must review and publish a version in Ashby before it becomes live.

### Can I edit a published version through MCP?

No. Create a new draft version copied from the published version, edit the draft, and publish the new version in Ashby.

### Why can I read an interview but not find the interviewer setup?

Candidate-level results follow your existing Ashby permissions. Finding interviewer setup and looking up an interviewer by name require the `Administer AI Interviews` permission.

### Why does an interview or transcript return “not found”?

The application may not be visible to you in Ashby. AI Interviewer tools return “not found” instead of revealing an interview that you cannot access.

### Why is a transcript empty or unavailable?

A transcript is available after the candidate starts the interview. If the interview has not started, there is no transcript to retrieve.

### Why did only some of my outline changes apply?

Outline changes are applied in order. If a change fails, the response identifies the failed change and the changes that were skipped. Correct the failed request, then resend the remaining changes.

### How do I connect an AI tool to Ashby?

Follow [Ashby MCP Server (Beta)](https://docs.ashbyhq.com/ashby-mcp-server-beta) for client setup, authentication, and general MCP permissions.
