| Step | Endpoint | MCP tool |
|---|---|---|
| List results | GET /merchant-result-list | list_interview_results |
| Read transcript + scores | POST /job-interview-details | get_interview_result_details |
| Export PDF / HTML / JSON | POST /job-interview-pdf | generate_interview_report |
1. Find the result
List your merchant’s results, newest first. Everything is a query parameter — no request body.interview_id (one interview), tab (completed, shortlist, undecided, decided-selected, decided-rejected, …), step (pre-screening or interview), order_by (score, created_at_newest, …), filter_text, plus limit/offset.
The response has data[] and pagination. Each row includes interview_result_id, candidate_name, candidate_email, status, decision_status, and score. Grab the interview_result_id for the next step.
2. Read the transcript and assessment
score, score_sentiment, score_words_per_minute, …), AI write-ups (ai_analysis, ai_analysis_recruiter, ai_analysis_recruiter_why_hire / …_why_not_hire), any recruiter_risks, and the full transcript array. Each transcript item has question_asked, answer, per-answer ai_analysis, and a score.
3. Export a report
Generate a shareable report as a PDF (signed URL), raw HTML, or structured JSON. Pass a singleinterview_result_id or an array interview_result_ids for a combined report.
export_type:
pdf→pdf_export_url+pdf_export_valid_until(setstore_file: true).html→html_export(a full HTML document string).json→json_export(structured object).
Report content toggles (export_features_result)
Set
export_features_result.mojito_language_code to translate the report into another language (0.1 credit per result when it differs from the result’s own language).