Intevie

Returns structured interview insights for a candidate: post-interview strengths, red flags, and summary lines derived from stored analysis.

get_candidate_interview_insights

Use this when the user asks about a specific candidate by ID.

get_candidate

Returns the 10 AI-generated interview questions stored for a job (JSON array of strings), or null if none exist yet. Same data as the portal job questions editor. Read access follows job visibility (workspace member).

get_job_questions

Returns decision alignment (criteria, owners, competencies, mappings, calibration) for a job if configured. Same visibility rules as the portal.

get_job_decision_alignment

Use this when the user asks about a specific job by ID.

get_job

Returns the current workspace organization or agency profile for the signed-in tenant.

get_workspace_profile

Returns the portal team settings URL and guidance. Invite URLs contain secrets and are returned only from invite_team_member or resend_team_invite.

get_team_invite_link

Creates a pending team invite for the given email (workspace admin only), queues an invite email when notification email delivery is configured, and returns inviteUrl.

invite_team_member

Use this when the user wants to see candidates for a specific job, optionally sorted by score.

list_candidates_for_job

Use this when the user wants to see their jobs, active jobs, or completed jobs. Workspace admins see every job in their organization or agency; other members only see jobs they own.

list_jobs

Lists team invitations for the current tenant (metadata only; secret links are created on invite/resend).

list_team_invites

Lists members of the current organization or agency workspace.

list_team_members

Lists workspace-wide default approvers per hiring stage (same data as portal team settings).

list_stage_approval_defaults

Creates an employee profile from the candidate (or links an existing one) and sets hired lifecycle status. Workspace admin for jobs in the tenant, or job owner only—same as the portal.

mark_candidate_as_employee

Sets isCompleted and completedAt on a job. Workspace admin for jobs in the tenant, or job owner—same as the portal (notifications are portal-only).

complete_job

Creates a governed candidate stage-change action for the agent runtime. If approval is required, approve it in the Intevie portal; once approved, the background runtime continues automatically. Hire/placement final stages must still be completed in the portal.

move_candidate_stage

Transfers job ownership to another workspace member and updates related recruiter-owned rows. Workspace admin only; newOwnerUserId must belong to the tenant.

reassign_job_owner

Queues asynchronous AI regeneration of the 10 interview questions from the current job description and company profile (same SQS pipeline as the portal “Regenerate”). Returns immediately when queued; questions update in the background.

regenerate_job_interview_questions

Moves the candidate to the Rejected stage and archives them when appropriate (portal parity). Optional notes. Rejection email is not sent from MCP; use the portal if you need email.

reject_candidate

Job owner only: deletes the job-level override so the job inherits tenant defaults (portal DELETE /api/hiring/stages/job/:jobId).

reset_job_hiring_stages

Replaces a pending invite for an email with a new pending invite and returns a fresh inviteUrl (workspace admin only).

resend_team_invite

Workspace admin only: removes custom tenant default hiring stages so the workspace falls back to built-in defaults (portal DELETE /api/hiring/stages/tenant).

reset_tenant_hiring_stages

Use this to find one or more jobs when the user provides a job title, partial title, or job identifier. If the user mentions both a title and an identifier, search with the title or phrase and choose the result whose identifier matches. Always call this before editing a job to resolve the correct job ID. Workspace admins search across all jobs in their tenant; other members only across jobs they own.

search_jobs_by_title

Creates a governed candidate invitation action for the agent runtime. Before calling, confirm the job and candidate, and whether the invitation type should be "initial" or "technical". If an invitation of the same type has already been sent and the user has not explicitly asked to resend, do NOT create a new one; instead, explain that an invite already exists and ask whether they want to force a new invite. If approval is required, approve it in the Intevie portal and the background runtime continues automatically.

send_interview_invite

Job owner only: saves a hiring workflow override for a single job (portal PUT /api/hiring/stages/job/:jobId). Workspace admins cannot use this tool for another user's job—only the job owner.

set_job_hiring_stages

Workspace admin only: replaces the organization/agency default hiring workflow (same rules as portal Settings → Hiring stages). Stages must include fixed Applied and Screening entries; exactly one final stage last.

set_tenant_hiring_stages

Creates or updates default approver emails for a configurable hiring stage. Workspace admin only; Applied and Screening stages are not configurable.

set_stage_approval_default

Interview recording (video/audio when available), interview transcript, invitation metadata, and structured scores/red flags. If the user provides a candidate name instead of a candidateId, first resolve the job, call list_candidates_for_job, and match the candidate name before using this tool. The MCP host uses a private key environment variable to load live call data from the interview provider.

show_candidate_interview

Full-width candidate summary: resume score, AI summaries, candidate note, recruiter stage notes, and timeline notes. Includes UI and LLM hints to open interview details (show_candidate_interview). If the user provides a candidate name instead of a candidateId, first resolve the job, call list_candidates_for_job, and match the candidate name before using this tool.

show_candidate_summary

Replaces the job’s 10 interview questions with a new list (exactly 10 non-empty strings), matching the portal API. Job owner or workspace admin for that tenant only.

update_job_questions