Matchaa

Use this when the user provides a job post to tailor a resume to: analyzes it with the website's service (role, contract, weighted requirements) and returns an operationId to pass to tailor_resume as offerOperationId, so the job post is not analyzed twice. Pass the job post text; resolve a job URL to its text first. Do not use to judge a resume against a job; use analyze_resume_job.

analyze_job_offer

Use this when the user wants to check a rewritten resume against its original: compares both texts and reports which changes the original supports, which need confirmation and what was dropped, with the source lines. Does not rewrite the resume or produce a PDF. Identical retries reuse the operation.

audit_resume_rewrite

Use this when a Matchaa call was interrupted or returned running: reports the status of an operation in this guest space. If it failed or its lease expired, call the original tool again with exactly the same arguments to resume it without another charge.

get_operation

Use this when the user asks how well their resume matches a specific job post, without rewriting it. Pass the resume text (cvText), the job post text (offerText) and the guestToken. Returns an operationId and a coverage score from 0 to 100 with the requirements demonstrated, partly demonstrated, missing or unclear, each with its job post and resume evidence. The score is neither an ATS guarantee nor a hiring probability. Do not use to tailor the resume or produce a PDF; use tailor_resume. Identical retries reuse the operation.

analyze_resume_job

Use this when the user asks to change a tailored resume: exact text edits, additions or removals based on what the user said, or the template, palette, font or density. Creates a new revision from the latest operationId, without AI or another adaptation; earlier revisions stay available to undo. For content edits, userRequest must quote the user's request; never add a fact the user did not state. Do not use to tailor the resume to another job; use tailor_resume.

update_resume

Use this when a reviewed revision is ready to deliver: requires the fresh previewReceipt of this exact revision and previewReviewed=true after you actually examined its image or PDF. Refuses a missing, expired or other revision's preview, overflowing text, or a PDF missing the name, summary, experience or education titles. These checks do not prove that facts are true. Freezes the revision, without another adaptation, and returns its private PDF link.

finalize_resume

Use this when a resume PDF link has expired or the user asks for the link again: renews the private signed link to the same PDF, valid up to one hour, without another adaptation or charge.

get_resume_document

Use this when you need to look at the current revision yourself before finalizing: returns the PNG pixels and the previewReceipt directly, without a card or a user click. Actually examine the image. If your client cannot read the pixels, use preview_resume instead. Same ownership and rendering checks. No AI call.

inspect_resume

Use this when you need to pick or change the resume design: lists the 19 Matchaa templates, what each suits and the valid palette, font and spacing values, as text. Choose the template yourself from the profile, the amount of content and the preferences already stated; do not ask the user unless they want to choose. Photo templates need a photo the user already provided. Do not use to apply a design to a delivered resume; use update_resume with templateId.

list_resume_templates

Use this when no Matchaa guestToken exists yet in this conversation: opens a private guest space, without an account. Reuse the returned guestToken for every later Matchaa call in the conversation, including edits, and keep it private. A limited number of complete adaptations is free in a guest space; edits, previews and downloads do not use them. Do not open another guest space to get around that limit.

create_guest_context