> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hireflix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hireflix MCP tools reference

> Every tool the Hireflix MCP server gives your AI tool: what it does, what it needs, and the limits to know about.

The [Hireflix MCP](https://docs.hireflix.com/ai/mcp.md) gives your AI tool **18 tools**, grouped the same way Claude shows them in its connector settings: **read-only tools**, **write/delete tools**, and **other tools** for the GraphQL schema. You never call these tools yourself. Your AI tool picks the right one based on what you ask, so this page is mainly useful to:

* **Decide which tools to allow.** In Claude, you can set each tool (or each group) to always allow, ask permission, or block. See [Fine-tune tool permissions](https://docs.hireflix.com/ai/mcp.md#connect-your-ai-tool) in the Claude setup steps.
* **Understand an answer.** If your AI tool refuses something or asks for more details, the limits below usually explain why.

> [!NOTE]
>
> Last checked: November 2026. The tool list lives on the Hireflix MCP server, so your AI tool may show slightly different names or descriptions.

## Read-only tools

These tools only look things up. They never change anything in your account.

| Tool | What it does | Inputs | Good to know |
| - | - | - | - |
| **ListPositions** | Lists every position in your account | None | Includes **archived** positions. A position with an archive date no longer accepts candidates. |
| **GetPosition** | Gets one position, with a summary of its questions | Position ID | |
| **ListInterviews** | Lists the interviews for one position | Position ID, filter, pagination, sort | An empty filter returns all interviews. Results come in pages, newest first by default. |
| **GetInterview** | Gets one interview | Interview ID | Returns the candidate, stage, score, and links to the interview. |
| **ListWebhooks** | Lists the webhooks in your account | None | |

> [!TIP]
>
> Want your AI tool to look things up but never change anything? Set this group to **Always allow** and block the write/delete tools, or leave them on **Ask permission**.

## Write/delete tools

These tools create, change, or remove things in your account. Claude asks for your permission before each use, unless you change that.

### Positions

| Tool | What it does | Inputs | Good to know |
| - | - | - | - |
| **CreatePosition** | Creates a new position | Position details | The name is 1–50 characters. A position needs at least one question and can have up to 50. See [Create a position via chat](https://docs.hireflix.com/ai/guides/create-position-via-chat.md) for the template. |
| **UpdatePosition** | Changes an existing position | Position ID and the fields to change | Only the fields you mention change. **Questions and tags are replaced as a whole**: if you ask to add one question, your AI tool sends the full list, including the existing questions. |

### Candidates and interviews

| Tool | What it does | Inputs | Good to know |
| - | - | - | - |
| **InviteCandidate** | Invites a candidate to a position | Position ID and candidate details | Each email can be invited **once per position**. Returns the interview link the candidate receives. See [Can I re-invite a candidate?](https://docs.hireflix.com/tech/faqs/can-i-reinvite-candidate.md) |
| **ScoreInterview** | Sets or clears the score of an interview | Interview ID and score | Scores go from **0.5 to 5**. Clearing removes the score. |
| **ShortlistInterview** | Moves an interview to **Shortlisted** | Interview ID | |
| **DiscardInterview** | Moves an interview to **Discarded** | Interview ID | |
| **ShareInterview** | Creates a link to review the interview without logging in | Interview ID | Anyone with the link can watch the interview. See [Sharing an interview](https://docs.hireflix.com/user/reviewing-sharing/sharing-an-interview.md). |

### Webhooks

| Tool | What it does | Inputs | Good to know |
| - | - | - | - |
| **CreateWebhook** | Creates a webhook | URL and events | Events: interview created, finished, stage changed, score updated, resubmitted, and deleted. See [Webhooks](https://docs.hireflix.com/tech/webhooks/getting-started.md). |
| **RemoveWebhook** | Deletes a webhook | Webhook ID | |

## Other tools

Not everything you can do in Hireflix has its own tool. Fetching interview transcriptions, for example, doesn't. That's what these four tools are for: they let your AI tool work with the full [Hireflix GraphQL API](https://docs.hireflix.com/tech/graphql-basics.md), so if you ask for something without a dedicated tool, it can usually still do it.

| Tool | What it does |
| - | - |
| **Introspect** | Looks up a type in the Hireflix GraphQL schema, starting from the root queries and mutations |
| **Search** | Searches the schema for types that match a term, such as "transcription" |
| **Validate** | Checks a query or mutation against the schema before running it |
| **Execute** | Runs a query or mutation against your account |

Your AI tool usually goes through them in that order: find the right query, check it, then run it. That's why requests without a dedicated tool take a bit longer.

> [!WARNING]
>
> **Execute can change your account too.** It runs both queries (read) and mutations (write), so Claude lists it under **Other tools**, not under read-only tools. If you only want your AI tool to read, set Execute to **Ask permission** so you can check each operation.

## How video uploads work

There's no separate upload tool. When you attach an intro, outro, or question video to your chat, your AI tool uploads it in three steps:

1. **Reserve the upload** with **Execute**. Hireflix returns a media ID and a temporary upload link.
2. **Send the file** to that upload link. This happens outside the MCP: your AI tool sends the file directly.
3. **Attach the video** to the position with **CreatePosition** or **UpdatePosition**, using the media ID.

**Question images** work differently: your AI tool sends them along with **CreatePosition** or **UpdatePosition** in one go.

For file size limits and formats, see [Attaching videos and images](https://docs.hireflix.com/ai/guides/create-position-via-chat.md#attaching-videos-and-images).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.