
AceRound: review interview and exam reports, manage resumes, practice mock interviews via OAuth
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Skip an application: removes it from the to-do list but keeps the record (submitted ones also leave tracking). Undo with restore_job_application. Replies with the status as read back. (Requires the user's sign-in with scope job_applications:write.)
Application id, from list_job_applications or the reply of an add-to-list tool
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http aceround https://api.aceround.app/agent/mcp
Skip an application: removes it from the to-do list but keeps the record (submitted ones also leave tracking). Undo with restore_job_application. Replies with the status as read back. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| applicationId* | string | Application id, from list_job_applications or the reply of an add-to-list tool |
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "string",
"minLength": 1,
"description": "Application id, from list_job_applications or the reply of an add-to-list tool"
}
},
"additionalProperties": false
}Activate an unactivated pass: it starts now, or right after the current pass if one is active. An activated pass can no longer be refunded. Card ids come from list_pending_subscription_cards. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope account:write.)
| Argument | Type | Description |
|---|---|---|
| cardId* | string |
{
"type": "object",
"required": [
"cardId"
],
"properties": {
"cardId": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Add a job from the job library to the user's Auto Apply list, optionally choosing the resume for it (the base resume otherwise). Jobs already on the list are not added twice. Replies with the application as read back, including its id. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| resumeId | string | Resume id, from list_resumes |
| campusJobId* | string | Job id, from search_campus_jobs |
{
"type": "object",
"required": [
"campusJobId"
],
"properties": {
"resumeId": {
"type": "string",
"minLength": 1,
"description": "Resume id, from list_resumes"
},
"campusJobId": {
"type": "string",
"minLength": 1,
"description": "Job id, from search_campus_jobs"
}
},
"additionalProperties": false
}Add a job to the user's Auto Apply list by its application link (careers sites, referrals, shared links). Links in the job library map to that job; others are shown by domain until the company and title are identified in the background. Optionally choose the resume. Replies with the application as read back, including its id. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| url* | string | The application link |
| resumeId | string | Resume id, from list_resumes |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The application link"
},
"resumeId": {
"type": "string",
"minLength": 1,
"description": "Resume id, from list_resumes"
}
},
"additionalProperties": false
}Add one Q&A entry (question + reference answer) to an interview knowledge base. The ID comes from list_knowledge_bases; returns the entry ID. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| answer* | string | |
| question* | string | |
| materialId* | string | Knowledge base ID |
{
"type": "object",
"required": [
"materialId",
"question",
"answer"
],
"properties": {
"answer": {
"type": "string",
"maxLength": 8000,
"minLength": 1
},
"question": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"materialId": {
"type": "string",
"minLength": 1,
"description": "Knowledge base ID"
}
},
"additionalProperties": false
}Add a job that is not in the job library to the user's Auto Apply list by entering the company and title. One record per company and title. Replies with the application as read back, including its id. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| cities | array | Work locations (optional) |
| jobUrl | string | Job link (optional) |
| company* | string | Company name |
| jobTitle* | string | Job title |
{
"type": "object",
"required": [
"company",
"jobTitle"
],
"properties": {
"cities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 30,
"minLength": 1
},
"default": [],
"maxItems": 10,
"description": "Work locations (optional)"
},
"jobUrl": {
"type": "string",
"format": "uri",
"maxLength": 500,
"description": "Job link (optional)"
},
"company": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Company name"
},
"jobTitle": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Job title"
}
},
"additionalProperties": false
}Press "Answer now" in the desktop assessment overlay: stops any checking still running and writes the answer from what is already known (it does not cancel; the question still completes). Only works while an assessment question is being answered. (Requires the user's sign-in with scope interviews:write.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Press "Answer now" in the live interview in progress: answers the interviewer's latest unanswered speech (at least 6 characters) immediately, interrupting any answer in progress. Use it to trigger answers when auto-answer is off. Requires the user to have this session open in the browser or desktop app and connected; the page carries it out exactly as if the user clicked the matching button. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Submit the user's answer (text) to the current question in the mock interview in progress, same as editing and clicking "Send" on the page; the AI interviewer then asks the next question or ends the interview. Not possible while the interviewer is still asking. Requires the user to have this session open in the browser or desktop app and connected; the page carries it out exactly as if the user clicked the matching button. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| answer* | string | The answer |
{
"type": "object",
"required": [
"answer"
],
"properties": {
"answer": {
"type": "string",
"maxLength": 5000,
"minLength": 1,
"description": "The answer"
}
},
"additionalProperties": false
}Ask a question in the live interview in progress on the user's behalf: the text is treated as the interviewer's question and answered on the interview page; if the AI is answering, that answer is interrupted first. Uses the same path as "Voice ask" in the desktop app and requires the user to have clicked "Start interview". Billed by time online. Requires the user to have this session open in the browser or desktop app and connected; the page carries it out exactly as if the user clicked the matching button. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| question* | string | The question |
{
"type": "object",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The question"
}
},
"additionalProperties": false
}Connect Android SMS forwarding with the key (starting with sk_) the user copied from the SMS forwarder app home screen; the key is verified first. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| key* | string |
{
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
}Create a Stripe Checkout link for Auto Apply credits: plan "pack" = 50 applications, "unlimited" = 30 days of unlimited applications. The user opens the link and pays; once paid, the credits show up in get_account. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope account:write.)
| Argument | Type | Description |
|---|---|---|
| plan* | string | pack = 50 applications; unlimited = 30 days unlimited |
{
"type": "object",
"required": [
"plan"
],
"properties": {
"plan": {
"enum": [
"pack",
"unlimited"
],
"type": "string",
"description": "pack = 50 applications; unlimited = 30 days unlimited"
}
},
"additionalProperties": false
}Check whether an order has been paid and fulfilled. Use it after the user pays at checkout; PAID means the purchase is on the account. (Requires the user's sign-in with scope account:read.)
| Argument | Type | Description |
|---|---|---|
| orderNumber* | string | Order number returned when the order was created, or from the recent orders in get_account |
{
"type": "object",
"required": [
"orderNumber"
],
"properties": {
"orderNumber": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Order number returned when the order was created, or from the recent orders in get_account"
}
},
"additionalProperties": false
}Create a custom hotword library (name + words; up to 200 words per library and 20 libraries per user). Returns its ID; bind it to a role with update_goal_hot_words. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| words | array |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 30,
"minLength": 1
},
"words": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50
},
"default": []
}
},
"additionalProperties": false
}Create an interview target (company + role, optionally a job description) and return its ID for starting an interview. Same as "New target" on the website. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| name* | string | Role title |
| companyName | string | Company name |
| description | string | Job description, used as context when answering |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Role title"
},
"companyName": {
"type": "string",
"maxLength": 100,
"description": "Company name"
},
"description": {
"type": "string",
"maxLength": 10000,
"description": "Job description, used as context when answering"
}
},
"additionalProperties": false
}Create an interview knowledge base, optionally with free text (project notes, experience). Returns its ID; add Q&A with add_knowledge_base_entry or import_knowledge_base_entries. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| content | string | Free text |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 50,
"minLength": 1
},
"content": {
"type": "string",
"maxLength": 90000,
"description": "Free text"
}
},
"additionalProperties": false
}Create an order for a plan and return a Stripe Checkout link for the user to open and pay. The price is the local price for the country this request comes from and is shown in the result. After the user pays, use check_order_status to confirm. Product ids come from list_plans. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope account:write.)
| Argument | Type | Description |
|---|---|---|
| productId* | string | A product id from list_plans |
| deferActivation | boolean | Passes only: true = keep the pass unactivated after payment until the user activates it (activate_subscription_card) |
{
"type": "object",
"required": [
"productId"
],
"properties": {
"productId": {
"type": "string",
"maxLength": 64,
"description": "A product id from list_plans"
},
"deferActivation": {
"type": "boolean",
"description": "Passes only: true = keep the pass unactivated after payment until the user activates it (activate_subscription_card)"
}
},
"additionalProperties": false
}Create a new resume from text (for example a revised version of the user's resume) for interviews and Auto Apply. No file is produced and existing resumes are left as they are. Returns the new resume id. (Requires the user's sign-in with scope resumes:write.)
| Argument | Type | Description |
|---|---|---|
| title* | string | Resume title |
| content* | string | Full resume text |
{
"type": "object",
"required": [
"title",
"content"
],
"properties": {
"title": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Resume title"
},
"content": {
"type": "string",
"maxLength": 50000,
"minLength": 1,
"description": "Full resume text"
}
},
"additionalProperties": false
}Delete an assessment record with all its questions and answers. Deletion cannot be undone; tell the user what will be deleted and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| examId* | string | Assessment id from list_exams |
{
"type": "object",
"required": [
"examId"
],
"properties": {
"examId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Assessment id from list_exams"
}
},
"additionalProperties": false
}Delete a custom hotword library; roles bound to it are unbound. The ID comes from list_my_hot_words. Deletion cannot be undone; tell the user what will be deleted and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
}Delete an interview record, including its report and transcript. Deletion cannot be undone; tell the user what will be deleted and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| interviewId* | string | Interview id from list_interviews |
{
"type": "object",
"required": [
"interviewId"
],
"properties": {
"interviewId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Interview id from list_interviews"
}
},
"additionalProperties": false
}Delete the value of one standard field in the user's Auto Apply profile (keys from get_job_apply_profile). Replies with the result as read back. Deletion cannot be undone; tell the user what will be deleted and get their agreement first. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| key* | string |
{
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"enum": [
"name",
"namePinyin",
"gender",
"birthDate",
"ethnicity",
"politicalStatus",
"maritalStatus",
"nationality",
"idType",
"idNumber",
"age",
"height",
"weight",
"healthStatus",
"birthPlace",
"hukouType",
"englishName",
"mobile",
"email",
"currentCity",
"homeAddress",
"hukouLocation",
"emergencyContactName",
"emergencyContactRelation",
"emergencyContactPhone",
"wechat",
"currentAddress",
"familyMemberRelation",
"familyMemberName",
"familyMemberEmployer",
"familyMemberTitle",
"school",
"major",
"degree",
"educationRange",
"graduationYear",
"educationType",
"schoolCity",
"college",
"advisor",
"lab",
"researchDirection",
"academicRanking",
"gpa",
"academicDegree",
"studentOrigin",
"workCompany",
"workTitle",
"workRange",
"workExperience",
"projectExperience",
"honors",
"campusExperience",
"papers",
"patents",
"overseasExperience",
"rewardsAndPunishments",
"languages",
"skills",
"certificates",
"englishLevel",
"englishScore",
"hobbies",
"intendedCities",
"intendedPositions",
"acceptRelocation",
"expectedOnboardDate",
"expectedSalary",
"personalWebsite",
"githubUrl",
"portfolioUrl",
"resumeFile",
"studentIdFile",
"transcriptFile",
"photoFile"
],
"type": "string"
}
},
"additionalProperties": false
}Delete an interview knowledge base with all its entries. The ID comes from list_knowledge_bases. Deletion cannot be undone; tell the user what will be deleted and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| id* | string | Knowledge base ID |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Knowledge base ID"
}
},
"additionalProperties": false
}Delete one Q&A entry. Entry IDs come from get_knowledge_base. Deletion cannot be undone; tell the user what will be deleted and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| id* | string | Entry ID |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Entry ID"
}
},
"additionalProperties": false
}Delete a learned answer so it is no longer filled into other applications. Deletion cannot be undone; tell the user what will be deleted and get their agreement first. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| normalized* | string | Normalized key of the learned answer, copied from get_job_apply_profile |
{
"type": "object",
"required": [
"normalized"
],
"properties": {
"normalized": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Normalized key of the learned answer, copied from get_job_apply_profile"
}
},
"additionalProperties": false
}Delete a question prediction. The record ID comes from list_question_predictions. Used credits are not returned. Deletion cannot be undone; tell the user what will be deleted and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| id* | string | Prediction ID |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Prediction ID"
}
},
"additionalProperties": false
}Delete one of the user's resumes. Resume ids come from list_resumes. Deletion cannot be undone; tell the user what will be deleted and get their agreement first. (Requires the user's sign-in with scope resumes:write.)
| Argument | Type | Description |
|---|---|---|
| resumeId* | string |
{
"type": "object",
"required": [
"resumeId"
],
"properties": {
"resumeId": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Change the value of a learned answer; later applications that ask the same question use the new value. Replies with the value as read back. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| value* | string | |
| normalized* | string | Normalized key of the learned answer, copied from get_job_apply_profile |
{
"type": "object",
"required": [
"normalized",
"value"
],
"properties": {
"value": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"normalized": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Normalized key of the learned answer, copied from get_job_apply_profile"
}
},
"additionalProperties": false
}Mark an in-progress assessment record as ended and give it a title automatically. This only changes the record; it does not close the assessment window on the user's computer. Assessments can only be started and solved in the desktop app. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| examId* | string | Assessment id from list_exams |
{
"type": "object",
"required": [
"examId"
],
"properties": {
"examId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Assessment id from list_exams"
}
},
"additionalProperties": false
}End the user's live or mock interview in progress, same as "End interview" on the page: settles the session's minutes (live interviews refund time billed after the last exchange) and starts the report. The page closes itself within seconds. This cannot be undone. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| type | string | INTERVIEW = live interview, MOCK_INTERVIEW = mock interview |
{
"type": "object",
"properties": {
"type": {
"enum": [
"INTERVIEW",
"MOCK_INTERVIEW"
],
"type": "string",
"default": "INTERVIEW",
"description": "INTERVIEW = live interview, MOCK_INTERVIEW = mock interview"
}
},
"additionalProperties": false
}Turn a whole assessment record (every question and answer) into tidy Markdown with code kept as is. Returns its length, outline, opening, and a download link for the full text. Takes a few dozen seconds. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| examId* | string | Assessment id from list_exams |
{
"type": "object",
"required": [
"examId"
],
"properties": {
"examId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Assessment id from list_exams"
}
},
"additionalProperties": false
}Turn a full interview record (transcript and answer-assistant solutions) into tidy Markdown. Returns its length, outline, opening, and a download link for the full text. Takes a few dozen seconds. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| interviewId* | string | Interview id from list_interviews |
{
"type": "object",
"required": [
"interviewId"
],
"properties": {
"interviewId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Interview id from list_interviews"
}
},
"additionalProperties": false
}Draft Auto Apply profile values from one of the user's resumes (the most recently updated one if resumeId is omitted), and list fields missing from both resume and profile. Returns suggestions only; save them with update_job_apply_profile after the user confirms. (Requires the user's sign-in with scope job_applications:read.)
| Argument | Type | Description |
|---|---|---|
| resumeId | string | Resume id, from list_resumes |
{
"type": "object",
"properties": {
"resumeId": {
"type": "string",
"minLength": 1,
"description": "Resume id, from list_resumes"
}
},
"additionalProperties": false
}Ask a follow-up about the current screenshot question on the user's page (e.g. "another approach", "explain line 3"), same as typing a follow-up on the page; not possible while an answer is being written. Assessment follow-ups are billed by mode. Runs in the desktop assessment overlay when the user is in an assessment (it must have started); otherwise in screenshot solving on the live / mock interview page (the web page must be sharing the screen). Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| message* | string | The follow-up |
{
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The follow-up"
}
},
"additionalProperties": false
}Have AI generate proper nouns that will come up in the interview and that speech recognition tends to get wrong, from a role name, description and optional resume. Nothing is saved; store them with create_hot_word_library / update_hot_word_library or update_goal_hot_words. Resume ID from list_resumes. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| jobName* | string | |
| resumeId | string | |
| jobDescription | string |
{
"type": "object",
"required": [
"jobName"
],
"properties": {
"jobName": {
"type": "string",
"maxLength": 100
},
"resumeId": {
"type": "string"
},
"jobDescription": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
}Write up an interview experience post (the questions the interviewer asked) from a live interview record, save it to the record, and return it; an existing write-up is replaced. Only live interviews of at least 5 minutes qualify. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| interviewId* | string | Interview id from list_interviews |
{
"type": "object",
"required": [
"interviewId"
],
"properties": {
"interviewId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Interview id from list_interviews"
}
},
"additionalProperties": false
}Have AI predict interview questions from the user’s resume and/or target role and append them with reference answers to a knowledge base (8 by default, up to 15). Knowledge base ID from list_knowledge_bases, resume ID from list_resumes; give at least one of resume or role. Returns how many entries were added. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| count | integer | |
| goalId | string | |
| resumeId | string | |
| materialId* | string |
{
"type": "object",
"required": [
"materialId"
],
"properties": {
"lang": {
"type": "string"
},
"count": {
"type": "integer",
"maximum": 15,
"minimum": 1
},
"goalId": {
"type": "string"
},
"resumeId": {
"type": "string"
},
"materialId": {
"type": "string"
}
},
"additionalProperties": false
}The signed-in account: remaining minutes, pass level and expiry, mock interview and prediction credits, Auto Apply credits, and the payment status of the 10 most recent orders. Use it to confirm a purchase made through a purchase link went through. (Requires the user's sign-in with scope account:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Show Auto Apply credits: applications left, when unlimited ends, and any wait required before the next one. (Requires the user's sign-in with scope job_applications:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Filter values for the job board (employment types, job functions, locations, companies) and its size.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Read one assessment record: summary plus one line per question (start of the question, answer length). Pass question (1-based) to include that question and its answer in full. Use export_exam_markdown for the whole record. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| examId* | string | Assessment id from list_exams |
| question | integer | Question number, starting at 1 |
{
"type": "object",
"required": [
"examId"
],
"properties": {
"examId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Assessment id from list_exams"
},
"question": {
"type": "integer",
"minimum": 1,
"description": "Question number, starting at 1"
}
},
"additionalProperties": false
}Look up a gift code: what it includes, whether it has expired or run out, and whether this account can redeem it. (Requires the user's sign-in with scope account:read.)
| Argument | Type | Description |
|---|---|---|
| code* | string | Gift code |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Gift code"
}
},
"additionalProperties": false
}Read the hotwords in effect for a target role: bound libraries (ID, name, whether the user’s own) and custom hotwords. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| goalId* | string |
{
"type": "object",
"required": [
"goalId"
],
"properties": {
"goalId": {
"type": "string"
}
},
"additionalProperties": false
}Read the review report of one interview: summary, scores, strengths and weaknesses, suggestions, and each question with the answer, score, evaluation, and suggestion. Interview ids come from list_interviews. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| interviewId* | string |
{
"type": "object",
"required": [
"interviewId"
],
"properties": {
"interviewId": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Read the full transcript of one interview (interviewer and user turns in order, 80 per call; page with offset). (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| offset | integer | |
| interviewId* | string |
{
"type": "object",
"required": [
"interviewId"
],
"properties": {
"offset": {
"type": "integer",
"default": 0,
"minimum": 0
},
"interviewId": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Show one Auto Apply application: job details (batch, type, description, requirements, deadline) and the resume used for it. (Requires the user's sign-in with scope job_applications:read.)
| Argument | Type | Description |
|---|---|---|
| applicationId* | string | Application id, from list_job_applications or the reply of an add-to-list tool |
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "string",
"minLength": 1,
"description": "Application id, from list_job_applications or the reply of an add-to-list tool"
}
},
"additionalProperties": false
}Show the state of the Auto Apply app on the user's computer: whether it is online, which conversations are running and what each is doing, how many applications are running or queued in one-click apply, whether any employer is waiting for an SMS code, and the latest reply in the Skills conversation (the default target of send_job_apply_instruction). Requires the AceRound Auto Apply desktop app on the user’s computer to be signed in and open (running in the background after closing the window also works); if the app is offline or outdated, the tool says so. (Requires the user's sign-in with scope job_applications:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Show the user's Auto Apply profile: standard fields (key, value, source) and answers learned from past applications (normalized question key, value, company). Filter learned answers by keyword when there are many. (Requires the user's sign-in with scope job_applications:read.)
| Argument | Type | Description |
|---|---|---|
| keyword | string | Only list learned answers whose question or value contains this (optional) |
{
"type": "object",
"properties": {
"keyword": {
"type": "string",
"maxLength": 40,
"description": "Only list learned answers whose question or value contains this (optional)"
}
},
"additionalProperties": false
}Show the user's job preferences remembered by the apply assistant: target and excluded companies, company size, directions, employment types, cities, batches, and other notes. (Requires the user's sign-in with scope job_applications:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Read one interview knowledge base: name, the start of its text with total length, and an overview of its Q&A entries (one per line). The ID comes from list_knowledge_bases. Pass contentOffset to read long text 4000 characters at a time, or entryIds for full Q&A entries. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| id* | string | Knowledge base ID |
| entryIds | array | Entry IDs to read in full |
| contentOffset | integer | Character offset into the text |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Knowledge base ID"
},
"entryIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 30,
"description": "Entry IDs to read in full"
},
"contentOffset": {
"type": "integer",
"minimum": 0,
"description": "Character offset into the text"
}
},
"additionalProperties": false
}Show the user's live interview, mock interview and assessment in progress: session ID, target, start time, expiry, whether the page is online, which client handles it (desktop app / web), and page state (started, AI answering, language, auto-answer, one card per question, etc.). (Requires the user's sign-in with scope interviews:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Show how many devices signed in to this account in the last 7 days and whether more than one computer (web or desktop app) was used, to tell whether the account is being shared. (Requires the user's sign-in with scope account:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Read the full thread of one feedback item (every message between the user and support); this marks its replies as read. Ids come from list_my_feedbacks. (Requires the user's sign-in with scope account:read.)
| Argument | Type | Description |
|---|---|---|
| feedbackId* | string |
{
"type": "object",
"required": [
"feedbackId"
],
"properties": {
"feedbackId": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Read an official knowledge base: description and an overview of its entries (one per line); pass indexes for the full entries with sources. The ID comes from list_official_knowledge_bases. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| id* | string | Official knowledge base ID |
| indexes | array | Entry numbers to read in full (1-based) |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Official knowledge base ID"
},
"indexes": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"maxItems": 30,
"description": "Entry numbers to read in full (1-based)"
}
},
"additionalProperties": false
}AceRound's product overview: what each product does, supported interview and assessment platforms, downloads, and links to pricing and help pages. Read it before answering any question about AceRound.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Prompt studio: see the state of the interview and exam prompts — what is in effect now, the user’s saved custom prompt, the official version and whether it has been updated, each built-in style, and built-in exam questions for trial runs. Returns an overview with lengths; pass show to read one text in full. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| lang | string | Interview language to render for; defaults to the saved one |
| show | string | Which text to return in full: current / saved / official / style:<value> |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"zh-CN",
"yue-CN",
"zh-HK",
"en-US",
"ja-JP",
"es-MX",
"pt-BR",
"de-DE",
"fr-FR",
"ko-KR",
"vi-VN",
"ru-RU",
"ar-SA"
],
"type": "string",
"description": "Interview language to render for; defaults to the saved one"
},
"show": {
"enum": [
"interview.current",
"interview.saved",
"interview.official",
"interview.style:keypoints",
"interview.style:answerOnly",
"interview.style:natural",
"interview.style:structured",
"exam.current",
"exam.saved",
"exam.official",
"exam.style:standard",
"exam.style:readable",
"exam.style:concise",
"exam.style:performance"
],
"type": "string",
"description": "Which text to return in full: current / saved / official / style:<value>"
}
},
"additionalProperties": false
}Create a purchase link for a plan for the user to open in a browser: after signing in to AceRound, checkout for that plan opens automatically, priced for the user's country. Product ids come from list_plans.
| Argument | Type | Description |
|---|---|---|
| productId* | string | A product id from list_plans |
{
"type": "object",
"required": [
"productId"
],
"properties": {
"productId": {
"type": "string",
"maxLength": 64,
"description": "A product id from list_plans"
}
},
"additionalProperties": false
}Read one question prediction. The record ID comes from list_question_predictions or start_question_prediction. Returns the status and an overview with one question per line; pass indexes to read the why-asked, answer outline and material for those questions. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| id* | string | Prediction ID |
| indexes | array | Question numbers to read in full (1-based) |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Prediction ID"
},
"indexes": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"maxItems": 20,
"description": "Question numbers to read in full (1-based)"
}
},
"additionalProperties": false
}Read the text of one resume. Resume ids come from list_resumes. (Requires the user's sign-in with scope resumes:read.)
| Argument | Type | Description |
|---|---|---|
| resumeId* | string |
{
"type": "object",
"required": [
"resumeId"
],
"properties": {
"resumeId": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Read the user’s cloud-saved settings: interview preferences (language, translation, answer style, default knowledge bases, replay, web search…), exam answer customization (answer language, programming language, code style, code mode, extra requirements, quick prompts) and desktop client settings (hotkeys, overlay style, modes, auto-answer…). Custom prompts are shown as lengths only; read them with get_prompt_presets. (Requires the user's sign-in with scope interviews:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Show SMS code forwarding status: whether the Android SMS forwarder is connected, when the iPhone shortcut last pushed, and whether the forwarder app needs an update. The apply assistant uses it to read sign-in codes. (Requires the user's sign-in with scope job_applications:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Show whether the user has enrolled a voiceprint (used in phone-interview mode to tell the user's voice from the interviewer's), when, and whether the voiceprint service is available. Enrollment is done by recording in the audio settings when starting an interview. (Requires the user's sign-in with scope interviews:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Bulk-import Q&A entries (1–200 per call, appended) into an interview knowledge base. The ID comes from list_knowledge_bases; the batch is rejected if it would exceed the base’s capacity. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| entries* | array | |
| materialId* | string |
{
"type": "object",
"required": [
"materialId",
"entries"
],
"properties": {
"entries": {
"type": "array",
"items": {
"type": "object",
"required": [
"question",
"answer"
],
"properties": {
"answer": {
"type": "string",
"maxLength": 8000,
"minLength": 1
},
"question": {
"type": "string",
"maxLength": 2000,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 200,
"minItems": 1
},
"materialId": {
"type": "string"
}
},
"additionalProperties": false
}Stop the answer the AI is currently writing in the live interview (what is already written stays). Only works while an answer is being written. Requires the user to have this session open in the browser or desktop app and connected; the page carries it out exactly as if the user clicked the matching button. (Requires the user's sign-in with scope interviews:write.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Learn the user's own answer style from one interview record and return a style instruction that can be used as the extra answer requirement when starting an interview. Interview ids come from list_answer_style_sources. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| interviewId* | string | Interview id from list_interviews |
{
"type": "object",
"required": [
"interviewId"
],
"properties": {
"interviewId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Interview id from list_interviews"
}
},
"additionalProperties": false
}List the AI assistants this account has authorized: name, site, scopes, when access was granted, and when it was last used. (Requires the user's sign-in with scope account:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List interview records that can be used to learn the user's answer style (sessions with enough of the user's own answers), newest first. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| limit | integer |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 30,
"minimum": 1
}
},
"additionalProperties": false
}List the user's assessment records (screenshot-solving sessions in the desktop app), one per line, most recently updated first, 20 per page. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| page | integer |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}List the hotword libraries that can be bound to a target role: official libraries and the user’s own (isOwn=true), with IDs and names. Hotwords help speech recognition get proper nouns right. (Requires the user's sign-in with scope interviews:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List the user's saved interview targets (company + role). Starting a live or mock interview needs one of these IDs. One per line, newest first. (Requires the user's sign-in with scope interviews:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List the user's interview sessions (live and mock), newest first, 20 per page. (Requires the user's sign-in with scope interviews:read.)
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| type | string | INTERVIEW = live interviews, MOCK_INTERVIEW = mock interviews; omit for both |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 100,
"minimum": 1
},
"type": {
"enum": [
"INTERVIEW",
"MOCK_INTERVIEW"
],
"type": "string",
"description": "INTERVIEW = live interviews, MOCK_INTERVIEW = mock interviews; omit for both"
}
},
"additionalProperties": false
}List the user's Auto Apply applications: overall counts, then each application's id, company, role, status, and progress (50 per page). Tools that act on an application take the id from here. (Requires the user's sign-in with scope job_applications:read.)
| Argument | Type | Description |
|---|---|---|
| page | integer |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}List the user’s interview knowledge bases: ID, name, source (custom / file / ai), number of Q&A entries and text length. Knowledge bases are attached to an interview so the assistant’s answers fit the user’s background. (Requires the user's sign-in with scope interviews:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List the user's feedback, one per line, most recently updated first, 20 per page: status, number of replies, unread replies, and the latest message. (Requires the user's sign-in with scope account:read.)
| Argument | Type | Description |
|---|---|---|
| page | integer |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}List the user’s own hotword libraries with all their words. (Requires the user's sign-in with scope interviews:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List the official knowledge bases: recent industry knowledge missing from model training data, kept up to date. They can be attached to an interview alongside the user’s own knowledge bases without importing. (Requires the user's sign-in with scope interviews:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List the user's purchased passes that have not been activated yet (bought with delayed activation), and whether each can be refunded and for how much. (Requires the user's sign-in with scope account:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List the plans on sale, with prices and what each one includes.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List the user’s question predictions: record ID, role, company, created time, status (generating / done / failed) and number of questions. (Requires the user's sign-in with scope interviews:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List the recruiting portals the user has connected in the Auto Apply app and their sign-in state (no credentials). The state is what the app last verified. (Requires the user's sign-in with scope job_applications:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List the user's resumes, one per line. A resume marked sample is the built-in example, not the user's own background. (Requires the user's sign-in with scope resumes:read.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Mark a job from the job library as already applied to elsewhere: creates the application if needed and records it as submitted; already-submitted ones keep their date. Does not use Auto Apply credits. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| campusJobId* | string | Job id, from search_campus_jobs |
{
"type": "object",
"required": [
"campusJobId"
],
"properties": {
"campusJobId": {
"type": "string",
"minLength": 1,
"description": "Job id, from search_campus_jobs"
}
},
"additionalProperties": false
}Mark an application as not submitted this time, with the reason (signed out, site error, blocked, etc.). Replies with the status as read back. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| reason* | string | Why it was not submitted |
| applicationId* | string | Application id, from list_job_applications or the reply of an add-to-list tool |
{
"type": "object",
"required": [
"applicationId",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Why it was not submitted"
},
"applicationId": {
"type": "string",
"minLength": 1,
"description": "Application id, from list_job_applications or the reply of an add-to-list tool"
}
},
"additionalProperties": false
}Mark an application on the list as submitted (the user finished submitting on the employer site). Uses 1 Auto Apply credit if this one has not been charged yet; nothing while unlimited is active. Replies with the status as read back. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| applicationId* | string | Application id, from list_job_applications or the reply of an add-to-list tool |
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "string",
"minLength": 1,
"description": "Application id, from list_job_applications or the reply of an add-to-list tool"
}
},
"additionalProperties": false
}Auto-match hotwords for a target role: pick official libraries and generate custom hotwords from the role (and optional resume), then save them to the role. If the role already has hotwords they are returned unchanged (matched=false); force=true re-matches and overwrites. Resume ID from list_resumes. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| force | boolean | |
| goalId* | string | |
| resumeId | string |
{
"type": "object",
"required": [
"goalId"
],
"properties": {
"force": {
"type": "boolean"
},
"goalId": {
"type": "string"
},
"resumeId": {
"type": "string"
}
},
"additionalProperties": false
}Pre-apply check: show the application form for a job from the job library, what is prefilled from the user's profile and resume, and which required items are missing. Does not apply or charge; open questions are answered by AI at apply time. (Requires the user's sign-in with scope job_applications:read.)
| Argument | Type | Description |
|---|---|---|
| campusJobId* | string | Job id, from search_campus_jobs |
{
"type": "object",
"required": [
"campusJobId"
],
"properties": {
"campusJobId": {
"type": "string",
"minLength": 1,
"description": "Job id, from search_campus_jobs"
}
},
"additionalProperties": false
}Record a job the user already applied to elsewhere (company and title entered by hand); it is saved as submitted and tracked, without using Auto Apply credits. For jobs in the job library use mark_campus_job_submitted. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| cities | array | Work locations (optional) |
| jobUrl | string | Job link (optional) |
| company* | string | Company name |
| jobTitle* | string | Job title |
{
"type": "object",
"required": [
"company",
"jobTitle"
],
"properties": {
"cities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 30,
"minLength": 1
},
"default": [],
"maxItems": 10,
"description": "Work locations (optional)"
},
"jobUrl": {
"type": "string",
"format": "uri",
"maxLength": 500,
"description": "Job link (optional)"
},
"company": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Company name"
},
"jobTitle": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Job title"
}
},
"additionalProperties": false
}Convert all account credits into interview minutes and mock interviews: every 200 credits become 60 minutes and 2 mock interviews. All credits are converted at once and any remainder below 200 is cleared. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope account:write.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Redeem a gift code; its contents are added to this account immediately. Each code can be redeemed once per account. Use get_gift_code_info to preview it. (Requires the user's sign-in with scope account:write.)
| Argument | Type | Description |
|---|---|---|
| code* | string | Gift code |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Gift code"
}
},
"additionalProperties": false
}Refund an unactivated pass to the original payment method; the pass is voided. Only passes showing a refundable amount in list_pending_subscription_cards qualify. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope account:write.)
| Argument | Type | Description |
|---|---|---|
| cardId* | string |
{
"type": "object",
"required": [
"cardId"
],
"properties": {
"cardId": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Delete an application that was never submitted (suggested, on the list, or a failure confirmed before submitting). Submitted ones cannot be deleted; use abandon_job_application. Deletion cannot be undone; tell the user what will be deleted and get their agreement first. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| applicationId* | string | Application id, from list_job_applications or the reply of an add-to-list tool |
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "string",
"minLength": 1,
"description": "Application id, from list_job_applications or the reply of an add-to-list tool"
}
},
"additionalProperties": false
}Rename an interview record (live or mock). (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| title* | string | |
| interviewId* | string | Interview id from list_interviews |
{
"type": "object",
"required": [
"interviewId",
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"interviewId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Interview id from list_interviews"
}
},
"additionalProperties": false
}Add a message (optionally with screenshots) to one of the user's feedback threads; support will follow up. Ids come from list_my_feedbacks. (Requires the user's sign-in with scope account:write.)
| Argument | Type | Description |
|---|---|---|
| content* | string | |
| feedbackId* | string | |
| screenshots | array | Screenshots, up to 6 |
{
"type": "object",
"required": [
"feedbackId",
"content"
],
"properties": {
"content": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"feedbackId": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"screenshots": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileName",
"contentBase64"
],
"properties": {
"fileName": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"contentBase64": {
"type": "string",
"minLength": 1,
"description": "Image file content as base64 (PNG / JPG / WEBP)"
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 6,
"description": "Screenshots, up to 6"
}
},
"additionalProperties": false
}Restore a skipped application: never-submitted ones go back on the apply list, submitted ones go back to tracking (nothing is re-sent). Replies with the status as read back. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| applicationId* | string | Application id, from list_job_applications or the reply of an add-to-list tool |
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "string",
"minLength": 1,
"description": "Application id, from list_job_applications or the reply of an add-to-list tool"
}
},
"additionalProperties": false
}Regenerate an interview report that failed to generate (when get_interview_report says it failed). Generation runs in the background for a minute or two; read it afterwards with get_interview_report. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| interviewId* | string | Interview id from list_interviews |
{
"type": "object",
"required": [
"interviewId"
],
"properties": {
"interviewId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Interview id from list_interviews"
}
},
"additionalProperties": false
}Revoke an AI assistant's access; its tokens stop working immediately. Revoking the current assistant's own grant means the user must authorize it again. Grant ids come from list_agent_grants. (Requires the user's sign-in with scope account:write.)
| Argument | Type | Description |
|---|---|---|
| grantId* | string |
{
"type": "object",
"required": [
"grantId"
],
"properties": {
"grantId": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Prompt studio AI rewrite: mode=refine edits the draft per instruction; mode=sync merges rules added to the official prompt into the draft while keeping the user’s own changes. Returns the rewritten text and a summary of changes without saving; save with save_custom_prompt (after sync, pass baseline=official). Rate-limited. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| mode* | string | |
| draft* | string | |
| scene* | string | |
| instruction | string |
{
"type": "object",
"required": [
"scene",
"mode",
"draft"
],
"properties": {
"lang": {
"enum": [
"zh-CN",
"yue-CN",
"zh-HK",
"en-US",
"ja-JP",
"es-MX",
"pt-BR",
"de-DE",
"fr-FR",
"ko-KR",
"vi-VN",
"ru-RU",
"ar-SA"
],
"type": "string"
},
"mode": {
"enum": [
"sync",
"refine"
],
"type": "string"
},
"draft": {
"type": "string",
"maxLength": 20000
},
"scene": {
"enum": [
"interview",
"exam"
],
"type": "string"
},
"instruction": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
}Prompt studio trial run: answer one question with a given prompt through the same pipeline and model as production. For scene=interview give question, optionally with a resume (list_resumes), target role and knowledge bases (list_knowledge_bases); for scene=exam pick a built-in question (examPresets from get_prompt_presets) or pass screenshots as base64. An empty prompt runs the built-in default. Charges nothing and saves nothing, but the account must have time available; rate-limited. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| mode | string | |
| scene* | string | |
| goalId | string | |
| prompt | string | |
| question | string | |
| resumeId | string | |
| materialIds | array | |
| screenshots | array |
Save the full custom prompt from the prompt studio: when non-empty it replaces the built-in instructions for interview answers or exam answers; an empty string goes back to the built-in style plus extra requirements. baseline records which official text this prompt was derived from for future official-update merges: if you started from a text in get_prompt_presets pass that one (official / current / style:<value>), after a sync rewrite pass official, for a prompt written from scratch pass none, and omit it for small edits to keep the existing record. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| lang | string | Interview language this prompt is for; defaults to the saved one |
| scene* | string | interview answers / exam answers |
| prompt* | string | Full prompt; empty string = stop customizing |
| baseline | string |
{
"type": "object",
"required": [
"scene",
"prompt"
],
"properties": {
"lang": {
"enum": [
"zh-CN",
"yue-CN",
"zh-HK",
"en-US",
"ja-JP",
"es-MX",
"pt-BR",
"de-DE",
"fr-FR",
"ko-KR",
"vi-VN",
"ru-RU",
"ar-SA"
],
"type": "string",
"description": "Interview language this prompt is for; defaults to the saved one"
},
"scene": {
"enum": [
"interview",
"exam"
],
"type": "string",
"description": "interview answers / exam answers"
},
"prompt": {
"type": "string",
"maxLength": 20000,
"description": "Full prompt; empty string = stop customizing"
},
"baseline": {
"enum": [
"official",
"current",
"none",
"style:keypoints",
"style:answerOnly",
"style:natural",
"style:structured",
"style:standard",
"style:readable",
"style:concise",
"style:performance"
],
"type": "string"
}
},
"additionalProperties": false
}Save all questions and answer outlines of a prediction as a new interview knowledge base the interview assistant can use live. The record ID comes from list_question_predictions; returns the new knowledge base ID. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| id* | string | Prediction ID |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Prediction ID"
}
},
"additionalProperties": false
}Search open roles on AceRound's job board and return the first page of results, one role per line. Apply links and further pages require signing in on the website.
| Argument | Type | Description |
|---|---|---|
| city | string | Work location, from the city line of get_campus_job_filters |
| sort | string | hot = most popular, recent = most recently found, published = most recently posted |
| company | string | Company name |
| keyword | string | Keyword in the job title or description, such as "backend" or "product manager" |
| jobFunction | string | Job function, one of the jobFunction values from get_campus_job_filters |
| employmentType | string | Employment type, one of the employmentType values from get_campus_job_filters |
{
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 32,
"description": "Work location, from the city line of get_campus_job_filters"
},
"sort": {
"enum": [
"hot",
"recent",
"published"
],
"type": "string",
"default": "hot",
"description": "hot = most popular, recent = most recently found, published = most recently posted"
},
"company": {
"type": "string",
"maxLength": 64,
"description": "Company name"
},
"keyword": {
"type": "string",
"maxLength": 64,
"description": "Keyword in the job title or description, such as \"backend\" or \"product manager\""
},
"jobFunction": {
"type": "string",
"maxLength": 32,
"description": "Job function, one of the jobFunction values from get_campus_job_filters"
},
"employmentType": {
"type": "string",
"maxLength": 16,
"description": "Employment type, one of the employmentType values from get_campus_job_filters"
}
},
"additionalProperties": false
}Choose the resume for one application; pass resumeId null to go back to the base resume. Replies with the resume as read back. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| resumeId* | any | Resume id, from list_resumes |
| applicationId* | string | Application id, from list_job_applications or the reply of an add-to-list tool |
{
"type": "object",
"required": [
"applicationId",
"resumeId"
],
"properties": {
"resumeId": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Resume id, from list_resumes"
},
{
"type": "null"
}
],
"description": "Resume id, from list_resumes"
},
"applicationId": {
"type": "string",
"minLength": 1,
"description": "Application id, from list_job_applications or the reply of an add-to-list tool"
}
},
"additionalProperties": false
}Pass one message to the apply AI on the user's computer, exactly as if the user typed it in the app's chat, e.g. "apply to everything on my list" or "pick 10 backend new-grad roles that match my resume". By default it goes to the persistent Skills conversation (opened on first use); pass taskId to send it to a specific conversation. If that conversation is running, the message does not interrupt it: it is handed over with the next step or queued until the turn ends. When the apply AI applies because of it, each application uses 1 Auto Apply credit once it is filled up to the submit step or submitted (once per application; nothing while unlimited is active). Replies with where the app put it (started / handed over with the next step / queued) and the conversation id; then use get_job_apply_client_status for progress and the AI's replies. Requires the AceRound Auto Apply desktop app on the user’s computer to be signed in and open (running in the background after closing the window also works); if the app is offline or outdated, the tool says so. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| text* | string | The message for the apply AI, written in the user's voice |
| taskId | string | Conversation id (taskId), from get_job_apply_client_status |
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "The message for the apply AI, written in the user's voice"
},
"taskId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Conversation id (taskId), from get_job_apply_client_status"
}
},
"additionalProperties": false
}Change settings of the live interview in progress: recognition language (only within the set chosen at the start; the page reconnects once), auto-answer (when off, answers only on "Answer now"), and one card per question (follow-ups on the same question share one card). Auto-answer and one-card-per-question are supported only by the desktop app overlay. Pass only what should change. Requires the user to have this session open in the browser or desktop app and connected; the page carries it out exactly as if the user clicked the matching button. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| lang | string | Recognition language |
| turnCards | boolean | One card per question |
| autoAnswer | boolean | Auto-answer |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"zh-CN",
"yue-CN",
"zh-HK",
"en-US",
"ja-JP",
"es-MX",
"pt-BR",
"de-DE",
"fr-FR",
"ko-KR",
"vi-VN",
"ru-RU",
"ar-SA"
],
"type": "string",
"description": "Recognition language"
},
"turnCards": {
"type": "boolean",
"description": "One card per question"
},
"autoAnswer": {
"type": "boolean",
"description": "Auto-answer"
}
},
"additionalProperties": false
}Turn AI assist (a suggested answer for each question) on or off in the mock interview in progress, same as the switch on the page. Requires the user to have this session open in the browser or desktop app and connected; the page carries it out exactly as if the user clicked the matching button. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| enabled* | boolean |
{
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
}
},
"additionalProperties": false
}Have the user's running page capture the user's screen now and solve the question, same as the "Solve from screenshot" button / hotkey; charged by the current mode and page count, with the answer shown on the user's page. The AI assistant does not (and cannot) supply the image. Runs in the desktop assessment overlay when the user is in an assessment (it must have started); otherwise in screenshot solving on the live / mock interview page (the web page must be sharing the screen). Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Start an assessment on the user's computer, exactly like clicking "Start assessment" on the assessment page of the desktop app: starts with the given answer mode and role, opens the assessment overlay and tucks away the main window. Requires the desktop app to be running and signed in on the user's computer; if it is offline, an older version, short on balance, or an interview or assessment is already in progress, the reason is returned and nothing starts. Starting is free; each screenshot solved afterwards deducts the user's minutes by the chosen mode. Once started, the user uses the overlay on the assessment page as usual; solve_screen_question can also capture and solve. The assessment record is created on the first solved screenshot and can then be seen with list_exams. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| mode | string | Answer mode: instant = Instant mode(2 minutes per screenshot); quick = Quick mode(2 minutes per screenshot); programming = Coding mode(5 minutes per question). Members are not charged minutes. Omit to keep the mode currently selected on the assessment page of the app |
| goalId | any | Role (target) ID to link, from list_interview_targets; null = no role. Use either this or jobName; omit both to keep the role currently filled in on the assessment page of the app |
| jobName | string | Name of a new role, when the user has not saved it yet; it is created on start (same as typing a role on the assessment page) |
| companyName | string |
Start a live or mock interview for the user and return the interview page link for the user to open in a browser (web only; it does not launch the desktop app; the user must be signed in to the same account in that browser). Live: the user shares the meeting tab with audio as prompted and, after clicking "Start interview", minutes are deducted by time online. Mock: one mock interview credit is deducted on creation. Only one session of each type can be in progress. Advanced settings not given (answer style, custom instructions, translation, answer recording, web search, knowledge bases) follow the user's saved interview preferences. Target IDs come from list_interview_targets, resume IDs from list_resumes. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| lang | string | Interview language (selects the speech recognition model); omit to use the user's preference |
| mode | string | Live only: online = video meeting (captures meeting audio), phone = phone interview (speakerphone picked up by the microphone; needs an enrolled voiceprint; Chinese / Cantonese / English only) |
| type | string | INTERVIEW = live interview, MOCK_INTERVIEW = mock interview |
| focus | string | Mock only: what this session should focus on |
| round | string | Live only: which round this is for the target |
Predict the questions most likely to come up for one of the user’s target roles, with answer outlines drawn from their resume. Generation takes about 30–90 seconds; the record is saved only when it succeeds. Uses 1 prediction credit on success (PRO is not charged; nothing is charged on failure). If it is still running when this call returns, check list_question_predictions a little later: a new record means it finished; no new record after a few minutes means it failed and nothing was charged. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| lang | string | Output language name, e.g. English, Simplified Chinese; defaults to the user interface language |
| count | integer | Number of questions |
| goalId* | string | Target role ID |
| resumeId | string | Resume ID from list_resumes; omit to base it on the role only |
| experience | string | Experience level: Entry-level / 1-3 years / 3-5 years / 5-10 years / 10+ years |
{
"type": "object",
"required": [
"goalId"
],
"properties": {
"lang": {
"type": "string",
"maxLength": 40,
"description": "Output language name, e.g. English, Simplified Chinese; defaults to the user interface language"
},
"count": {
"type": "integer",
"default": 7,
"maximum": 10,
"minimum": 4,
"description": "Number of questions"
},
"goalId": {
"type": "string",
"minLength": 1,
"description": "Target role ID"
},
"resumeId": {
"type": "string",
"description": "Resume ID from list_resumes; omit to base it on the role only"
},
"experience": {
"type": "string",
"maxLength": 40,
"description": "Experience level: Entry-level / 1-3 years / 3-5 years / 5-10 years / 10+ years"
}
},
"additionalProperties": false
}Stop what the apply AI is doing, the same as the user pressing Stop in the app: with taskId, only that conversation stops (in one-click apply that application also leaves this run); without it, the same as "Stop all" on the application list (running ones stop now, queued ones are not applied to) plus every other running conversation. Filled pages stay as they are; send_job_apply_instruction can have it continue later. Replies with the state read back after stopping. Requires the AceRound Auto Apply desktop app on the user’s computer to be signed in and open (running in the background after closing the window also works); if the app is offline or outdated, the tool says so. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| taskId | string | Conversation id (taskId), from get_job_apply_client_status |
{
"type": "object",
"properties": {
"taskId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Conversation id (taskId), from get_job_apply_client_status"
}
},
"additionalProperties": false
}Submit feedback to AceRound on the user's behalf (a bug, a suggestion, or anything else), optionally with screenshots. Follow replies with list_my_feedbacks / get_my_feedback. (Requires the user's sign-in with scope account:write.)
| Argument | Type | Description |
|---|---|---|
| type | string | BUG = something is broken, SUGGESTION = idea, OTHER = anything else |
| title | string | Title; defaults to the start of the message |
| message* | string | Feedback text |
| notifyEmail | string | Email to notify when there is a reply; omit for in-app notices only |
| screenshots | array | Screenshots, up to 6 |
{
"type": "object",
"required": [
"message"
],
"properties": {
"type": {
"enum": [
"BUG",
"SUGGESTION",
"OTHER"
],
"type": "string",
"default": "OTHER",
"description": "BUG = something is broken, SUGGESTION = idea, OTHER = anything else"
},
"title": {
"type": "string",
"maxLength": 60,
"minLength": 2,
"description": "Title; defaults to the start of the message"
},
"message": {
"type": "string",
"maxLength": 2000,
"minLength": 4,
"description": "Feedback text"
},
"notifyEmail": {
"type": "string",
"format": "email",
"maxLength": 200,
"description": "Email to notify when there is a reply; omit for in-app notices only"
},
"screenshots": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileName",
"contentBase64"
],
"properties": {
"fileName": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"contentBase64": {
"type": "string",
"minLength": 1,
"description": "Image file content as base64 (PNG / JPG / WEBP)"
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 6,
"description": "Screenshots, up to 6"
}
},
"additionalProperties": false
}Give the SMS code the user received to the apply AI, the same as typing it into the code box at the top of the app's main window: if the AI is still waiting, the code goes straight to that wait and the turn continues; if the wait has ended, it is sent to that conversation as a message. taskId can be omitted when only one application is waiting; pass it when several are (see get_job_apply_client_status). Says so if nothing is waiting for a code. Replies with the employer / role it went to. Requires the AceRound Auto Apply desktop app on the user’s computer to be signed in and open (running in the background after closing the window also works); if the app is offline or outdated, the tool says so. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| code* | string | The SMS code |
| taskId | string | Conversation id (taskId), from get_job_apply_client_status |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "The SMS code"
},
"taskId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Conversation id (taskId), from get_job_apply_client_status"
}
},
"additionalProperties": false
}Have AI pick the 2–4 official hotword libraries that best match a role name and description; returns library IDs and names. Nothing is saved; bind them with update_goal_hot_words. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| jobName* | string | Role name |
| jobDescription | string | Role description |
{
"type": "object",
"required": [
"jobName"
],
"properties": {
"jobName": {
"type": "string",
"maxLength": 100,
"description": "Role name"
},
"jobDescription": {
"type": "string",
"default": "",
"maxLength": 1000,
"description": "Role description"
}
},
"additionalProperties": false
}Disconnect Android SMS forwarding; the apply assistant can no longer read codes from that phone until it is paired or bound again. Replies with the status as read back. (Requires the user's sign-in with scope job_applications:write.)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Update the desktop client’s cloud settings (hotkeys, overlay style, modes, auto-answer, silence gate, disguise, theme…). Pass only what changes; overlayStyle, actionHotkeys and disguise are merged by key. Current values via get_settings. The client applies cloud settings on its next launch or sign-in; if the user changes any setting locally before that, the local copy wins. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| theme | string | Theme: system / light / dark |
| locale | any | UI language; null follows the system |
| uiScale | number | Main window UI scale |
| disguise | object | Custom process name and window title, merged by key |
| examMode | string | Exam mode: instant / quick / programming |
| turnCards | boolean | |
| autoAnswer | boolean | Answer automatically when the interviewer finishes; when off, only on “Answer now” |
| answerFirst | boolean | |
| audioSource | string | Interview type: SPEAKER online (system audio) / PHONE phone interview (microphone) |
Rename an assessment record, or change or clear the role it is linked to. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| title | string | |
| examId* | string | Assessment id from list_exams |
| goalId | any | The user's role (goal) id; null clears the link, omit to keep it |
{
"type": "object",
"required": [
"examId"
],
"properties": {
"title": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"examId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Assessment id from list_exams"
},
"goalId": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"minLength": 1
},
{
"type": "null"
}
],
"description": "The user's role (goal) id; null clears the link, omit to keep it"
}
},
"additionalProperties": false
}Update the screenshot-answer customization used in exams and interviews (synced; the desktop client picks it up on next launch). Pass only what changes. Current values via get_settings; save a full custom prompt with save_custom_prompt. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| codeMode | string | Code mode: auto / acm (full program with I/O) / core (only the required function) |
| codeQuality | string | Code style: standard / readable / concise / performance |
| quickPrompts | array | Quick prompts shown in the answer overlay (replaces the list, up to 8) |
| answerLanguage | any | Explanation language; auto follows the UI language in exams and the interview language in interviews |
| customRequirements | string | Extra requirements |
| programmingLanguage | string | Programming language, e.g. Python, Java, C++; auto follows the problem |
{
"type": "object",
"properties": {
"codeMode": {
"enum": [
"auto",
"acm",
"core"
],
"type": "string",
"description": "Code mode: auto / acm (full program with I/O) / core (only the required function)"
},
"codeQuality": {
"enum": [
"standard",
"readable",
"concise",
"performance"
],
"type": "string",
"description": "Code style: standard / readable / concise / performance"
},
"quickPrompts": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60
},
"maxItems": 8,
"description": "Quick prompts shown in the answer overlay (replaces the list, up to 8)"
},
"answerLanguage": {
"anyOf": [
{
"enum": [
"zh-CN",
"yue-CN",
"zh-HK",
"en-US",
"ja-JP",
"es-MX",
"pt-BR",
"de-DE",
"fr-FR",
"ko-KR",
"vi-VN",
"ru-RU",
"ar-SA"
],
"type": "string"
},
{
"type": "string",
"const": "auto"
}
],
"description": "Explanation language; auto follows the UI language in exams and the interview language in interviews"
},
"customRequirements": {
"type": "string",
"maxLength": 20000,
"description": "Extra requirements"
},
"programmingLanguage": {
"type": "string",
"maxLength": 80,
"description": "Programming language, e.g. Python, Java, C++; auto follows the problem"
}
},
"additionalProperties": false
}Change the email notified when a feedback item gets a reply; pass null to stop emails and keep in-app notices only. Ids come from list_my_feedbacks. (Requires the user's sign-in with scope account:write.)
| Argument | Type | Description |
|---|---|---|
| feedbackId* | string | |
| notifyEmail* | any |
{
"type": "object",
"required": [
"feedbackId",
"notifyEmail"
],
"properties": {
"feedbackId": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"notifyEmail": {
"anyOf": [
{
"type": "string",
"format": "email",
"maxLength": 200
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}Adjust a target role’s hotwords: hotWordIds replaces the bound libraries (up to 5; IDs from list_hot_word_libraries); customHotWords replaces the custom words, or use addCustomHotWords / removeCustomHotWords for individual words (up to 50). Anything omitted stays unchanged. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| goalId* | string | Target role ID |
| hotWordIds | array | |
| customHotWords | array | |
| addCustomHotWords | array | |
| removeCustomHotWords | array |
{
"type": "object",
"required": [
"goalId"
],
"properties": {
"goalId": {
"type": "string",
"minLength": 1,
"description": "Target role ID"
},
"hotWordIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5
},
"customHotWords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50
}
},
"addCustomHotWords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50
}
},
"removeCustomHotWords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50
}
}
},
"additionalProperties": false
}Edit a custom hotword library: rename it, replace the word list (words), or add / remove individual words (addWords / removeWords); anything omitted stays unchanged. The ID comes from list_my_hot_words. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| id* | string | Library ID |
| name | string | |
| words | array | |
| addWords | array | |
| removeWords | array |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Library ID"
},
"name": {
"type": "string",
"maxLength": 30,
"minLength": 1
},
"words": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50
}
},
"addWords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50
}
},
"removeWords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50
}
}
},
"additionalProperties": false
}Update interview preferences (synced across devices and used as defaults when starting an interview). Pass only what changes; everything else stays. Current values via get_settings; knowledge base IDs from list_knowledge_bases and list_official_knowledge_bases. Save a full custom prompt with save_custom_prompt. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| lang | string | Interview language |
| altLangs | array | Other languages the user can switch to during the interview; empty = single language |
| webSearch | boolean | Allow web search during live interviews |
| answerStyle | string | Answer style: keypoints / answerOnly / natural / structured |
| enableReplay | boolean | Interview replay (records the user’s answers; when off the microphone is never used) |
| customDataIds | array | Knowledge base IDs attached by default (replaces the list) |
| translateLang | any | Translation language; auto = automatic |
| dualLangAnswer | boolean | Answer in two languages |
Set the hiring progress of a submitted application. Values: NO_RESPONSE no reply / SCREENING_PASSED resume passed screening / WRITTEN_TEST assessment / INTERVIEW interview invited or in progress / OFFER offer / REJECTED rejected. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| progress* | string | |
| applicationId* | string | Application id, from list_job_applications or the reply of an add-to-list tool |
{
"type": "object",
"required": [
"applicationId",
"progress"
],
"properties": {
"progress": {
"enum": [
"NO_RESPONSE",
"SCREENING_PASSED",
"WRITTEN_TEST",
"INTERVIEW",
"OFFER",
"REJECTED"
],
"type": "string"
},
"applicationId": {
"type": "string",
"minLength": 1,
"description": "Application id, from list_job_applications or the reply of an add-to-list tool"
}
},
"additionalProperties": false
}Update standard fields in the user's Auto Apply profile: only the keys passed change; an empty string or array clears a field. Keys are listed by get_job_apply_profile. Replies with the values as read back. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| patch* | object | Fields to change: standard field key to a string or an array of strings (one item per entry for repeated sections) |
{
"type": "object",
"required": [
"patch"
],
"properties": {
"patch": {
"type": "object",
"description": "Fields to change: standard field key to a string or an array of strings (one item per entry for repeated sections)",
"propertyNames": {
"enum": [
"name",
"namePinyin",
"gender",
"birthDate",
"ethnicity",
"politicalStatus",
"maritalStatus",
"nationality",
"idType",
"idNumber",
"age",
"height",
"weight",
"healthStatus",
"birthPlace",
"hukouType",
"englishName",
"mobile",
"email",
"currentCity",
"homeAddress",
"hukouLocation",
"emergencyContactName",
"emergencyContactRelation",
"emergencyContactPhone",
"wechat",
"currentAddress",
"familyMemberRelation",
"familyMemberName",
"familyMemberEmployer",
"familyMemberTitle",
"school",
"major",
"degree",
"educationRange",
"graduationYear",
"educationType",
"schoolCity",
"college",
"advisor",
"lab",
"researchDirection",
"academicRanking",
"gpa",
"academicDegree",
"studentOrigin",
"workCompany",
"workTitle",
"workRange",
"workExperience",
"projectExperience",
"honors",
"campusExperience",
"papers",
"patents",
"overseasExperience",
"rewardsAndPunishments",
"languages",
"skills",
"certificates",
"englishLevel",
"englishScore",
"hobbies",
"intendedCities",
"intendedPositions",
"acceptRelocation",
"expectedOnboardDate",
"expectedSalary",
"personalWebsite",
"githubUrl",
"portfolioUrl",
"resumeFile",
"studentIdFile",
"transcriptFile",
"photoFile"
]
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
}
},
"additionalProperties": false
}Update the user's job preferences: each dimension passed replaces the old value (pass the full new array to append); others stay. Replies with the preferences as read back. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| patch* | object | |
| markInterviewed | boolean |
{
"type": "object",
"required": [
"patch"
],
"properties": {
"patch": {
"type": "object",
"properties": {
"notes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"cities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"batches": {
"type": "array",
"items": {
"type": "string",
"maxLength": 30,
"minLength": 1
},
"default": [],
"maxItems": 10
},
"directions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"companyScales": {
"type": "array",
"items": {
"enum": [
"bigtech",
"midsize",
"startup",
"stateOwned",
"foreign"
],
"type": "string"
},
"default": [],
"maxItems": 5
},
"employmentKinds": {
"type": "array",
"items": {
"enum": [
"campus",
"intern",
"experienced"
],
"type": "string"
},
"default": [],
"maxItems": 3
},
"targetCompanies": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"default": [],
"maxItems": 50
},
"excludedCompanies": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"default": [],
"maxItems": 50
}
},
"additionalProperties": false
},
"markInterviewed": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}Rename an interview knowledge base or replace its text; fields you omit stay unchanged. Passing content replaces the whole text. The ID comes from list_knowledge_bases. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| id* | string | Knowledge base ID |
| name | string | |
| content | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Knowledge base ID"
},
"name": {
"type": "string",
"maxLength": 50,
"minLength": 1
},
"content": {
"type": "string",
"maxLength": 90000
}
},
"additionalProperties": false
}Edit one Q&A entry; fields you omit stay unchanged. Entry IDs come from get_knowledge_base. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| answer | string | |
| entryId* | string | Entry ID |
| question | string | |
| materialId* | string | Knowledge base ID |
{
"type": "object",
"required": [
"materialId",
"entryId"
],
"properties": {
"answer": {
"type": "string",
"maxLength": 8000,
"minLength": 1
},
"entryId": {
"type": "string",
"minLength": 1,
"description": "Entry ID"
},
"question": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"materialId": {
"type": "string",
"minLength": 1,
"description": "Knowledge base ID"
}
},
"additionalProperties": false
}Upload an Auto Apply attachment (resume file, student ID, transcript, ID photo) and save it to that field of the user's profile, replacing the old file. File content is passed as base64; PDF and JPG / PNG / WebP up to 8 MB. Replies with the profile field as read back. (Requires the user's sign-in with scope job_applications:write.)
| Argument | Type | Description |
|---|---|---|
| field* | string | resumeFile / studentIdFile / transcriptFile / photoFile |
| fileName* | string | File name with extension |
| fileBase64* | string | File content, base64 |
{
"type": "object",
"required": [
"field",
"fileName",
"fileBase64"
],
"properties": {
"field": {
"enum": [
"resumeFile",
"studentIdFile",
"transcriptFile",
"photoFile"
],
"type": "string",
"description": "resumeFile / studentIdFile / transcriptFile / photoFile"
},
"fileName": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "File name with extension"
},
"fileBase64": {
"type": "string",
"minLength": 1,
"description": "File content, base64"
}
},
"additionalProperties": false
}Create an interview knowledge base from a file: its text becomes the knowledge base text; returns the new ID and text length. Pass the file content as base64. Supported: .pdf .doc .docx .txt .md .jpg .jpeg .png .webp, up to 10MB. (Requires the user's sign-in with scope interviews:write.)
| Argument | Type | Description |
|---|---|---|
| fileName* | string | File name with extension |
| fileBase64* | string | File content as base64 |
{
"type": "object",
"required": [
"fileName",
"fileBase64"
],
"properties": {
"fileName": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "File name with extension"
},
"fileBase64": {
"type": "string",
"minLength": 1,
"description": "File content as base64"
}
},
"additionalProperties": false
}Upload a resume file (PDF / JPG / PNG / WEBP). The server reads its text and saves it as a new resume for interviews and Auto Apply. The file content is passed as base64. Returns the new resume id; read it back with get_resume. (Requires the user's sign-in with scope resumes:write.)
| Argument | Type | Description |
|---|---|---|
| title | string | Resume title; defaults to the file name |
| fileName* | string | File name, such as "resume.pdf" |
| fileBase64* | string | File content as base64 |
{
"type": "object",
"required": [
"fileName",
"fileBase64"
],
"properties": {
"title": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Resume title; defaults to the file name"
},
"fileName": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "File name, such as \"resume.pdf\""
},
"fileBase64": {
"type": "string",
"minLength": 1,
"description": "File content as base64"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.
| examPresetSlug | string |
{
"type": "object",
"required": [
"scene"
],
"properties": {
"lang": {
"enum": [
"zh-CN",
"yue-CN",
"zh-HK",
"en-US",
"ja-JP",
"es-MX",
"pt-BR",
"de-DE",
"fr-FR",
"ko-KR",
"vi-VN",
"ru-RU",
"ar-SA"
],
"type": "string",
"default": "zh-CN"
},
"mode": {
"enum": [
"quick",
"programming"
],
"type": "string",
"default": "quick"
},
"scene": {
"enum": [
"interview",
"exam"
],
"type": "string"
},
"goalId": {
"type": "string"
},
"prompt": {
"type": "string",
"default": "",
"maxLength": 20000
},
"question": {
"type": "string",
"maxLength": 2000
},
"resumeId": {
"type": "string"
},
"materialIds": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 20
},
"screenshots": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 6
},
"examPresetSlug": {
"type": "string"
}
},
"additionalProperties": false
}| Company of the new role, given with jobName |
{
"type": "object",
"properties": {
"mode": {
"enum": [
"instant",
"quick",
"programming"
],
"type": "string",
"description": "Answer mode: instant = Instant mode(2 minutes per screenshot); quick = Quick mode(2 minutes per screenshot); programming = Coding mode(5 minutes per question). Members are not charged minutes. Omit to keep the mode currently selected on the assessment page of the app"
},
"goalId": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"minLength": 1
},
{
"type": "null"
}
],
"description": "Role (target) ID to link, from list_interview_targets; null = no role. Use either this or jobName; omit both to keep the role currently filled in on the assessment page of the app"
},
"jobName": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Name of a new role, when the user has not saved it yet; it is created on start (same as typing a role on the assessment page)"
},
"companyName": {
"type": "string",
"maxLength": 100,
"description": "Company of the new role, given with jobName"
}
},
"additionalProperties": false
}| resumeId* | string | Resume ID |
| targetId* | string | Target ID |
| skipIntro | boolean | Mock only: skip the self-introduction |
| assistMode | boolean | Mock only: turn on AI assist (a suggested answer for each question) |
| difficulty | string | Mock only: seniority level |
| extraLangs | array | Live only: other languages the user may switch to during the interview; omit to use the user's preference |
| basicsRatio | integer | Mock only: share of fundamentals questions, 0–100; omit to let the AI decide |
| questionCount | integer | Mock only: number of questions; omit to let the AI decide |
| knowledgeBaseIds | array | Knowledge base IDs; for live interviews omit to use the user's preference; for mock interviews they apply only with AI assist on |
{
"type": "object",
"required": [
"targetId",
"resumeId"
],
"properties": {
"lang": {
"enum": [
"zh-CN",
"yue-CN",
"zh-HK",
"en-US",
"ja-JP",
"es-MX",
"pt-BR",
"de-DE",
"fr-FR",
"ko-KR",
"vi-VN",
"ru-RU",
"ar-SA"
],
"type": "string",
"description": "Interview language (selects the speech recognition model); omit to use the user's preference"
},
"mode": {
"enum": [
"online",
"phone"
],
"type": "string",
"default": "online",
"description": "Live only: online = video meeting (captures meeting audio), phone = phone interview (speakerphone picked up by the microphone; needs an enrolled voiceprint; Chinese / Cantonese / English only)"
},
"type": {
"enum": [
"INTERVIEW",
"MOCK_INTERVIEW"
],
"type": "string",
"default": "INTERVIEW",
"description": "INTERVIEW = live interview, MOCK_INTERVIEW = mock interview"
},
"focus": {
"type": "string",
"maxLength": 500,
"description": "Mock only: what this session should focus on"
},
"round": {
"enum": [
"FIRST",
"SECOND",
"THIRD",
"HR",
"OTHER"
],
"type": "string",
"description": "Live only: which round this is for the target"
},
"resumeId": {
"type": "string",
"minLength": 1,
"description": "Resume ID"
},
"targetId": {
"type": "string",
"minLength": 1,
"description": "Target ID"
},
"skipIntro": {
"type": "boolean",
"description": "Mock only: skip the self-introduction"
},
"assistMode": {
"type": "boolean",
"default": false,
"description": "Mock only: turn on AI assist (a suggested answer for each question)"
},
"difficulty": {
"enum": [
"FRESH_GRADUATE",
"1_3_YEARS",
"3_5_YEARS",
"5_10_YEARS",
"10_YEARS"
],
"type": "string",
"default": "FRESH_GRADUATE",
"description": "Mock only: seniority level"
},
"extraLangs": {
"type": "array",
"items": {
"$ref": "#/properties/lang"
},
"maxItems": 3,
"description": "Live only: other languages the user may switch to during the interview; omit to use the user's preference"
},
"basicsRatio": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "Mock only: share of fundamentals questions, 0–100; omit to let the AI decide"
},
"questionCount": {
"type": "integer",
"maximum": 24,
"minimum": 6,
"description": "Mock only: number of questions; omit to let the AI decide"
},
"knowledgeBaseIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Knowledge base IDs; for live interviews omit to use the user's preference; for mock interviews they apply only with AI assist on"
}
},
"additionalProperties": false
}| newestFirst | boolean |
| panicHotkey | any | Panic hide hotkey |
| hotkeyScheme | string | Default hotkey scheme for actions not set individually: simple / conflict-free |
| overlayStyle | object | Overlay style, merged by key: theme, interviewBgOpacity / examBgOpacity (0–1), interviewTextOpacity / examTextOpacity (0–1), interviewBorderOpacity / examBorderOpacity, fontScale (0.3–4), textBold, textHalo, scrollSpeed (0.05–5), hotkeyOpacityStep, examSolveHoverMs, interviewWidth / interviewHeight / examWidth / examHeight (pixels) |
| actionHotkeys | object | Overlay action hotkeys, merged by key; values are Tauri accelerators such as CommandOrControl+Shift+Enter. Actions: answer capture voice-ask scroll-up scroll-down move-left move-right move-up move-down copy-code size-up size-down opacity-up opacity-down text-opacity-up text-opacity-down auto-palette restore-palette |
| nativeExamOsd | boolean |
| silenceGateMs | number | How long the interviewer must pause before the question counts as finished (ms, 300–6000) |
| examDualCamera | boolean |
| followNewRound | boolean |
| solverExamMode | string | Mode for screenshot answers during interviews: instant / quick / programming |
| followStreaming | boolean |
| hideFromTaskbar | boolean |
| showHotkeyHints | boolean |
| autoOpenMockShell | boolean |
| showExamReasoning | boolean |
| showCopyCodeButton | boolean |
| interviewDualCamera | boolean |
| overlayStylePresets | array |
{
"type": "object",
"properties": {
"theme": {
"type": "string",
"maxLength": 20,
"description": "Theme: system / light / dark"
},
"locale": {
"anyOf": [
{
"type": "string",
"maxLength": 20
},
{
"type": "null"
}
],
"description": "UI language; null follows the system"
},
"uiScale": {
"type": "number",
"description": "Main window UI scale"
},
"disguise": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
},
"processName": {
"type": "string",
"maxLength": 80
},
"windowTitle": {
"type": "string",
"maxLength": 120
}
},
"description": "Custom process name and window title, merged by key",
"additionalProperties": false
},
"examMode": {
"type": "string",
"maxLength": 40,
"description": "Exam mode: instant / quick / programming"
},
"turnCards": {
"type": "boolean"
},
"autoAnswer": {
"type": "boolean",
"description": "Answer automatically when the interviewer finishes; when off, only on “Answer now”"
},
"answerFirst": {
"type": "boolean"
},
"audioSource": {
"type": "string",
"maxLength": 20,
"description": "Interview type: SPEAKER online (system audio) / PHONE phone interview (microphone)"
},
"newestFirst": {
"type": "boolean"
},
"panicHotkey": {
"$ref": "#/properties/actionHotkeys/additionalProperties",
"description": "Panic hide hotkey"
},
"hotkeyScheme": {
"type": "string",
"maxLength": 20,
"description": "Default hotkey scheme for actions not set individually: simple / conflict-free"
},
"overlayStyle": {
"type": "object",
"description": "Overlay style, merged by key: theme, interviewBgOpacity / examBgOpacity (0–1), interviewTextOpacity / examTextOpacity (0–1), interviewBorderOpacity / examBorderOpacity, fontScale (0.3–4), textBold, textHalo, scrollSpeed (0.05–5), hotkeyOpacityStep, examSolveHoverMs, interviewWidth / interviewHeight / examWidth / examHeight (pixels)",
"propertyNames": {
"maxLength": 40
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"actionHotkeys": {
"type": "object",
"description": "Overlay action hotkeys, merged by key; values are Tauri accelerators such as CommandOrControl+Shift+Enter. Actions: answer capture voice-ask scroll-up scroll-down move-left move-right move-up move-down copy-code size-up size-down opacity-up opacity-down text-opacity-up text-opacity-down auto-palette restore-palette",
"propertyNames": {
"maxLength": 40
},
"additionalProperties": {
"type": "string",
"maxLength": 80
}
},
"nativeExamOsd": {
"type": "boolean"
},
"silenceGateMs": {
"type": "number",
"description": "How long the interviewer must pause before the question counts as finished (ms, 300–6000)"
},
"examDualCamera": {
"type": "boolean"
},
"followNewRound": {
"type": "boolean"
},
"solverExamMode": {
"type": "string",
"maxLength": 40,
"description": "Mode for screenshot answers during interviews: instant / quick / programming"
},
"followStreaming": {
"type": "boolean"
},
"hideFromTaskbar": {
"type": "boolean"
},
"showHotkeyHints": {
"type": "boolean"
},
"autoOpenMockShell": {
"type": "boolean"
},
"showExamReasoning": {
"type": "boolean"
},
"showCopyCodeButton": {
"type": "boolean"
},
"interviewDualCamera": {
"type": "boolean"
},
"overlayStylePresets": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"style"
],
"properties": {
"id": {
"type": "string",
"maxLength": 40
},
"name": {
"type": "string",
"maxLength": 40
},
"style": {
"$ref": "#/properties/overlayStyle"
}
},
"additionalProperties": false
},
"maxItems": 30
}
},
"additionalProperties": false
}| customAnswerStyle |
| string |
| Extra answer requirements |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"zh-CN",
"yue-CN",
"zh-HK",
"en-US",
"ja-JP",
"es-MX",
"pt-BR",
"de-DE",
"fr-FR",
"ko-KR",
"vi-VN",
"ru-RU",
"ar-SA"
],
"type": "string",
"description": "Interview language"
},
"altLangs": {
"type": "array",
"items": {
"$ref": "#/properties/lang"
},
"description": "Other languages the user can switch to during the interview; empty = single language"
},
"webSearch": {
"type": "boolean",
"description": "Allow web search during live interviews"
},
"answerStyle": {
"enum": [
"keypoints",
"answerOnly",
"natural",
"structured"
],
"type": "string",
"description": "Answer style: keypoints / answerOnly / natural / structured"
},
"enableReplay": {
"type": "boolean",
"description": "Interview replay (records the user’s answers; when off the microphone is never used)"
},
"customDataIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Knowledge base IDs attached by default (replaces the list)"
},
"translateLang": {
"anyOf": [
{
"$ref": "#/properties/lang"
},
{
"type": "string",
"const": "auto"
}
],
"description": "Translation language; auto = automatic"
},
"dualLangAnswer": {
"type": "boolean",
"description": "Answer in two languages"
},
"customAnswerStyle": {
"type": "string",
"maxLength": 20000,
"description": "Extra answer requirements"
}
},
"additionalProperties": false
}