MCP serverteam.yardstick/yardstick

Create a reasoned, revocable, audited access grant.

List explicit access grants visible to the current principal.

Read one explicit access grant by public id.

Revoke an explicit access grant with optional reason text.

Ensure an application interview session for an explicit round id.

List interview sessions for an application.

Bind an already-previewed application archive with explicit approval metadata and matching idempotency key.

Preview application archive approval requirements only; bind fields are rejected.

Create a recruiter or agent-sourced application for an existing person and job posting.

Apply an application status-change email decision with idempotency metadata.

Preview the candidate email decision for an application status change without mutating the application or drafts.

List application person + Job attachments visible to the current principal.

Read one application person + Job attachment by public id.

Bind the fixed applications-owned status/email approval POC with explicit approval metadata and a matching idempotency key.

Preview the fixed applications-owned Interviewing to Offer status/email approval POC without mutating status or email state.

Bind an already-previewed application transition with explicit approval metadata and matching idempotency key.

Directly write a non-terminal application transition; approval-only statuses are rejected. Optionally target a configured stage by id with pipeline_stage_id (the resolved stage is

Preview approval-required application transitions only; bind fields and direct-write targets are rejected. Optionally target a configured stage by id with pipeline_stage_id (status

Update one application with schema-bound public API fields.

Apply an approved ATS import preview with a preview_hash matching the stored dry-run. Creates people/jobs/interview_plans(stub)/job_postings/applications with idempotent replay; ne

Preview a structured-row ATS import of candidates, jobs, and applications (source_kind: csv). JSON rows only; no raw CSV/archive file reads, no application conversion side effects,

Read one ATS import dry-run/apply batch and its rows by public id.

List public Yardstick audit log entries visible to the current principal.

Create a stage automation rule (trigger + typed action from the 3-type palette: send_scheduling_link / create_task / send_email). Inert — fires no side effect.

Delete a stage automation rule. Plain delete (no approval preview→bind): rules are inert config, so deleting unfired config moves no candidates.

List the organization's stage automation rules. Rules are inert config — authoring fires no side effect; the executor child runs rules later.

Dry-run preview: resolve the active rules + their resolved action params for a sample application entering/leaving a stage. INERT — mints no scheduling link, creates no task, sends

Read one stage automation rule by public id (its trigger, typed action, target stage, and is_active state).

Edit a stage automation rule's trigger, typed action, condition, position, or is_active state.

List the organization's stage automation runs (what fired for which candidate, success/failure). Filterable by application-id and rule-id. Read-only; runs are system-written by the

Bind an approved built-in-agent configure preview (same config plus approval metadata and a matching idempotency key). Writes only the built-in agent's declared settings keys and r

Preview configuring a built-in agent (config is validated against the built-in agent's declared schema; enabled is a first-class key, so { enabled: false } is the off switch). Side

Bind an approved built-in-agent enable preview with explicit approval metadata and a matching idempotency key. Writes the built-in agent's declared settings home and records one au

Preview enabling a built-in agent; returns the approval-required envelope stating exactly what starts happening (and what is never sent without you) plus binding fields. Side-effec

List the built-in-agent catalog with each built-in agent's current status, explicit defaults or disabled state, and latest work summary.

Read one built-in agent by catalog id (for example scorecard-chaser, nightly-screening, or interview-kit-prep): what it does, what it never does without you, current status, and la

List the organization's built-in-agent run history as a flat work report. Nightly screening reports scheduled-work counts and held, released, or invalidated review outputs; intervi

Read the decision brief for an application.

Regenerate a decision brief for an application with idempotency metadata.

Create a Department through the public Yardstick API.

Create a Department-scoped invitation without returning token material.

List redacted Department invitation views.

List Departments visible to the current principal.

Add an existing person to a Department.

List Department members for an authorized Department.

Remove a Department member, optionally with a replacement lead.

Set one Department member as lead.

Read one Department by public id.

Update one Department with schema-bound public API fields.

Read candidate email automation settings.

Update candidate email automation settings.

Discard a pending candidate email draft without provider mutation.

Read candidate email draft history and provenance.

List candidate email drafts with optional status and email-type filters.

Read rendered preview content for a candidate email draft.

Read a redacted candidate email draft.

Send a pending candidate email draft with replay protection, or reclaim a never-delivered draft and send it.

Save mutable candidate email draft fields or set/clear a validated sender override.

List redacted sender provider connection state.

List candidate email sender defaults.

Set the default sender policy for a candidate email type.

Read redacted email sender settings with sanitized queue diagnostics.

List immutable candidate email template versions.

List candidate email template policies without raw prompts.

Preview a candidate email template for sample variables.

Preview AI sample customization for a candidate email template without publishing.

Publish a validated candidate email template version.

Read candidate email template detail without raw prompts.

Rollback a candidate email template to an immutable version.

Validate candidate email template subject, HTML, and text bodies.

List public Yardstick API events visible to the current principal.

Record direct final-recommendation evidence; this does not mutate application status.

Return the current Yardstick API principal context.

Read sanitized Workspace integration health diagnostics.

Add competencies to a draft exactly as written — deterministic, no AI generation. Requires confirmed outcomes; the resulting stage must stay within 25 competencies. Optional source

Add questions to one draft round exactly as written — deterministic, no AI generation. Requires rounds; each round holds at most 50 questions. The first question edit on a round pe

Add interview rounds to a draft exactly as written — deterministic, no AI generation. Requires skills; the resulting sequence must stay within 20 rounds. Optional source_stage {sta

Add job skills to a draft exactly as written — deterministic, no AI generation. Requires competencies; the resulting stage must stay within 50 skills. Optional source_stage {stage:

Clear every competency from a draft, leaving the stage deliberately empty — deterministic, no AI generation. Prunes the behavioral anchors of every cleared competency in the same w

Clear every interview round from a draft, leaving the stage deliberately empty — deterministic, no AI generation. Prunes the questions and directions of every cleared round in the

Clear every job skill from a draft, leaving the stage deliberately empty — deterministic, no AI generation. The item delete refuses to remove the last skill, so this is the only wa

Clear every outcome from a draft, leaving the stage deliberately empty — deterministic, no AI generation. Outcomes have no item-level delete, and confirm_outcomes requires at least

Confirm draft interview-plan outcomes before generating later stages.

Delete behavioral-anchor entries for draft items by item id. Optional source_stage {stage: questions_and_directions, version} returns 409 when stale.

Delete draft competencies by id. Prunes each deleted competency's behavioral anchors in the same write and reports the pruned ids; the stage must keep at least one competency. Opti

Delete questions from one draft round by question id. Optional source_stage {stage: questions_and_directions, version} returns 409 when stale.

Delete draft interview rounds by id. Prunes each deleted round's questions and directions in the same write and reports the pruned ids; the sequence must keep at least one round. O

Delete draft job skills by id; the stage must keep at least one skill. Optional source_stage {stage: skills, version} returns 409 when stale.

Generate scorecard behavioral anchors (levels 1-4) for each draft competency, or one competency when competency_id is supplied.

Generate draft interview-plan competencies from confirmed outcomes.

Generate draft interview-plan outcomes from explicit role context, or pass accepted_outcomes to store caller-written outcomes verbatim with no AI generation (the deterministic draf

Generate interview questions and interviewer/candidate directions for each draft round, or one round when round_id is supplied.

Generate draft interview-plan rounds from confirmed skills.

Generate draft interview-plan skills from confirmed competencies.

List interview-plan drafts, newest first. Optional job_id narrows the list to one job and takes a job_ public display id. Use this to find an ipd_ draft id again after an interrupt

Read one interview-plan draft in full: every stage checkpoint (outcomes, competencies, job skills, interview sequence, questions and directions), stage_versions for source_stage pr

Upsert behavioral anchors for draft items, keyed by item id with levels 1-4 — deterministic, no AI generation. Requires competencies; anchors keyed to unknown item ids are rejected

Replace draft competencies by id and/or reorder them with order (a complete permutation of resulting ids) — deterministic, no AI generation. Updating in place keeps the item id. Op

Replace one draft round's questions by id and/or reorder them with order (a complete permutation of that round's resulting question ids) — deterministic, no AI generation. Read the

Set one draft round's interviewer and/or candidate directions exactly as written — deterministic, no AI generation. Provide at least one of the two direction fields. Optional sourc

Replace draft interview rounds by id and/or reorder them with order (a complete permutation of resulting ids) — deterministic, no AI generation. A round updated in place keeps its

Replace draft job skills by id and/or reorder them with order (a complete permutation of resulting ids) — deterministic, no AI generation. Optional source_stage {stage: skills, ver

Validate an interview-plan draft without publishing it.

Archive one interview plan. Already-archived plans succeed without a write. A plan still attached to a job is refused — detach it from the job first.

List published interview plans, newest first. Optional job_id narrows the list to one job and takes a job_ public display id. Use this to find an interview plan id when you only ho

Bind an already-previewed interview-plan active modification with explicit approval metadata and matching idempotency key.

Preview interview-plan active-modification approval requirements only; bind fields are rejected.

Bind an already-previewed interview-plan publish with explicit approval metadata and matching idempotency key.

Preview interview-plan publish approval requirements only; bind fields are rejected.

Read one interview plan by public id.

Restore one archived interview plan. Plans that are already live succeed without a write. If the plan's job has since acquired another live plan, the restore is refused and names t

List organization members who can be assigned as interviewers, newest membership first. Use this to pick a usr_ public display id before assigning an interviewer.

Cancel a scheduled interview session, releasing the provider booking and invalidating its scheduling links.

Complete an interview session for an explicit interviewer.

Assign an interviewer to an interview session.

List interviewers assigned to an interview session.

Unassign an interviewer from an interview session.

Read one interview session by public id.

Read interview-session scheduling readiness.

Generate a scheduling link for an interview session.

Submit an interview-session scorecard with explicit ratings.

Start an interview session for an explicit interviewer.

Bind an already-previewed job-posting archive with explicit approval metadata and matching idempotency key.

Preview job-posting archive approval requirements only; bind fields are rejected.

Create a draft job posting through the public Yardstick API.

List job postings visible to the current principal.

Bind an already-previewed job-posting publish with explicit approval metadata and matching idempotency key.

Preview job-posting publish approval requirements only; bind fields are rejected.

Read one job posting by public id.

Update a job posting with schema-bound public API fields.

Validate a draft job posting without mutating it.

Archive one Job row only; linked job postings, applications, and interview plans are not mutated.

Link an existing interview plan, job posting, or application to a Job. Idempotent when already linked to the same Job; conflicts when linked elsewhere. Requires jobs:write and the

Close one Job row only; linked job postings, applications, and interview plans are not mutated.

Create an internal Job container without mutating job postings, applications, or interview plans.

Clear the link between an artifact and a Job. Idempotent when already unlinked. Requires jobs:write and the artifact's own write scope.

List internal Job containers visible to the current principal.

List deterministic Talent CRM prospect matches for one Job. Read-only; includes evidence, caveats, and blocked lifecycle states without outreach, conversion, import, or AI ranking.

Read one internal Job container by public id.

Update one internal Job container with schema-bound public API fields.

Create a public deep link for an opportunity workflow view.

List read-only opportunity workflow views visible to the current principal.

Read the next action state for an opportunity without mutating it.

Read one read-only opportunity workflow view by public id.

Create a person through the public Yardstick API.

Mint a signed download URL for one person document. Read-only. The URL expires in 5 minutes and is a bearer link: do not log or share it. Takes per_ and pdoc_ display ids.

List the documents attached to a person (resumes and other files). Archived documents are excluded unless include_archived is true. Takes a per_ display id and returns pdoc_ displa

List people visible to the current principal. Pass email to find the exact person behind a candidate_email_conflict.

Read one person by public id.

Update one person with schema-bound public API fields.

Assign a pipeline to a job (jobs.pipeline_template_id) or clear it with pipeline_id: null. Pipeline validated by org; job resolved by org+mode.

Create a custom pipeline template with optional inline stages. Does not affect the org default pipeline or candidate tracking.

List the organization's pipeline templates with their ordered stages. Canonical default stages are flagged canonical_locked.

Read one pipeline template and its ordered stages by public id.

Reorder all stages of a pipeline by supplying the complete stage id order. Constraint-safe; allowed for canonical stages.

Append (or insert at a position) a stage to a pipeline with a kind and optional approval scope.

Bind an approved pipeline-stage delete with explicit approval metadata and a matching idempotency key. Refuses while candidates remain.

Preview deleting a pipeline stage; returns the candidate-count impact and binding fields. Canonical default stages are rejected.

Edit a pipeline stage. Canonical default stages allow display-name change only; slug/stage_kind/approval_scope/is_terminal are locked.

Rename, re-describe, or toggle active for one pipeline template.

Create a bounded internal prospect activity note or touchpoint.

List bounded activity records for one Talent CRM prospect.

Apply an approved Prospect CRM import preview with preview_hash and explicit row decisions for advisory matches.

Preview a structured-row Prospect CRM import. JSON rows only; no raw CSV/resume file reads, outreach, application conversion, source ranking, or silent person merge.

Read one Prospect CRM import dry-run/apply batch by public id.

Bind an approved prospect conversion preview with explicit approval metadata and matching idempotency key.

Preview conversion of one Prospect into one canonical Application; bind fields are rejected and no outreach/import/merge occurs.

Create Talent CRM prospect relationship state for an existing person.

List active Talent CRM prospects visible to the current principal.

Create a pending review prospect outreach email draft. Sending stays on email draft send and requires communications:send.

Preview a one-off prospect outreach draft without creating a draft, sending email, enrolling a sequence, or creating an application.

Read one Talent CRM prospect by public id.

Update bounded Talent CRM prospect relationship fields.

Search redacted recruiting reporting summaries through the public reporting API.

Create an opaque source/referral link for a published job posting. Raw source_token is returned only in the create response; reads return token_hint, and active token-bearing links

Disable a source/referral link so its public URL no longer stamps attribution.

List source/referral attribution links without raw token material or source quality ranking.

Read one source/referral attribution link by public id without raw token material.

Add an existing prospect to a Talent CRM pool.

List active prospect memberships for one Talent CRM pool.

Remove an active prospect membership from a Talent CRM pool.

Create a Talent CRM pool.

List Talent CRM pools visible to the current principal. Archived pools are excluded unless include_archived is true.

Read one Talent CRM pool by public id.

Update bounded Talent CRM pool fields.

Create a public task deep link for a caller-supplied task id.

List Yardstick tasks visible to the current principal.