MCP App Store
by KeenEthics
RightMatch AI icon

RightMatch AI MCP Server for ChatGPT

By RightMatch AI

Overview

RightMatch AI screens every candidate in minutes, so your team only meets pre-qualified talent. RightMatch AI automates candidate screening with fast, accurate, unbiased assessments. Easily integrates with your ATS for smarter, data-driven, and efficient hiring for SMB's, enterprise & agencies.

How to connect

  1. ChatGPT: Open the RightMatch AI listing in the ChatGPT app directory and choose Connect. ChatGPT listing RightMatch AI exposes 38 tools here.

Tools

cancel-invite

ChatGPT
Cancel interview invites so their links stop working: the candidate sees the same page as an expired link, and the pending interview is removed from RightMatch. Pass the invite codes from list-invites. A submitted interview, or one the candidate is taking right now, is never canceled. This can't be undone, so always name the candidates to the user and get their yes first. To fix a wrong address, cancel and then send a new interview with send-interview.

create-interview-template

ChatGPT
Create a new saved interview template for the current company. Two kinds: an AI video interview (interviewKind 'standard': 10 credits per completed interview) and a Mira Live interview (interviewKind 'conversation': 50 credits per started 15 minutes of conversation, so at most what its time limit allows, charged only when the candidate finishes). A Mira Live interview never asks about protected characteristics (age, family, race, religion, health and the like): a template whose asks or script do is refused. For an AI video interview, questions are always answered by speaking aloud on video: write them in a natural, conversational spoken style, avoiding formatting or anything that doesn't work when read aloud. textMode is an accessibility option that lets candidates type instead of record; it does not change how questions should be written. For a Mira Live interview, set interviewKind 'conversation' and give conversation: guided needs at least one 'must' topic or ask; scripted needs script, with a translation of each question for every extra language. Use the get-interview-template tool to display the new template to the user

create-posting

ChatGPT
Save a job description as a new RightMatch job with its own public apply page, so applicants can apply and be scored. You can draft the description yourself from what the user tells you. It is shown to candidates exactly as written (Markdown) on the apply page, so include the location, employment type and compensation in it if candidates should see them. The job is created closed (a draft) and nothing is shared. Show the user the title and description first and save only after they approve. A draft appears in RightMatch under All Jobs, below the open jobs with its Active switch off, and joins the sidebar's jobs list once opened; say so, so the user can find it. Returns applyUrl (the public apply link, https://rightmatch.app/job/<code>) and postingUrl (the job's page in RightMatch). Applicants are only scored while the job is open: after the user confirms, open it with update-posting before they share applyUrl.

draft-interview

ChatGPT
Draft a complete AI video interview for a job in one call, using RightMatch's own question generator (the same one as the RightMatch web app), and save it as an editable template. Nothing is sent and no credits are used. Pass posting (a job title, posting _id or rightmatch.app/views link from list-postings), or a jobDescription the user pasted, or a jobUrl. A posting can be combined with jobDescription or jobUrl when the posting has no description of its own. The draft includes the job title, up to 4 skills and spoken-style questions; for a posting, its ATS pre-screening questions are taken into account. Prefer this over create-interview-template when the user asks to build an interview for a job. Set interviewKind 'conversation' to draft a Mira Live interview instead: a guided live conversation with Mira, with the topics to cover and the hiring team's asks (each with a hidden scoring guide). After it returns, show the draft with get-interview-template and ask the user to approve or change it. Edit it with update-interview-template. Only call send-interview once the user approves.

get-credit-history

ChatGPT
Where this workspace's credits went: the balance, totals by kind (resume scores, interviews, texts, grants) and the most recent credit transactions with the job each one was for, over the last days days. Use it when the user asks what something cost, why the balance changed, or why it didn't. notes explains what costs nothing (free first-job scoring on Starter, locked resumes, resumes already in a job), so read them before telling the user a charge is missing.

get-import-status

ChatGPT
How resumes added to a job posting in the last 24 hours are doing: how many are uploaded, still scoring, and scored. Use it when the user asks whether their import is finished.

get-interview

ChatGPT
Fetch a single interview result by its MongoDB ID. questions[].ignored=true means the AI did not score that question; aiQuestionAssessment is index-aligned with questions and entries for ignored questions have no score (an unexplained one is returned as {ignored:true}). locked: true means it is waiting on credits. interviewKind 'conversation' is a Mira Live interview: a live spoken conversation with Mira, scored as a whole. It has no questions; its score is the conversation score (0-100), with conversation.coverage (each topic covered, partial or not_reached), conversation.askResults (the hiring team's asks: yes, partly or no), conversation.facts, and for scripted screens conversation.questionScores, slots and knockouts. recommendation is Mira's verdict. If the response carries credits_required, results are waiting on credits: tell the user that and show its message. Say nothing else about billing and share no billing links. Once credits are added, call this tool again: the results unlock on their own within about a minute, with no reconnect.

get-interview-template

ChatGPT
Fetch a single interview template by its MongoDB ID. Displays an interactive preview with skills, questions, and video intro. A Mira Live interview template (interviewKind 'conversation') has no questions: its conversation holds the topics and the hiring team's asks (guided), or the script of questions Mira asks word for word (scripted), each ask or question with goodAnswer, the hidden scoring guide that only this team sees (never the candidate or Mira). When hasIntroVideo is false, follow responseInstructions: ask the user whether they want to add an intro video before anything is sent.

get-interview-transcript

ChatGPT
The per-question transcript of one completed interview: the question text, what the candidate said (or typed, for text-mode interviews), and the answer's start/end seconds in the recording. Also returns a signed link to the screen recording for the user (valid for 24 hours), never the video itself. Results are paginated by question: pass fromQuestion to continue. Each answer is capped; truncated: true marks a capped answer. An interview still being recorded has no transcript yet, and an interview the company hasn't unlocked with credits returns locked: true and no transcript. A Mira Live interview (interviewKind 'conversation') returns its conversation instead: turns[] with speaker (Mira or candidate), text and times, paginated by turn with the same fromQuestion and limit; redacted: true marks words hidden for abusive language. If the response carries credits_required, results are waiting on credits: tell the user that and show its message. Say nothing else about billing and share no billing links. Once credits are added, call this tool again: the results unlock on their own within about a minute, with no reconnect.

get-new-results

ChatGPT
Interviews that finished scoring and new applicants that were scored since a timestamp (default: the last 24 hours), grouped by job, sorted by score, each interview with its report link. Applicants are only included when you also have access to resumes. Use when the user asks what came in since yesterday or since they last checked. You cannot notify or ping the user later: never promise a notification. Suggest they ask again here, or point them at the RightMatch interview digest for proactive alerts. If the response carries credits_required, results are waiting on credits: tell the user that and show its message. Say nothing else about billing and share no billing links. Once credits are added, call this tool again: the results unlock on their own within about a minute, with no reconnect.

get-resume

ChatGPT
Fetch a single resume by its MongoDB ID, including screeningAnswers (ATS pre-screening answers such as salary expectations) when the candidate has any.

get-resume-text

ChatGPT
Fetch the full extracted text of a single resume by its MongoDB ID. Only available for resumes that have finished scoring and are not locked. Use query-resumes or search-candidates first to find the resume's _id.

get-user-info

ChatGPT
Returns info about the logged in user, and the workspace's plan and credit balance. For what the credits were spent on, use get-credit-history. On Starter, freeFirstJobResumeScoresLeft is how many more resumes the workspace's first job scores without using credits.

list-interview-templates

ChatGPT
Returns saved interview templates for the current company (up to 200, newest first), use the returned templateUrl field to give the user to add a video intro or edit the template themselves.

list-invites

ChatGPT
Interview invites already sent, with their state: pending (sent, not started), started (candidate opened the interview but hasn't submitted it), or expired (link no longer works and the interview was never submitted; wasStarted says whether the candidate had opened it). A streamed interview that is still recording counts as started even past its expiry, because the candidate can still resume it. Submitted and canceled invites are not listed. Each invite shows its expiry and when the candidate was last reminded, so you can answer "who hasn't started?" without opening the app. Filter by template or by job posting. Defaults to open invites (pending and started), newest first. To remind candidates who haven't started, pass their codes to resend-invite; to withdraw an invite, cancel-invite.

list-postings

ChatGPT
List the company's job postings (jobs). Each posting has its own applicant pipeline in RightMatch. Use this to find the right posting when the user names a job ambiguously, then pass its _id to search-posting-candidates. The result gives total, openCount and closedCount: quote those rather than counting the list.

preview-interview

ChatGPT
Returns the skills and questions from a template without sending anything. For a Mira Live interview template (interviewKind 'conversation') it returns what Mira will cover instead: topics and asks (guided) or the script (scripted).

query-interviews

ChatGPT
Search and filter video interviews for the current company. All parameters are optional. Pass resumeId to automatically match interviews by the resume owner's email. In results, questions[].ignored=true means the AI did not score that question; aiQuestionAssessment is index-aligned with questions and entries for ignored questions have no score (an unexplained one is returned as {ignored:true}). locked: true marks an interview waiting on credits (no score). interviewKind 'conversation' is a Mira Live interview: a live spoken conversation with Mira, scored as a whole. It has no questions; its score is the conversation score (0-100), with conversation.coverage (each topic covered, partial or not_reached), conversation.askResults (the hiring team's asks: yes, partly or no), conversation.facts, and for scripted screens conversation.questionScores, slots and knockouts. recommendation is Mira's verdict. If the response carries credits_required, results are waiting on credits: tell the user that and show its message. Say nothing else about billing and share no billing links. Once credits are added, call this tool again: the results unlock on their own within about a minute, with no reconnect.

query-resumes

ChatGPT
Search and filter resumes for the current company. All parameters are optional — omit any you don't need. Each result includes screeningAnswers (the candidate's ATS pre-screening answers, e.g. salary expectations, right to work, licences) when they have any. For the top candidates in a specific job, or to filter on a screening answer, use search-posting-candidates, which matches that job's page in RightMatch.

rate-candidate

ChatGPT
Give one or more candidates your star rating, 1 to 5. One rating per person per candidate: rating again updates it. Works for applicants (resume ids) and interview results (interview ids).

reject-candidates

ChatGPT
Reject candidates, with a reason the user chooses. A person must decide every rejection: never reject on your own judgment or from a score cutoff without the user picking the people. Works in two steps. First call WITHOUT confirmToken: nothing is rejected; you get a preview listing each candidate by name and what will happen (rejected in their ATS, the job's rejection email, or no email) and a confirmToken. Show that list to the user and ask them to confirm. Only after they explicitly say yes, call again with exactly the same ids, reason, note, sendEmail and atsReasonId plus confirmToken. If the user changes anyone or anything, start again without a token. sendEmail sends the job's rejection email to candidates who didn't come from an ATS; ask the user whether they want it. ATS candidates get no email from RightMatch: their ATS handles that, and they need an atsReasonId from the preview's atsRejectionReasons. Already-rejected candidates are skipped.

remove-candidates

ChatGPT
Delete candidate rows from RightMatch without rejecting them: for a blank or broken row left by a failed upload, a file that wasn't a resume, or a candidate added by mistake. Nobody is emailed and nothing is sent to an ATS. To turn a candidate down, use reject-candidates instead. To find the rows, list the job's applicants (search-posting-candidates with sortBy 'newest'); each row has its fileName (the uploaded file's name), status and createdAt, so a row with no name can be identified by its file. Works in two steps. First call WITHOUT confirmToken: nothing is removed; you get a preview of each row and a confirmToken. Show it to the user and ask them to confirm. Only after they explicitly say yes, call again with the same ids plus confirmToken.

rescore-candidates

ChatGPT
Score applicants again against their job as it is now. Use it after the job's description, requirements or likes and dislikes changed: a rescore picks up those changes. With nothing changed, a rescore the same day returns the same cached score, so it is not a way to get a second opinion on a score. Pass resumeIds (the _id of applicants from search-posting-candidates, query-resumes or get-resume) or posting (a job _id, /views link or title) to rescore every scored applicant on that job (up to 200). Rescoring runs in the background; read the new scores a minute later. Only scored, unlocked applicants are rescored, and a rescore uses no credits. Locked applicants are skipped; unlock them with unlock-candidates first. If the job has auto-interview on, an applicant whose new score clears the threshold is sent the interview, so tell the user that before rescoring such a job.

resend-invite

ChatGPT
Remind candidates who have not started their interview: sends the invite email again, plus a text when they have a phone number (texts use credits). Use it for "remind them" after list-invites. Pass the invite codes from list-invites. Each candidate can be reminded at most once every 24 hours, counting the original invite; a candidate inside that window is refused with nextReminderAt, and nothing is sent to them. Only invites the candidate has not opened can be resent; an expired one needs extendDays to reopen it. Confirm the list of candidates with the user before calling. Each reminder counts toward the workspace's daily invite limit.

search-candidates

ChatGPT
Full-text search across candidate resumes (name, job title, skills, location, tags, contact info). Supports fuzzy matching and searches across all fields simultaneously. Use this when the user wants to find candidates by keyword or phrase rather than exact filters. To rank the applicants for a specific job, use search-posting-candidates instead.

search-interviews

ChatGPT
Full-text search across interview responses including transcripts, answers, and candidate info. Supports fuzzy matching across all fields. Use this when the user wants to find interviews by keyword or phrase. locked: true marks an interview waiting on credits (no score). If the response carries credits_required, results are waiting on credits: tell the user that and show its message. Say nothing else about billing and share no billing links. Once credits are added, call this tool again: the results unlock on their own within about a minute, with no reconnect.

search-network

ChatGPT
Search the RightMatch Open to Work Network: consenting, non-hired applicants from other RightMatch workspaces. Use it when the user's own pipeline is thin for a role. Returns anonymized cards only (first name, title, skills, city/region, matchScore) and an opaque networkCandidateId per candidate. Contact details are not available from search; they become visible to this workspace only once a candidate starts an interview it sent. To contact a candidate, send them an interview: call send-interview with candidates: [{ networkCandidateId }] instead of an email, after showing the user the interview. That invite is also how a network candidate is added to a job: when they start an interview sent for a posting, their resume is copied onto that posting and scored like any applicant (until then it is not, by design). Searches and network invites have daily per-workspace limits.

search-posting-candidates

ChatGPT
List the applicants for one job posting, ranked the same way as that job's page in RightMatch (/views/<job>): best AI score first, rejected and duplicate applicants excluded. Use this for questions like 'show me the top candidates in the Software Developer job'. posting can be the job title, a posting _id, or a rightmatch.app/views/. link. If several postings match, the result lists them; ask the user which one (or pick by location) and call again with its _id. view applies one of the posting's saved views (e.g. '80% or higher'); the result lists the available view names. Locked candidates (scored but not unlocked) show a score of 0, as they do in the app. Each candidate includes screeningAnswers (their ATS pre-screening answers, e.g. salary expectations, right to work, licences), and the result lists the posting's screeningQuestions with each question's type. To filter on an answer, pass screeningFilters: question (its title or key from screeningQuestions), an operator valid for its type, and a value. Operators by type: TEXT contains/startsWith/endsWith/isAnyOf; NUMBER =/!=/>/>=/</<=; BOOLEAN is (true/false); SINGLE_SELECT is/not/isAnyOf; MULTI_SELECT contains/isAnyOf; DATE is/not/after/onOrAfter/before/onOrBefore; any type isEmpty/isNotEmpty. Salary is often a TEXT answer: when it is, read the returned answers instead of filtering numerically. If a response says the workspace is out of credits or has reached a limit, tell the user that, and that an account admin can manage billing at rightmatch.app. Say nothing else about billing and share no billing links.

send-interview

ChatGPT
Send video interview invitations to one or more candidates using a saved template. Returns the created invite links. Always use get-interview-template before running this tool to confirm the skills and questions with the user. Always show the user the interview first, do not send automatically. Always ask about an intro video before sending: when the template has none (get-interview-template returns hasIntroVideo: false), ask the user whether they want to add one first. They record or upload it on the template's page in RightMatch (templateUrl); it can't be added from chat. Send without one only once the user says to. Invites skipped for low balance (status skipped_low_balance) come with credits_required: tell the user the workspace is out of credits and show its message. Say nothing else about billing; once credits are added, send to the skipped candidates again. To invite an Open to Work Network candidate from search-network, pass { networkCandidateId } instead of an email: results and invite lists refer to them by networkCandidateId and first name only; their contact details become visible to this workspace only after the candidate starts the interview. Network invites have their own daily limit. To invite a candidate already in RightMatch by their record, pass { resumeId } instead of an email: the email and phone on file are used. Use this when results don't include contact details (some workspaces keep them out of AI assistants).

share-interview

ChatGPT
Create a view-only link to one or more completed interviews, for the user to send to a hiring manager or anyone else. Use it for requests like 'send Maya's interview to my hiring manager' or 'share the top 3 with Dana'. Get interview ids from get-new-results, query-interviews or search-interviews first. Each link opens in a browser without an account and shows the recording, transcript and AI assessment. It does not show the candidate's email, phone or resume, or the team's comments and ratings. Asking again for the same interview returns the same link. Return each url to the user as a clickable link for them to send themselves. This tool does not email anyone. Tell the user they can turn a link off at any time from the interview's Share menu at rightmatch.app, and it stops working for everyone. Only completed interviews can be shared.

tag-candidates

ChatGPT
Add or remove tags on one or more candidates, e.g. add ['bilingual'] or remove ['follow-up']. Tags match case-insensitively; existing tags are kept unless removed.

unlock-candidates

ChatGPT
Unlock scored candidates whose score is hidden because they are locked (locked: true), spending credits the same way the RightMatch app does: 1 credit per candidate, or free when a Starter workspace's first job still has free scores. Spending needs the user's yes, so this works in two steps. First call with dryRun true (the default): nothing is charged; you get each candidate's cost, the total, the balance and a confirmToken. Tell the user the number of candidates and the exact credit total and ask them to confirm. Only after they explicitly say yes, call again with the same ids, dryRun false and confirmToken. Never confirm on your own. The confirmed call returns each unlocked candidate's score and explanation, and every other tool then shows them. If the balance is short the quote says so and how to add credits; no partial charge happens without a confirmation. If the price went up after the quote, the confirmed call charges nothing and returns a new quote (status price_changed) to confirm with the user again. Candidates still scoring can't be unlocked yet. Get ids from search-posting-candidates or query-resumes (rows with locked: true).

update-candidate-contact

ChatGPT
Change a candidate's email, phone or name on their RightMatch record (the same as editing them in the app). Use it whenever the user gives a candidate a new or corrected email or phone, including before sending them an interview at a new address, so the record and the invite agree. id is the candidate's resume _id from the search and resume tools. Pass only the fields that change; an empty phone removes it. This does not resend any invite.

update-candidate-stage

ChatGPT
Move one or more candidates to a pipeline stage, e.g. 'Interviewing' or 'Shortlisted'. For candidates from a connected ATS the stage is also changed in the ATS, using that job's own stages. If the stage isn't one the candidate's job has, the result lists availableStages for that candidate. Moving someone to a rejected stage is refused: use reject-candidates. Confirm who you are moving with the user before calling when the request is ambiguous.

update-interview-template

ChatGPT
Update fields on an existing interview template. Only provided fields are changed. questions and skills each replace the whole list, so send the complete list in the order the candidate should hear it. When the user asks to change one question ("swap question 3", "cut to 5"), number the questions as they currently stand, keep every other question's wording exactly as it is, and change only what they asked. Do not send skills unless the user asked to change the skills. The response includes changes (which numbered questions were removed, added or kept, and any skill changes): tell the user exactly that, and link templateUrl so they open this exact template. Questions are always answered by speaking aloud — keep wording conversational and suitable for spoken delivery regardless of textMode. For a Mira Live interview template (interviewKind 'conversation'), conversation is merged over the stored config one level deep: send settings alone to change a setting, but topics, asks and script each replace the whole list. An ask or question sent without goodAnswer keeps the stored one when its id matches. changes.conversation says what changed.

update-posting

ChatGPT
Change a job's description, location or employment type, or open or close it. Only the fields you pass change. Opening a job starts scoring its applicants and counts against the plan's active-job limit; closing it stops screening new applicants. Scoring uses 1 credit per resume, except on a Starter workspace's first job, where it is free up to a cap; the result's notes say which applies. Always confirm with the user before opening or closing a job, and show them a changed description before saving it. Jobs synced from an ATS (ats: true) can only be opened or closed here, which controls RightMatch screening only; edit their details in the ATS. The job title can't be changed here: renaming is done in RightMatch. If a response says the workspace is out of credits or has reached a limit, tell the user that, and that an account admin can manage billing at rightmatch.app. Say nothing else about billing and share no billing links.

verify-work-email

ChatGPT
Unlocks sending interviews for a workspace created with a personal email address (Gmail, Outlook and similar). Use it when send-interview returns work_email_required. Ask the user for their work email on their company's own domain, then call this with it. We email a verification link to that address; once the user opens it, sending works on the next try. Personal email domains are refused.

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/rightmatch-ai"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/rightmatch-ai)