MCP tools

Every tool PreHireBadge gives AI assistants, what each one can read or change, and the permission it needs.

Updated 16 of 17 in API, MCP and integrations

These are the tools an assistant can call after you approve it. A write changes data in PreHireBadge. A read does not.

Who it is for. An owner or admin checking what a connected assistant can do.

What stays in PreHireBadge

Assistants never see reports, results, resumes, or AI summaries. Record detail is not included. Publishing a job needs you to confirm first.
Settings, Integrations, where connected assistants and their activity appear.
Settings, Integrations, where connected assistants and their activity appear.
ToolWhat it doesPermissionChanges data
request_background_checkCreates an employment-check invite. Never send an SSN or date of birth.checks:writeYes
get_check_statusReads the status of one check.checks:readNo
list_candidatesLists candidates. A person who only has a skills quiz is not included.candidates:readNo
interpret_resultExplains adverse-action steps. It refuses a hire or no-hire verdict.checks:readNo
get_credit_balanceReads the unused check credits on this account.credits:readNo
list_locationsLists work locations, including archived ones.company:readNo
list_requisitionsLists hiring requisitions.company:readNo
compliance_summarySummarizes completion and outcomes. This is not legal advice.checks:readNo
list_skills_testsLists reviewed skills tests. Answer keys are not included.skills:readNo
send_skills_testCreates a skills-test invite. This does not order a background check.skills:writeYes
get_skills_resultReads one skills score. This tool will not say who to hire.skills:readNo
assign_courseAssigns a practice course. This does not change a skills score.skills:writeYes
list_skill_resultsLists skills-test scores. Answer keys are not included.skills:readNo
draft_documentReturns an offer or policy draft. It is not a contract.company:readNo
list_jobsLists jobs with their posting status and public link.jobs:readNo
get_jobReads one job's posting status and public link.jobs:readNo
draft_job_descriptionWrites a draft job posting with AI and saves it. It never publishes.jobs:writeYes
publish_jobPublishes a job after the posting check passes. Pass confirm true only after the person agrees.jobs:writeYes
list_applicantsLists applications, newest first. No resumes or AI summaries.applications:readNo
get_applicantReads one application's facts and answers. No resume or AI summary.applications:readNo
create_applicantAdds an application to an open job. Never send an SSN, date of birth, or address.applications:writeYes
add_candidateAdds a candidate to the board, or finds the existing one.candidates:writeYes
move_candidate_stageMoves a candidate to another hiring stage. Rejected needs a reason.candidates:writeYes
add_candidate_noteAdds a note about the job, not the person's background.candidates:writeYes
list_integrationsLists connected apps and their health.integrations:readNo

Was this article helpful?